AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Move gtk-reference files into GTK+ tree proper.

Browse Source 
Thu Sep  7 14:15:03 2000  Owen Taylor  <otaylor@redhat.com>

        * gdk/* gtk/*: Move gtk-reference files into GTK+ tree proper.

	* Update sections.txt files to correspond to current code,
	tweak .sgml files and Makefiles to correspond.

	* gtk/tmpl/gtkradiomenuitem.sgml (this): Remove extra <para>
This commit is contained in:
Owen Taylor 2000-09-07 18:17:06 +00:00 committed by Owen Taylor
parent 21b538970e
commit 71337db92e
117 changed files with 14173 additions and 7375 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
ChangeLog
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

37
ChangeLog.pre-2-0
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

37
ChangeLog.pre-2-10
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

37
ChangeLog.pre-2-2
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

37
ChangeLog.pre-2-4
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

37
ChangeLog.pre-2-6
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

37
ChangeLog.pre-2-8
View File

@ -1,3 +1,36 @@
Thu Sep 7 11:47:02 2000 Owen Taylor <otaylor@redhat.com>
* gtk/gtktextbuffer.c gtk/gtkimcontext.c gtk/gtkwidget.c:
Doc comment fixing. (Mostly non-matching parameter names.)
* gtk/gtkcalendar.c gtk/gtklist.c gtk/gtknotebook.c: Modify
comments a little to avoid looking like a doc comment.
* gtk/gtkspinbutton.h (GTK_INPUT_ERROR): Change INPUT_ERROR to
GTK_INPUT_ERROR. (Should the mechanism for erros in spin button
conversions be changed to GError?)
* gtk/gtkcolorsel.c (GTK_CUSTOM_PALETTE_WIDTH/HEIGHT):
Move private #defines into .c file.
* gtk/gtktexttag.c (gtk_text_tag_class_init): Alphabetize
order of argument addition, remove duplicates.
* gtk/gtkaspectframe.h (struct _GtkAspectFrameClass):
parent class is FrameClass, not BinClass.
* gtk/gtk.h: Add gtkinvisible, which was missing.
(It's occasionalyl useful for client apps, if seldom.)
* gdk/gdktypes.h: Remove obsolete GDK_CORE_POINTER
#define.
Wed Sep 6 09:53:15 2000 Owen Taylor <otaylor@redhat.com>
* gdk/x11/gdkwindow-x11.c (gdk_window_new): Use X-space
coordinates when creating window, instead of GDK-space
coordinates. (Avoid BadValue on too large windows.)
2000-09-05 Sebastian Wilhelmi <wilhelmi@ira.uka.de>
* configure.in (use_mmx_asm): Remove conftest* after use along the
@ -16,7 +49,9 @@
instead of g_basename.
2000-09-04 Elliot Lee <sopwith@redhat.com>
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid ANSI warning.
* gdk/gdkpixbuf.h: Put text after #endif inside a comment to avoid
ANSI warning.
Sun Sep 03 00:47:08 2000 George Lebl <jirka@5z.com>

12
configure.in
View File

@ -870,6 +870,16 @@ AM_CONDITIONAL(USE_MMX, test x$use_mmx_asm = xyes)
# Checks for gtk-doc and docbook-tools
##################################################
AC_ARG_WITH(html-dir, [ --with-html-dir=PATH path to installed docs ])
if test "x$with_html_dir" = "x" ; then
HTML_DIR='${datadir}/gtk-doc/html'
else
HTML_DIR=$with_html_dir
fi
AC_SUBST(HTML_DIR)
AC_CHECK_PROG(GTKDOC, gtkdoc-mkdb, true, false)
AM_CONDITIONAL(HAVE_GTK_DOC, $GTKDOC)
AC_SUBST(HAVE_GTK_DOC)
@ -1002,6 +1012,8 @@ demos/Makefile
docs/Makefile
docs/reference/Makefile
docs/reference/gdk-pixbuf/Makefile
docs/reference/gdk/Makefile
docs/reference/gtk/Makefile
docs/faq/Makefile
docs/tutorial/Makefile
gdk-pixbuf/Makefile

2
docs/Changes-2.0.txt
View File

@ -147,7 +147,7 @@ Incompatible Changes from GTK+-1.2 to GTK+-1.4:
- The visual for a widget, and also the default visual is now derived
from the colormap for the widget and the default colormap.
gtk_widget_set_visual(), gtk_widget_set_defualt_visual(), gtk_widget_push_visual()
gtk_widget_set_visual(), gtk_widget_set_default_visual(), gtk_widget_push_visual()
and gtk_widget_pop_visual() now do nothing. Since the visual always
had to match that of the colormap, it is safe to simply delete
all references to these functions.

9
docs/reference/ChangeLog
View File

@ -1,3 +1,12 @@
Thu Sep 7 14:15:03 2000 Owen Taylor <otaylor@redhat.com>
* gdk/* gtk/*: Move gtk-reference files into GTK+ tree proper.
* Update sections.txt files to correspond to current code,
tweak .sgml files and Makefiles to correspond.
* gtk/tmpl/gtkradiomenuitem.sgml (this): Remove extra <para>
2000-06-14 Damon Chaplin <damon@helixcode.com>
* gtk/tmpl/gtktooltips.sgml: added a note about no-window widgets.

2
docs/reference/Makefile.am
View File

@ -1,3 +1,3 @@
## Process this file with automake to produce Makefile.in
SUBDIRS = gdk-pixbuf
SUBDIRS = gdk-pixbuf gdk gtk

3
docs/reference/gdk-pixbuf/.cvsignore
View File

@ -2,4 +2,5 @@ Makefile
Makefile.in
html
sgml
gdk-pixbuf.html
gdk-pixbuf-decl-list.txt
gdk-pixbuf-unused.txt

83
docs/reference/gdk-pixbuf/Makefile.am
View File

@ -9,63 +9,71 @@ DOC_MAIN_SGML_FILE=gdk-pixbuf.sgml
# The directory containing the source code (if it contains documentation).
DOC_SOURCE_DIR=$(GDK_PIXBUF_DIR)/gdk-pixbuf
CFLAGS=`gnome-config --cflags gnomeui gdk_pixbuf gnomecanvaspixbuf`
LDFLAGS=`gnome-config --libs gnomeui gdk_pixbuf gnomecanvaspixbuf`
# Extra options to supply to gtkdoc-fixref
FIXXREF_OPTIONS=
HTML_DIR=$(datadir)/gnome/html
# Header files to ignore when scanning
IGNORE_HFILES=pixops.h pixops-internal.h
TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
# Extra files to add when scanning
EXTRA_HFILES= \
$(top_srcdir)/gtk/gdk-pixbuf-loader.h
# CFLAGS and LDFLAGS for compiling scan program
CFLAGS=
LDFLAGS=
tmpl_sources = \
tmpl/animation.sgml \
tmpl/creating.sgml \
tmpl/file-loading.sgml \
tmpl/from-drawables.sgml \
tmpl/gdk-pixbuf-loader.sgml \
tmpl/gdk-pixbuf-unused.sgml \
tmpl/gdk-pixbuf.sgml \
tmpl/gnome-canvas-pixbuf.sgml \
tmpl/initialization_versions.sgml \
tmpl/module_interface.sgml \
tmpl/refcounting.sgml \
tmpl/rendering.sgml \
tmpl/scaling.sgml \
tmpl/util.sgml
gdk_pixbuf_docdir = $(HTML_DIR)
gdk_pixbuf_doc_DATA = \
gdk-pixbuf.html \
gdk-pixbuf.hierarchy \
gdk-pixbuf.types \
gdk-pixbuf-decl.txt \
gdk-pixbuf-sections.txt
# Extra SGML files that are included by DOC_MAIN_SGML_FILE
content_files = \
compiling.sgml \
gdk-pixbuf.sgml
####################################
# Everything below here is generic #
####################################
TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
EXTRA_DIST = \
$(gdk_pixbuf_doc_DATA) \
$(content_files)
$(DOC_MAIN_SGML_FILE) \
$(content_files) \
$(DOC_MODULE)-sections.txt \
$(DOC_MODULE)-overrides.txt
if ENABLE_GTK_DOC
gdk-pixbuf.html: html/book1.html
-cd $(srcdir) && cp html/book1.html gdk-pixbuf.html
else
gdk-pixbuf.html:
endif
all-local: html/index.html
html/book1.html: sgml/gdk-pixbuf-doc.bottom $(content_files)
$(MAKE) html
$(DOC_MODULE)-decl.txt:
$(MAKE) scan
sgml/gdk-pixbuf-doc.bottom: $(tmpl_sources)
$(tmpl_sources): $(DOC_MODULE)-decl.txt $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt
$(MAKE) templates
sgml/$(DOC_MODULE)-doc.bottom: $(tmpl_sources) $(DOC_MODULE)-decl.txt
$(MAKE) sgml
html/index.html: sgml/$(DOC_MODULE)-doc.bottom $(DOC_MAIN_SGML_FILE) $(content_fiels)
$(MAKE) html
endif
scan:
-(cd $(srcdir) \
&& env CFLAGS=$(CFLAGS) LDFLAGS=$(LDFLAGS) \
gtkdoc-scanobj --module=$(DOC_MODULE) \
&& gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="pixops.h pixops-internal.h" )
&& gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(EXTRA_HFILES))
templates: scan
templates:
cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE)
sgml:
@ -75,6 +83,8 @@ sgml:
html:
test -d $(srcdir)/html || mkdir $(srcdir)/html
-cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
@echo '-- Fixing Crossreferences'
gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
clean-local:
rm -f *~ *.bak *.signals *-unused.txt
@ -94,11 +104,20 @@ install-data-local:
done; \
echo '-- Installing $(srcdir)/html/index.sgml' ; \
$(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \
echo '-- Fixing Crossreferences' ; \
gtkdoc-fixxref --module=$(DOC_MODULE) --html-dir=$(HTML_DIR)|| true; \
fi)
dist-hook:
#
# Require gtk-doc when making dist
#
if ENABLE_GTK_DOC
dist-check-gtkdoc:
else
dist-check-gtkdoc:
@echo "*** gtk-doc must be installed and enabled in order to make dist
@false
endif
dist-hook: dist-check-gtkdoc
mkdir $(distdir)/html
mkdir $(distdir)/sgml
mkdir $(distdir)/tmpl

527
docs/reference/gdk-pixbuf/gdk-pixbuf-decl.txt
View File

@ -1,527 +0,0 @@
<USER_FUNCTION>
<NAME>ModulePreparedNotifyFunc</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf, gpointer user_data
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>ModuleUpdatedNotifyFunc</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf,
guint x, guint y,
guint width, guint height,
gpointer user_data
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>ModuleFrameDoneNotifyFunc</NAME>
<RETURNS>void </RETURNS>
GdkPixbufFrame *frame,
gpointer user_data
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>ModuleAnimationDoneNotifyFunc</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf,
gpointer user_data
</USER_FUNCTION>
<STRUCT>
<NAME>GdkPixbufModule</NAME>
</STRUCT>
<STRUCT>
<NAME>GdkPixbufModule</NAME>
struct GdkPixbufModule {
char *module_name;
gboolean (* format_check) (guchar *buffer, int size);
GModule *module;
GdkPixbuf *(* load) (FILE *f);
GdkPixbuf *(* load_xpm_data) (const char **data);
/* Incremental loading */
gpointer (* begin_load) (ModulePreparedNotifyFunc prepare_func,
ModuleUpdatedNotifyFunc update_func,
ModuleFrameDoneNotifyFunc frame_done_func,
ModuleAnimationDoneNotifyFunc anim_done_func,
gpointer user_data);
void (* stop_load) (gpointer context);
gboolean (* load_increment) (gpointer context, const guchar *buf, guint size);
/* Animation loading */
GdkPixbufAnimation *(* load_animation) (FILE *f);
};
</STRUCT>
<FUNCTION>
<NAME>gdk_pixbuf_get_module</NAME>
<RETURNS>GdkPixbufModule *</RETURNS>
guchar *buffer, guint size
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_load_module</NAME>
<RETURNS>void </RETURNS>
GdkPixbufModule *image_module
</FUNCTION>
<MACRO>
<NAME>GDK_TYPE_PIXBUF_LOADER</NAME>
#define GDK_TYPE_PIXBUF_LOADER (gdk_pixbuf_loader_get_type ())
</MACRO>
<MACRO>
<NAME>GDK_PIXBUF_LOADER</NAME>
#define GDK_PIXBUF_LOADER(obj) (GTK_CHECK_CAST ((obj), GDK_TYPE_PIXBUF_LOADER, GdkPixbufLoader))
</MACRO>
<MACRO>
<NAME>GDK_PIXBUF_LOADER_CLASS</NAME>
#define GDK_PIXBUF_LOADER_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GDK_TYPE_PIXBUF_LOADER, GdkPixbufLoaderClass))
</MACRO>
<MACRO>
<NAME>GDK_IS_PIXBUF_LOADER</NAME>
#define GDK_IS_PIXBUF_LOADER(obj) (GTK_CHECK_TYPE ((obj), GDK_TYPE_PIXBUF_LOADER))
</MACRO>
<MACRO>
<NAME>GDK_IS_PIXBUF_LOADER_CLASS</NAME>
#define GDK_IS_PIXBUF_LOADER_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GDK_TYPE_PIXBUF_LOADER))
</MACRO>
<STRUCT>
<NAME>GdkPixbufLoader</NAME>
</STRUCT>
<STRUCT>
<NAME>GdkPixbufLoader</NAME>
struct GdkPixbufLoader
{
GtkObject object;
/* < Private > */
gpointer private;
};
</STRUCT>
<STRUCT>
<NAME>GdkPixbufLoaderClass</NAME>
</STRUCT>
<FUNCTION>
<NAME>gdk_pixbuf_loader_get_type</NAME>
<RETURNS>GtkType </RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_loader_new</NAME>
<RETURNS>GdkPixbufLoader *</RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_loader_write</NAME>
<RETURNS>gboolean </RETURNS>
GdkPixbufLoader *loader,const guchar *buf,size_t count
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_loader_get_pixbuf</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
GdkPixbufLoader *loader
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_loader_get_animation</NAME>
<RETURNS>GdkPixbufAnimation *</RETURNS>
GdkPixbufLoader *loader
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_loader_close</NAME>
<RETURNS>void </RETURNS>
GdkPixbufLoader *loader
</FUNCTION>
<ENUM>
<NAME>GdkColorspace</NAME>
typedef enum {
GDK_COLORSPACE_RGB
} GdkColorspace;
</ENUM>
<STRUCT>
<NAME>GdkPixbuf</NAME>
</STRUCT>
<STRUCT>
<NAME>GdkPixbufFrame</NAME>
</STRUCT>
<STRUCT>
<NAME>GdkPixbufAnimation</NAME>
</STRUCT>
<USER_FUNCTION>
<NAME>GdkPixbufDestroyNotify</NAME>
<RETURNS>void </RETURNS>
guchar *pixels, gpointer data
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>GdkPixbufLastUnref</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf, gpointer data
</USER_FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_ref</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_unref</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_set_last_unref_handler</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf,GdkPixbufLastUnref last_unref_fn,gpointer last_unref_fn_data
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_finalize</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_colorspace</NAME>
<RETURNS>GdkColorspace </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_n_channels</NAME>
<RETURNS>int </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_has_alpha</NAME>
<RETURNS>gboolean </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_bits_per_sample</NAME>
<RETURNS>int </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_pixels</NAME>
<RETURNS>guchar *</RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_width</NAME>
<RETURNS>int </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_height</NAME>
<RETURNS>int </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_rowstride</NAME>
<RETURNS>int </RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_new</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
GdkColorspace colorspace, gboolean has_alpha, int bits_per_sample,int width, int height
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_copy</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const GdkPixbuf *pixbuf
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_new_from_file</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const char *filename
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_new_from_data</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const guchar *data,GdkColorspace colorspace,gboolean has_alpha,int bits_per_sample,int width, int height,int rowstride,GdkPixbufDestroyNotify destroy_fn,gpointer destroy_fn_data
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_new_from_xpm_data</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const char **data
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_add_alpha</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const GdkPixbuf *pixbuf, gboolean substitute_color,guchar r, guchar g, guchar b
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_copy_area</NAME>
<RETURNS>void </RETURNS>
const GdkPixbuf *src_pixbuf,int src_x, int src_y,int width, int height,GdkPixbuf *dest_pixbuf,int dest_x, int dest_y
</FUNCTION>
<ENUM>
<NAME>GdkPixbufAlphaMode</NAME>
typedef enum {
GDK_PIXBUF_ALPHA_BILEVEL,
GDK_PIXBUF_ALPHA_FULL
} GdkPixbufAlphaMode;
</ENUM>
<FUNCTION>
<NAME>gdk_pixbuf_render_threshold_alpha</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf, GdkBitmap *bitmap,int src_x, int src_y,int dest_x, int dest_y,int width, int height,int alpha_threshold
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_render_to_drawable</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf,GdkDrawable *drawable, GdkGC *gc,int src_x, int src_y,int dest_x, int dest_y,int width, int height,GdkRgbDither dither,int x_dither, int y_dither
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_render_to_drawable_alpha</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf, GdkDrawable *drawable,int src_x, int src_y,int dest_x, int dest_y,int width, int height,GdkPixbufAlphaMode alpha_mode,int alpha_threshold,GdkRgbDither dither,int x_dither, int y_dither
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_render_pixmap_and_mask</NAME>
<RETURNS>void </RETURNS>
GdkPixbuf *pixbuf,GdkPixmap **pixmap_return, GdkBitmap **mask_return,int alpha_threshold
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_get_from_drawable</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
GdkPixbuf *dest,GdkDrawable *src, GdkColormap *cmap,int src_x, int src_y,int dest_x, int dest_y,int width, int height
</FUNCTION>
<ENUM>
<NAME>GdkInterpType</NAME>
typedef enum {
GDK_INTERP_NEAREST,
GDK_INTERP_TILES,
GDK_INTERP_BILINEAR,
GDK_INTERP_HYPER
} GdkInterpType;
</ENUM>
<FUNCTION>
<NAME>gdk_pixbuf_scale</NAME>
<RETURNS>void </RETURNS>
const GdkPixbuf *src,GdkPixbuf *dest,int dest_x,int dest_y,int dest_width,int dest_height,double offset_x,double offset_y,double scale_x,double scale_y,GdkInterpType interp_type
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_composite</NAME>
<RETURNS>void </RETURNS>
const GdkPixbuf *src,GdkPixbuf *dest,int dest_x,int dest_y,int dest_width,int dest_height,double offset_x,double offset_y,double scale_x,double scale_y,GdkInterpType interp_type,int overall_alpha
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_composite_color</NAME>
<RETURNS>void </RETURNS>
const GdkPixbuf *src,GdkPixbuf *dest,int dest_x,int dest_y,int dest_width,int dest_height,double offset_x,double offset_y,double scale_x,double scale_y,GdkInterpType interp_type,int overall_alpha,int check_x,int check_y,int check_size,guint32 color1,guint32 color2
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_scale_simple</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const GdkPixbuf *src,int dest_width,int dest_height,GdkInterpType interp_type
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_composite_color_simple</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
const GdkPixbuf *src,int dest_width,int dest_height,GdkInterpType interp_type,int overall_alpha,int check_size,guint32 color1,guint32 color2
</FUNCTION>
<ENUM>
<NAME>GdkPixbufFrameAction</NAME>
typedef enum {
GDK_PIXBUF_FRAME_RETAIN,
GDK_PIXBUF_FRAME_DISPOSE,
GDK_PIXBUF_FRAME_REVERT
} GdkPixbufFrameAction;
</ENUM>
<FUNCTION>
<NAME>gdk_pixbuf_animation_new_from_file</NAME>
<RETURNS>GdkPixbufAnimation *</RETURNS>
const char *filename
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_animation_ref</NAME>
<RETURNS>GdkPixbufAnimation *</RETURNS>
GdkPixbufAnimation *animation
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_animation_unref</NAME>
<RETURNS>void </RETURNS>
GdkPixbufAnimation *animation
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_animation_get_width</NAME>
<RETURNS>int </RETURNS>
GdkPixbufAnimation *animation
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_animation_get_height</NAME>
<RETURNS>int </RETURNS>
GdkPixbufAnimation *animation
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_animation_get_frames</NAME>
<RETURNS>GList *</RETURNS>
GdkPixbufAnimation *animation
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_animation_get_num_frames</NAME>
<RETURNS>int </RETURNS>
GdkPixbufAnimation *animation
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_frame_get_pixbuf</NAME>
<RETURNS>GdkPixbuf *</RETURNS>
GdkPixbufFrame *frame
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_frame_get_x_offset</NAME>
<RETURNS>int </RETURNS>
GdkPixbufFrame *frame
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_frame_get_y_offset</NAME>
<RETURNS>int </RETURNS>
GdkPixbufFrame *frame
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_frame_get_delay_time</NAME>
<RETURNS>int </RETURNS>
GdkPixbufFrame *frame
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_frame_get_action</NAME>
<RETURNS>GdkPixbufFrameAction </RETURNS>
GdkPixbufFrame *frame
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_preinit</NAME>
<RETURNS>void </RETURNS>
gpointer app, gpointer modinfo
</FUNCTION>
<FUNCTION>
<NAME>gdk_pixbuf_postinit</NAME>
<RETURNS>void </RETURNS>
gpointer app, gpointer modinfo
</FUNCTION>
<MACRO>
<NAME>GNOME_TYPE_CANVAS_PIXBUF</NAME>
#define GNOME_TYPE_CANVAS_PIXBUF (gnome_canvas_pixbuf_get_type ())
</MACRO>
<MACRO>
<NAME>GNOME_CANVAS_PIXBUF</NAME>
#define GNOME_CANVAS_PIXBUF(obj) (GTK_CHECK_CAST ((obj), \
GNOME_TYPE_CANVAS_PIXBUF, GnomeCanvasPixbuf))
</MACRO>
<MACRO>
<NAME>GNOME_CANVAS_PIXBUF_CLASS</NAME>
#define GNOME_CANVAS_PIXBUF_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), \
GNOME_TYPE_CANVAS_PIXBUF, GnomeCanvasPixbufClass))
</MACRO>
<MACRO>
<NAME>GNOME_IS_CANVAS_PIXBUF</NAME>
#define GNOME_IS_CANVAS_PIXBUF(obj) (GTK_CHECK_TYPE ((obj), GNOME_TYPE_CANVAS_PIXBUF))
</MACRO>
<MACRO>
<NAME>GNOME_IS_CANVAS_PIXBUF_CLASS</NAME>
#define GNOME_IS_CANVAS_PIXBUF_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), \
GNOME_TYPE_CANVAS_PIXBUF))
</MACRO>
<STRUCT>
<NAME>GnomeCanvasPixbuf</NAME>
</STRUCT>
<STRUCT>
<NAME>GnomeCanvasPixbufClass</NAME>
</STRUCT>
<STRUCT>
<NAME>GnomeCanvasPixbuf</NAME>
struct GnomeCanvasPixbuf {
GnomeCanvasItem item;
/* Private data */
gpointer priv;
};
</STRUCT>
<FUNCTION>
<NAME>gnome_canvas_pixbuf_get_type</NAME>
<RETURNS>GtkType </RETURNS>
void
</FUNCTION>
<MACRO>
<NAME>GDK_PIXBUF_MAJOR</NAME>
#define GDK_PIXBUF_MAJOR (0)
</MACRO>
<MACRO>
<NAME>GDK_PIXBUF_MINOR</NAME>
#define GDK_PIXBUF_MINOR (7)
</MACRO>
<MACRO>
<NAME>GDK_PIXBUF_MICRO</NAME>
#define GDK_PIXBUF_MICRO (0)
</MACRO>
<MACRO>
<NAME>GDK_PIXBUF_VERSION</NAME>
#define GDK_PIXBUF_VERSION "0.7.0"
</MACRO>
<VARIABLE>
<NAME>gdk_pixbuf_version</NAME>
extern const char *gdk_pixbuf_version;
</VARIABLE>
<STRUCT>
<NAME>GdkPixbuf</NAME>
struct GdkPixbuf {
/* Reference count */
int ref_count;
/* Color space */
GdkColorspace colorspace;
/* Number of channels, alpha included */
int n_channels;
/* Bits per channel */
int bits_per_sample;
/* Size */
int width, height;
/* Offset between rows */
int rowstride;
/* The pixel array */
guchar *pixels;
/* Destroy notification function; it is supposed to free the pixel array */
GdkPixbufDestroyNotify destroy_fn;
/* User data for the destroy notification function */
gpointer destroy_fn_data;
/* Last unref handler, determines whether the pixbuf should be finalized */
GdkPixbufLastUnref last_unref_fn;
/* User data for the last unref handler */
gpointer last_unref_fn_data;
/* Do we have an alpha channel? */
guint has_alpha : 1;
};
</STRUCT>
<STRUCT>
<NAME>GdkPixbufFrame</NAME>
struct GdkPixbufFrame {
/* The pixbuf with this frame's image data */
GdkPixbuf *pixbuf;
/* Offsets for overlaying onto the animation's area */
int x_offset;
int y_offset;
/* Frame duration in ms */
int delay_time;
/* Overlay mode */
GdkPixbufFrameAction action;
};
</STRUCT>
<STRUCT>
<NAME>GdkPixbufAnimation</NAME>
struct GdkPixbufAnimation {
/* Reference count */
int ref_count;
/* Number of frames */
int n_frames;
/* List of GdkPixbufFrame structures */
GList *frames;
/* bounding box size */
int width, height;
};
</STRUCT>

0
docs/reference/gdk-pixbuf/gdk-pixbuf-overrides.txt Normal file
View File

85
docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt
View File

@ -1,9 +1,25 @@
<INCLUDE>gdk-pixbuf/gdk-pixbuf.h</INCLUDE>
<SECTION>
<TITLE>Initialization and Versions</TITLE>
<FILE>initialization_versions</FILE>
gdk_pixbuf_init
gdk_pixbuf_preinit
gdk_pixbuf_postinit
<SUBSECTION>
gdk_pixbuf_version
GDK_PIXBUF_VERSION
GDK_PIXBUF_MAJOR
GDK_PIXBUF_MINOR
GDK_PIXBUF_MICRO
</SECTION>
<SECTION>
<FILE>gdk-pixbuf</FILE>
GdkColorspace
GdkPixbuf
GdkPixbufClass
gdk_pixbuf_get_colorspace
gdk_pixbuf_get_n_channels
gdk_pixbuf_get_has_alpha
@ -12,16 +28,24 @@ gdk_pixbuf_get_pixels
gdk_pixbuf_get_width
gdk_pixbuf_get_height
gdk_pixbuf_get_rowstride
<SUBSECTION Standard>
GDK_PIXBUF
GDK_TYPE_PIXBUF
GDK_IS_PIXBUF
GDK_IS_PIXBUF_CLASS
GDK_PIXBUF_CLASS
GDK_PIXBUF_GET_CLASS
<SUBSECTION Private>
gdk_pixbuf_get_type
</SECTION>
<SECTION>
<FILE>refcounting</FILE>
GdkPixbufDestroyNotify
GdkPixbufLastUnref
gdk_pixbuf_ref
gdk_pixbuf_unref
gdk_pixbuf_set_last_unref_handler
gdk_pixbuf_finalize
</SECTION>
<SECTION>
@ -37,20 +61,6 @@ gdk_pixbuf_new_from_xpm_data
gdk_pixbuf_copy
</SECTION>
<SECTION>
<FILE>rendering</FILE>
GdkPixbufAlphaMode
gdk_pixbuf_render_to_drawable_alpha
gdk_pixbuf_render_to_drawable
gdk_pixbuf_render_threshold_alpha
gdk_pixbuf_render_pixmap_and_mask
</SECTION>
<SECTION>
<FILE>from-drawables</FILE>
gdk_pixbuf_get_from_drawable
</SECTION>
<SECTION>
<FILE>util</FILE>
gdk_pixbuf_add_alpha
@ -62,6 +72,7 @@ gdk_pixbuf_copy_area
GdkPixbufFrameAction
GdkPixbufFrame
GdkPixbufAnimation
GdkPixbufAnimationClass
gdk_pixbuf_animation_new_from_file
gdk_pixbuf_animation_ref
gdk_pixbuf_animation_unref
@ -74,6 +85,17 @@ gdk_pixbuf_frame_get_action
gdk_pixbuf_frame_get_y_offset
gdk_pixbuf_frame_get_delay_time
gdk_pixbuf_frame_get_x_offset
<SUBSECTION Standard>
GDK_PIXBUF_ANIMATION
GDK_PIXBUF_ANIMATION_CLASS
GDK_TYPE_PIXBUF_ANIMATION
GDK_PIXBUF_ANIMATION_GET_CLASS
GDK_IS_PIXBUF_ANIMATION_CLASS
GDK_IS_PIXBUF_ANIMATION
<SUBSECTION Private>
gdk_pixbuf_animation_get_type
</SECTION>
<SECTION>
@ -88,33 +110,34 @@ gdk_pixbuf_composite_color_simple
<SECTION>
<FILE>gdk-pixbuf-loader</FILE>
GDK_PIXBUF_LOADER
<TITLE>GdkPixbufLoader</TITLE>
gdk_pixbuf_loader_new
gdk_pixbuf_loader_new_with_type
gdk_pixbuf_loader_write
gdk_pixbuf_loader_get_pixbuf
gdk_pixbuf_loader_get_animation
gdk_pixbuf_loader_close
<SUBSECTION Standard>
GDK_PIXBUF_LOADER
GDK_PIXBUF_LOADER_GET_CLASS
GDK_TYPE_PIXBUF_LOADER
GDK_IS_PIXBUF_LOADER
gdk_pixbuf_loader_get_type
GDK_PIXBUF_LOADER_CLASS
GDK_IS_PIXBUF_LOADER_CLASS
<SUBSECTION Private>
GdkPixbufLoader
gdk_pixbuf_loader_get_type
</SECTION>
<SECTION>
<FILE>gnome-canvas-pixbuf</FILE>
GNOME_CANVAS_PIXBUF
<TITLE>GnomeCanvasPixbuf</TITLE>
<SUBSECTION Standard>
GNOME_TYPE_CANVAS_PIXBUF
GNOME_IS_CANVAS_PIXBUF
gnome_canvas_pixbuf_get_type
GNOME_CANVAS_PIXBUF_CLASS
GNOME_IS_CANVAS_PIXBUF_CLASS
<SUBSECTION Private>
GnomeCanvasPixbuf
</SECTION>
<TITLE>Module Interface</TITLE>
<FILE>module_interface</FILE>
ModulePreparedNotifyFunc
ModuleUpdatedNotifyFunc
ModuleFrameDoneNotifyFunc
ModuleAnimationDoneNotifyFunc
GdkPixbufModule
gdk_pixbuf_get_module
gdk_pixbuf_get_named_module
gdk_pixbuf_load_module
</SECTION>

15
docs/reference/gdk-pixbuf/gdk-pixbuf.sgml
View File

@ -1,4 +1,5 @@
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!entity gdk-pixbuf-Initialization-and-Versions SYSTEM "sgml/initialization_versions.sgml">
<!entity gdk-pixbuf-gdk-pixbuf SYSTEM "sgml/gdk-pixbuf.sgml">
<!entity gdk-pixbuf-refcounting SYSTEM "sgml/refcounting.sgml">
<!entity gdk-pixbuf-file-loading SYSTEM "sgml/file-loading.sgml">
@ -8,12 +9,13 @@
<!entity gdk-pixbuf-from-drawables SYSTEM "sgml/from-drawables.sgml">
<!entity gdk-pixbuf-util SYSTEM "sgml/util.sgml">
<!entity gdk-pixbuf-animation SYSTEM "sgml/animation.sgml">
<!entity gdk-pixbuf-Module-Interface SYSTEM "sgml/module_interface.sgml">
<!entity GdkPixbufLoader SYSTEM "sgml/gdk-pixbuf-loader.sgml">
<!entity GnomeCanvasPixbuf SYSTEM "sgml/gnome-canvas-pixbuf.sgml">
<!entity Compiling SYSTEM "compiling.sgml">
]>
<book>
<book id="index">
<bookinfo>
<title>The <application>gdk-pixbuf</application> Library</title>
@ -35,7 +37,7 @@
</copyright>
</bookinfo>
<reference>
<reference id="api">
<title>API Reference</title>
<partintro>
@ -47,18 +49,23 @@
</para>
</partintro>
&gdk-pixbuf-Initialization-and-Versions;
&gdk-pixbuf-gdk-pixbuf;
&gdk-pixbuf-refcounting;
&gdk-pixbuf-file-loading;
&gdk-pixbuf-creating;
&gdk-pixbuf-rendering;
&gdk-pixbuf-scaling;
&gdk-pixbuf-from-drawables;
&gdk-pixbuf-util;
&gdk-pixbuf-animation;
&GdkPixbufLoader;
&GnomeCanvasPixbuf;
</reference>
<reference id="internals">
<title>Internals</title>
&gdk-pixbuf-Module-Interface;
</reference>
&Compiling;
</book>

26
docs/reference/gdk-pixbuf/tmpl/animation.sgml
View File

@ -29,10 +29,8 @@ Animations as multi-frame structures.
@GDK_PIXBUF_FRAME_RETAIN: The previous image should remain displayed,
and will potentially be occluded by the new frame.
@GDK_PIXBUF_FRAME_DISPOSE: The animation will be reverted to the state
before the frame was shown.
@GDK_PIXBUF_FRAME_REVERT: The animation will be reverted to the first
frame.
@ -44,12 +42,30 @@ frame.
action.
</para>
@pixbuf:
@x_offset:
@y_offset:
@delay_time:
@action:
<!-- ##### STRUCT GdkPixbufAnimation ##### -->
<para>
This structure describes an animation, which is represented as a
list of #GdkPixbufFrame structures.
</para>
@parent_instance:
@n_frames:
@frames:
@width:
@height:
<!-- ##### STRUCT GdkPixbufAnimationClass ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_pixbuf_animation_new_from_file ##### -->
<para>
@ -154,11 +170,11 @@ frame.
</para>
@frame:
@Returns:
<!--
@Returns: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

4
docs/reference/gdk-pixbuf/tmpl/creating.sgml
View File

@ -88,9 +88,7 @@ Creating a pixbuf from image data that is already in memory.
</para>
@pixbuf:
@Returns:
<!--
@Returns: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")

3
docs/reference/gdk-pixbuf/tmpl/file-loading.sgml
View File

@ -32,8 +32,7 @@ Loading a pixbuf from a file.
</para>
@filename:
@Returns:
<!--
@Returns: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")

43
docs/reference/gdk-pixbuf/tmpl/from-drawables.sgml
View File

@ -1,43 +0,0 @@
<!-- ##### SECTION Title ##### -->
Drawables to Pixbufs
<!-- ##### SECTION Short_Description ##### -->
Getting parts of a drawable's image data into a pixbuf.
<!-- ##### SECTION Long_Description ##### -->
<para>
The functions in this section allow you to take the image data
from a GDK drawable and dump it into a #GdkPixbuf. This can be
used for screenshots and other special effects. Note that these
operations can be expensive, since the image data has to be
transferred from the X server to the client program and converted.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
gdk_image_get().
</para>
<!-- ##### FUNCTION gdk_pixbuf_get_from_drawable ##### -->
<para>
</para>
@dest:
@src:
@cmap:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@Returns:
<!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

32
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml
View File

@ -74,14 +74,6 @@ Application-driven progressive image loading.
gdk_pixbuf_new_from_file()
</para>
<!-- ##### MACRO GDK_PIXBUF_LOADER ##### -->
<para>
Casts a #GtkObject to a #GdkPixbufLoader.
</para>
@obj: A GTK+ object.
<!-- ##### FUNCTION gdk_pixbuf_loader_new ##### -->
<para>
@ -90,6 +82,15 @@ Application-driven progressive image loading.
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_loader_new_with_type ##### -->
<para>
</para>
@image_type:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_loader_write ##### -->
<para>
@ -136,6 +137,12 @@ Application-driven progressive image loading.
areas of an image that is being loaded.
</para>
@gdkpixbufloader: the object which received the signal.
@arg1:
@arg2:
@arg3:
@arg4:
<!-- # Unused Parameters # -->
@loader: Loader which emitted the signal.
@x: X offset of upper-left corner of the updated area.
@y: Y offset of upper-left corner of the updated area.
@ -151,6 +158,8 @@ Application-driven progressive image loading.
fetch the partially-loaded pixbuf.
</para>
@gdkpixbufloader: the object which received the signal.
<!-- # Unused Parameters # -->
@loader: Loader which emitted the signal.
<!-- ##### SIGNAL GdkPixbufLoader::frame-done ##### -->
@ -159,6 +168,9 @@ Application-driven progressive image loading.
emitted for each frame in an animation data stream.
</para>
@gdkpixbufloader: the object which received the signal.
@arg1:
<!-- # Unused Parameters # -->
@loader: Loader which emitted the signal.
@frame: Frame which just completed loading.
@ -167,6 +179,8 @@ Application-driven progressive image loading.
This signal is emitted when an animation is done loading.
</para>
@gdkpixbufloader: the object which received the signal.
<!-- # Unused Parameters # -->
@loader: Loader which emitted the signal.
<!-- ##### SIGNAL GdkPixbufLoader::closed ##### -->
@ -177,6 +191,8 @@ Application-driven progressive image loading.
drives it.
</para>
@gdkpixbufloader: the object which received the signal.
<!-- # Unused Parameters # -->
@loader: Loader which emitted the signal.
<!--

294
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
View File

@ -1,27 +1,148 @@
<!-- ##### FUNCTION gdk_pixbuf_load_module ##### -->
<!-- ##### USER_FUNCTION GdkPixbufLastUnref ##### -->
<para>
A function of this type can be used to override the default
operation when a pixbuf loses its last reference, i.e. when
gdk_pixbuf_unref() is called on a #GdkPixbuf structure that has a
reference count of 1. This function should determine whether to
finalize the pixbuf by calling gdk_pixbuf_finalize(), or whether
to just resume normal execution. The last unref handler for a
#GdkPixbuf can be set using the
gdk_pixbuf_set_last_unref_handler() function. By default, pixbufs
will be finalized automatically if no last unref handler has been
defined.
</para>
@pixbuf: The pixbuf that is losing its last reference.
@data: User closure data.
<!-- ##### SECTION ./tmpl/from-drawables.sgml:Title ##### -->
Drawables to Pixbufs
<!-- ##### ARG GnomeCanvasPixbuf:height_pixels ##### -->
<para>
</para>
<!-- ##### SECTION ./tmpl/rendering.sgml:See_Also ##### -->
<para>
GdkRGB
</para>
<!-- ##### FUNCTION gdk_pixbuf_render_pixmap_and_mask ##### -->
<para>
</para>
@pixbuf:
@pixmap_return:
@mask_return:
@alpha_threshold: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->
<!-- ##### FUNCTION gdk_pixbuf_render_to_drawable ##### -->
<para>
</para>
@pixbuf:
@drawable:
@gc:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@dither:
@x_dither:
@y_dither:
<!-- ##### FUNCTION gdk_pixbuf_get_from_drawable ##### -->
<para>
</para>
@dest:
@src:
@cmap:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@Returns: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->
<!-- ##### FUNCTION gdk_pixbuf_new_from_art_pixbuf ##### -->
<para>
</para>
@art_pixbuf:
@Returns:
<!-- ##### ARG GnomeCanvasPixbuf:y_pixels ##### -->
<para>
</para>
@image_module:
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Short_Description ##### -->
<!-- ##### STRUCT GdkPixbufModule ##### -->
<!-- ##### SECTION ./tmpl/from-drawables.sgml:Long_Description ##### -->
<para>
The functions in this section allow you to take the image data
from a GDK drawable and dump it into a #GdkPixbuf. This can be
used for screenshots and other special effects. Note that these
operations can be expensive, since the image data has to be
transferred from the X server to the client program and converted.
</para>
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:See_Also ##### -->
<para>
</para>
@module_name:
@format_check:
@module:
@load:
@load_xpm_data:
@begin_load:
@stop_load:
@load_increment:
<!-- ##### FUNCTION gdk_pixbuf_finalize ##### -->
<para>
</para>
@pixbuf: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->
<!-- ##### SECTION ./tmpl/rendering.sgml:Short_Description ##### -->
Rendering a pixbuf to a GDK drawable.
<!-- ##### FUNCTION gdk_pixbuf_set_last_unref_handler ##### -->
<para>
</para>
@pixbuf:
@last_unref_fn:
@last_unref_fn_data:
<!-- ##### ARG GnomeCanvasPixbuf:x_set ##### -->
<para>
@ -32,70 +153,55 @@
</para>
<!-- ##### USER_FUNCTION ModulePreparedNotifyFunc ##### -->
<!-- ##### FUNCTION gdk_pixbuf_get_format ##### -->
<para>
</para>
@pixbuf:
@user_data:
<!-- ##### FUNCTION gdk_pixbuf_get_module ##### -->
<para>
</para>
@buffer:
@size:
@Returns:
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:See_Also ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_pixbuf_new_from_art_pixbuf ##### -->
<para>
</para>
@art_pixbuf:
@Returns:
<!-- ##### ARG GnomeCanvasPixbuf:height_pixels ##### -->
<para>
</para>
<!-- ##### ARG GnomeCanvasPixbuf:y_pixels ##### -->
<para>
</para>
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Long_Description ##### -->
<para>
</para>
<!-- ##### USER_FUNCTION ModuleUpdatedNotifyFunc ##### -->
<!-- ##### FUNCTION gdk_pixbuf_render_to_drawable_alpha ##### -->
<para>
</para>
@pixbuf:
@user_data:
@x:
@y:
@drawable:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@alpha_mode:
@alpha_threshold:
@dither:
@x_dither:
@y_dither:
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Title ##### -->
gdk-pixbuf-io
<!-- ##### ARG GnomeCanvasPixbuf:x_pixels ##### -->
<para>
</para>
<!-- ##### SECTION ./tmpl/from-drawables.sgml:See_Also ##### -->
<para>
gdk_image_get().
</para>
<!-- ##### SECTION ./tmpl/rendering.sgml:Title ##### -->
Rendering
<!-- ##### MACRO GDK_PIXBUF_LOADER ##### -->
<para>
Casts a #GtkObject to a #GdkPixbufLoader.
</para>
@obj: A GTK+ object.
<!-- ##### ARG GnomeCanvasPixbuf:y_set ##### -->
<para>
@ -108,19 +214,50 @@ gdk-pixbuf-io
</para>
<!-- ##### ARG GnomeCanvasPixbuf:x_pixels ##### -->
<para>
<!-- ##### SECTION ./tmpl/rendering.sgml:Long_Description ##### -->
<para>
The <application>gdk-pixbuf</application> library provides several
convenience functions to render pixbufs to GDK drawables. It uses
the GdkRGB to render the image data.
</para>
</para>
<para>
At this point there is not a standard alpha channel extension for
the X Window System, so it is not possible to use full opacity
information when painting images to arbitrary drawables. The
<application>gdk-pixbuf</application> convenience functions will
threshold the opacity information to create a bi-level clipping
mask (black and white), and use that to draw the image onto a
drawable.
</para>
<important>
<para>
Since these functions use GdkRGB for rendering, you must
initialize GdkRGB before using any of them. You can do this by
calling gdk_rgb_init() near the beginning of your program.
</para>
</important>
<!-- ##### FUNCTION gdk_pixbuf_get_format ##### -->
<!-- ##### SECTION ./tmpl/from-drawables.sgml:Short_Description ##### -->
Getting parts of a drawable's image data into a pixbuf.
<!-- ##### FUNCTION gdk_pixbuf_render_threshold_alpha ##### -->
<para>
</para>
@pixbuf:
@Returns:
@bitmap:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@alpha_threshold:
<!-- ##### ARG GnomeCanvasPixbuf:width_pixels ##### -->
<para>
@ -128,3 +265,32 @@ gdk-pixbuf-io
</para>
<!-- ##### ENUM GdkPixbufAlphaMode ##### -->
<para>
These values can be passed to
gdk_pixbuf_render_to_drawable_alpha() to control how the alpha
chanel of an image should be handled. This function can create a
bilevel clipping mask (black and white) and use it while painting
the image. In the future, when the X Window System gets an alpha
channel extension, it will be possible to do full alpha
compositing onto arbitrary drawables. For now both cases fall
back to a bilevel clipping mask.
</para>
@GDK_PIXBUF_ALPHA_BILEVEL: A bilevel clipping mask (black and white)
will be created and used to draw the image. Pixels below 0.5 opacity
will be considered fully transparent, and all others will be
considered fully opaque.
@GDK_PIXBUF_ALPHA_FULL: For now falls back to #GDK_PIXBUF_ALPHA_BILEVEL.
In the future it will do full alpha compositing.
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Title ##### -->
gdk-pixbuf-io

24
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf.sgml
View File

@ -33,6 +33,24 @@ Information that describes an image.
rowstride or number of bytes between rows.
</para>
@parent_instance:
@colorspace:
@n_channels:
@bits_per_sample:
@width:
@height:
@rowstride:
@pixels:
@destroy_fn:
@destroy_fn_data:
@has_alpha:
<!-- ##### STRUCT GdkPixbufClass ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_pixbuf_get_colorspace ##### -->
<para>
@ -102,11 +120,11 @@ Information that describes an image.
</para>
@pixbuf:
@Returns:
<!--
@Returns: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

301
docs/reference/gdk-pixbuf/tmpl/gnome-canvas-pixbuf.sgml
View File

@ -1,301 +0,0 @@
<!-- ##### SECTION Title ##### -->
GnomeCanvasPixbuf
<!-- ##### SECTION Short_Description ##### -->
Canvas item to display #GdkPixbuf images.
<!-- ##### SECTION Long_Description ##### -->
<para>
This canvas item displays #GdkPixbuf images. It handles full
affine transformations in both GDK and antialiased modes, and also
supports the <ulink url="http://www.w3.org">W3C</ulink>'s <ulink
url="http://www.w3.org/Graphics/SVG/">SVG</ulink>-like scaling and
translation semantics for absolute pixel values.
</para>
<para>
#GdkPixbuf structures may be shared among different pixbuf canvas
items; the pixbuf item uses #GdkPixbuf's reference counting
functions for this.
</para>
<refsect2>
<title>Custom Scaling and Translation</title>
<para>
In addition to the normal affine transformations supported by
canvas items, the #GnomeCanvasPixbuf item supports independent
object arguments for scaling and translation. This is useful
for explicitly setting a size to which the pixbuf's image will
be scaled, and for specifying translation offsets that take
place in the item's local coordinate system.
</para>
<para>
By default, the pixbuf canvas item will attain the size in units
of the #GdkPixbuf it contains. If a #GnomeCanvasPixbuf is
configured to use a #GdkPixbuf that has a size of 300 by 200
pixels, then the pixbuf item will automatically obtain a size of
300 by 200 units in the item's local coordinate system. If the
item is transformed with a scaling transformation of (0.5, 2.0),
then the final image size will be of 150 by 400 pixels.
</para>
<para>
To set custom width and height values, you must set the <link
linkend="GnomeCanvasPixbuf--width-set">width_set</link> or <link
linkend="GnomeCanvasPixbuf--height-set">height_set</link>
arguments to %TRUE, and then set the <link
linkend="GnomeCanvasPixbuf--width">width</link> or <link
linkend="GnomeCanvasPixbuf--height">height</link> arguments to
the desired values. The former two arguments control whether
the latter two are used when computing the final image's size;
they are both %FALSE by default so that the pixbuf item will
attain a size in units equal to the size in pixels of the
#GdkPixbuf that the item contains.
</para>
<para>
The custom translation offsets are controlled by the <link
linkend="GnomeCanvasPixbuf--x">x</link> and <link
linkend="GnomeCanvasPixbuf--y">y</link> arguments. The logical
upper-left vertex of the image will be translated by the
specified distance, aligned with the item's local coordinate
system.
</para>
</refsect2>
<refsect2>
<title>Absolute Pixel Scaling and Translation</title>
<para>
The <ulink url="http://www.w3.org/Graphics/SVG/">Scalable Vector
Graphics</ulink> specification (SVG) of the <ulink
url="http://www.w3.org">World Wide Web Consortium</ulink> also
allows images to be translated and scaled by absolute pixel
values that are independent of an item's normal affine
transformation.
</para>
<para>
Normally, the pixbuf item's translation and scaling arguments
are interpreted in units, so they will be modified by the item's
affine transformation. The <link
linkend="GnomeCanvasPixbuf--width-in-pixels">width_in_pixels</link>,
<link
linkend="GnomeCanvasPixbuf--height-in-pixels">height_in_pixels</link>,
<link
linkend="GnomeCanvasPixbuf--x-in-pixels">x_in_pixels</link>, and
<link
linkend="GnomeCanvasPixbuf--y-in-pixels">y_in_pixels</link>
object arguments can be used to modify this behavior. If one of
these arguments is %TRUE, then the corresponding scaling or
translation value will not be affected lengthwise by the pixbuf
item's affine transformation.
</para>
<para>
For example, consider a pixbuf item whose size is (300, 200).
If the item is modified with a scaling transformation of (0.5,
2.0) but the <link
linkend="GnomeCanvasPixbuf--width-in-pixels">width_in_pixels</link>
is set to %TRUE, then the item will appear to be (300, 400)
pixels in size. This means that in this case the item's affine
transformation only applies to the height value, while the width
value is kept in absolute pixels.
</para>
<para>
Likewise, consider a pixbuf item whose (<link
linkend="GnomeCanvasPixbuf--x">x</link>, <link
linkend="GnomeCanvasPixbuf--y">y</link>) arguments are set to
(30, 40). If the item is then modified by the same scaling
transformation of (0.5, 2.0) but the <link
linkend="GnomeCanvasPixbuf--y-in-pixels">y_in_pixels</link>
argument is set to %TRUE, then the image's upper-left corner
will appear to be at position (15, 40). In this case, the
affine transformation is applied only to the x offset, while the
y offset is kept in absolute pixels.
</para>
<para>
In short, these arguments control whether a particular dimension
of a pixbuf item is scaled or not in the normal way by the
item's affine transformation.
</para>
</refsect2>
<refsect2>
<title>Resource Management</title>
<para>
When you set the #GdkPixbuf structure that a #GnomeCanvasPixbuf
item will use by setting the <link
linkend="GnomeCanvasPixbuf--pixbuf">pixbuf</link> argument, a
reference count will be added to that #GdkPixbuf structure.
When the pixbuf item no longer needs the #GdkPixbuf structure,
such as when the item is destroyed or when a new pixbuf
structure is passed to it, then the old #GdkPixbuf structure
will be automatically unreferenced.
</para>
<para>
This means that if an application just needs to load a pixbuf
image and set it into a pixbuf canvas item, it can do the
following to &lsquo;forget&rsquo; about the pixbuf structure:
<programlisting>
GdkPixbuf *pixbuf;
GnomeCanvasItem *item;
pixbuf = gdk_pixbuf_new_from_file ("foo.png");
g_assert (pixbuf != NULL);
item = gnome_canvas_item_new (gnome_canvas_root (my_canvas),
gnome_canvas_pixbuf_get_type (),
"pixbuf", pixbuf,
NULL);
gdk_pixbuf_unref (pixbuf);
</programlisting>
</para>
<para>
After this happens, the reference count of the pixbuf structure
will be 1: the gdk_pixbuf_new_from_file() function creates it
with a reference count of 1, then setting the <link
linkend="GnomeCanvasPixbuf--pixbuf">pixbuf</link> argument of
the #GnomeCanvasPixbuf item increases it to 2, and then it is
decremented to 1 by the call to gdk_pixbuf_unref(). When the
canvas item is destroyed, it will automatically unreference the
pixbuf structure again, causing its reference count to drop to
zero and thus be freed.
</para>
</refsect2>
<!-- ##### SECTION See_Also ##### -->
<para>
#GnomeCanvas, #GdkPixbuf
</para>
<!-- ##### MACRO GNOME_CANVAS_PIXBUF ##### -->
<para>
Casts a #GtkOjbect to a #GnomeCanvasPixbuf.
</para>
@obj: A GTK+ object.
<!-- ##### ARG GnomeCanvasPixbuf:pixbuf ##### -->
<para>
Contains a pointer to a #GdkPixbuf structure that will be used by
the pixbuf canvas item as an image source. When a pixbuf is set
its reference count is incremented; if the pixbuf item kept a
pointer to another #GdkPixbuf structure, the reference count of
this structure will be decremented. Also, the GdkPixbuf's
reference count will automatically be decremented when the
#GnomeCanvasPixbuf item is destroyed. When a pixbuf is queried, a
reference count will not be added to the return value; you must do
this yourself if you intend to keep the pixbuf structure around.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:width ##### -->
<para>
Indicates the width the pixbuf will be scaled to. This argument
will only be used if the <link
linkend="GnomeCanvasPixbuf--width-set">width_set</link> argument
is %TRUE. If the <link
linkend="GnomeCanvasPixbuf--width-in-pixels">width_in_pixels</link>
argument is %FALSE, the width will be taken to be in canvas units,
and thus will be scaled along with the canvas item's affine
transformation. If width_in_pixels is %TRUE, the width will be
taken to be in pixels, and will visually remain a constant size
even if the item's affine transformation changes.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:width_set ##### -->
<para>
Determines whether the <link
linkend="GnomeCanvasPixbuf--width">width</link> argument is taken
into account when scaling the pixbuf item. If this argument is
%FALSE, then the width value of the pixbuf will be used instead.
This argument is %FALSE by default.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:width_in_pixels ##### -->
<para>
If this argument is %TRUE, then the width of the pixbuf will be
considered to be in pixels, that is, it will not be visually
scaled even if the item's affine transformation changes. If this
is %FALSE, then the width of the pixbuf will be considered to be
in canvas units, and so will be scaled normally by affine
transformations. The default is %FALSE.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:height ##### -->
<para>
Indicates the height the pixbuf will be scaled to. This argument
will only be used if the <link
linkend="GnomeCanvasPixbuf--height-set">height_set</link> argument
is %TRUE. Works in the same way as the <link
linkend="GnomeCanvasPixbuf--width">width</link> argument.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:height_set ##### -->
<para>
Determines whether the <link
linkend="GnomeCanvasPixbuf--height">height</link> argument is
taken into account when scaling the pixbuf item. Works in the
same way as the <link
linkend="GnomeCanvasPixbuf--width-set">width_set</link> argument.
The default is %FALSE.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:height_in_pixels ##### -->
<para>
Works in the same way as the <link
linkend="GnomeCanvasPixbuf--width-in-pixels">width_in_pixels</link>
argument. The default is %FALSE.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:x ##### -->
<para>
Indicates the horizontal translation offset of the pixbuf item's
image. This offset may not actually appear horizontal, since it
will be affected by the item's affine transformation. The default
is 0.0.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:x_in_pixels ##### -->
<para>
If this argument is %TRUE, the pixbuf's translation with respect
to its logical origin in item-relative coordinates will be in
pixels, that is, the visible offset will not change even if the
item's affine transformation changes. If it is %FALSE, the
pixbuf's translation will be taken to be in canvas units, and thus
will change along with the item's affine transformation. The
default is %FALSE.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:y ##### -->
<para>
Indicates the vertical translation offset of the pixbuf item's
image. Works in the same way as the <link
linkend="GnomeCanvasPixbuf--x">x</link> argument. The default is
0.0.
</para>
<!-- ##### ARG GnomeCanvasPixbuf:y_in_pixels ##### -->
<para>
Works in the same way as the <link
linkend="GnomeCanvasPixbuf--x-in-pixels">x_in_pixels</link>
argument, but controls whether the <link
linkend="GnomeCanvasPixbuf--y">y</link> translation offset is
scaled or not. The default is %FALSE.
</para>
<!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

75
docs/reference/gdk-pixbuf/tmpl/initialization_versions.sgml Normal file
View File

@ -0,0 +1,75 @@
<!-- ##### SECTION Title ##### -->
Initialization and Versions
<!-- ##### SECTION Short_Description ##### -->
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_pixbuf_init ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_pixbuf_preinit ##### -->
<para>
</para>
@app:
@modinfo:
<!-- ##### FUNCTION gdk_pixbuf_postinit ##### -->
<para>
</para>
@app:
@modinfo:
<!-- ##### VARIABLE gdk_pixbuf_version ##### -->
<para>
</para>
<!-- ##### MACRO GDK_PIXBUF_VERSION ##### -->
<para>
</para>
<!-- ##### MACRO GDK_PIXBUF_MAJOR ##### -->
<para>
</para>
<!-- ##### MACRO GDK_PIXBUF_MINOR ##### -->
<para>
</para>
<!-- ##### MACRO GDK_PIXBUF_MICRO ##### -->
<para>
</para>

32
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-io.sgml → docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
View File

@ -1,5 +1,5 @@
<!-- ##### SECTION Title ##### -->
gdk-pixbuf-io
Module Interface
<!-- ##### SECTION Short_Description ##### -->
@ -29,11 +29,29 @@ gdk-pixbuf-io
</para>
@pixbuf:
@user_data:
@x:
@y:
@width:
@height:
@user_data:
<!-- ##### USER_FUNCTION ModuleFrameDoneNotifyFunc ##### -->
<para>
</para>
@frame:
@user_data:
<!-- ##### USER_FUNCTION ModuleAnimationDoneNotifyFunc ##### -->
<para>
</para>
@pixbuf:
@user_data:
<!-- ##### STRUCT GdkPixbufModule ##### -->
@ -49,6 +67,7 @@ gdk-pixbuf-io
@begin_load:
@stop_load:
@load_increment:
@load_animation:
<!-- ##### FUNCTION gdk_pixbuf_get_module ##### -->
<para>
@ -60,6 +79,15 @@ gdk-pixbuf-io
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_get_named_module ##### -->
<para>
</para>
@name:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_load_module ##### -->
<para>

41
docs/reference/gdk-pixbuf/tmpl/refcounting.sgml
View File

@ -68,24 +68,6 @@ Functions to perform reference counting and memory management on a
@data: User closure data.
<!-- ##### USER_FUNCTION GdkPixbufLastUnref ##### -->
<para>
A function of this type can be used to override the default
operation when a pixbuf loses its last reference, i.e. when
gdk_pixbuf_unref() is called on a #GdkPixbuf structure that has a
reference count of 1. This function should determine whether to
finalize the pixbuf by calling gdk_pixbuf_finalize(), or whether
to just resume normal execution. The last unref handler for a
#GdkPixbuf can be set using the
gdk_pixbuf_set_last_unref_handler() function. By default, pixbufs
will be finalized automatically if no last unref handler has been
defined.
</para>
@pixbuf: The pixbuf that is losing its last reference.
@data: User closure data.
<!-- ##### FUNCTION gdk_pixbuf_ref ##### -->
<para>
@ -103,26 +85,3 @@ Functions to perform reference counting and memory management on a
@pixbuf:
<!-- ##### FUNCTION gdk_pixbuf_set_last_unref_handler ##### -->
<para>
</para>
@pixbuf:
@last_unref_fn:
@last_unref_fn_data:
<!-- ##### FUNCTION gdk_pixbuf_finalize ##### -->
<para>
</para>
@pixbuf:
<!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

126
docs/reference/gdk-pixbuf/tmpl/rendering.sgml
View File

@ -1,126 +0,0 @@
<!-- ##### SECTION Title ##### -->
Rendering
<!-- ##### SECTION Short_Description ##### -->
Rendering a pixbuf to a GDK drawable.
<!-- ##### SECTION Long_Description ##### -->
<para>
The <application>gdk-pixbuf</application> library provides several
convenience functions to render pixbufs to GDK drawables. It uses
the GdkRGB to render the image data.
</para>
<para>
At this point there is not a standard alpha channel extension for
the X Window System, so it is not possible to use full opacity
information when painting images to arbitrary drawables. The
<application>gdk-pixbuf</application> convenience functions will
threshold the opacity information to create a bi-level clipping
mask (black and white), and use that to draw the image onto a
drawable.
</para>
<important>
<para>
Since these functions use GdkRGB for rendering, you must
initialize GdkRGB before using any of them. You can do this by
calling gdk_rgb_init() near the beginning of your program.
</para>
</important>
<!-- ##### SECTION See_Also ##### -->
<para>
GdkRGB
</para>
<!-- ##### ENUM GdkPixbufAlphaMode ##### -->
<para>
These values can be passed to
gdk_pixbuf_render_to_drawable_alpha() to control how the alpha
chanel of an image should be handled. This function can create a
bilevel clipping mask (black and white) and use it while painting
the image. In the future, when the X Window System gets an alpha
channel extension, it will be possible to do full alpha
compositing onto arbitrary drawables. For now both cases fall
back to a bilevel clipping mask.
</para>
@GDK_PIXBUF_ALPHA_BILEVEL: A bilevel clipping mask (black and white)
will be created and used to draw the image. Pixels below 0.5 opacity
will be considered fully transparent, and all others will be
considered fully opaque.
@GDK_PIXBUF_ALPHA_FULL: For now falls back to #GDK_PIXBUF_ALPHA_BILEVEL.
In the future it will do full alpha compositing.
<!-- ##### FUNCTION gdk_pixbuf_render_to_drawable_alpha ##### -->
<para>
</para>
@pixbuf:
@drawable:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@alpha_mode:
@alpha_threshold:
@dither:
@x_dither:
@y_dither:
<!-- ##### FUNCTION gdk_pixbuf_render_to_drawable ##### -->
<para>
</para>
@pixbuf:
@drawable:
@gc:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@dither:
@x_dither:
@y_dither:
<!-- ##### FUNCTION gdk_pixbuf_render_threshold_alpha ##### -->
<para>
</para>
@pixbuf:
@bitmap:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@alpha_threshold:
<!-- ##### FUNCTION gdk_pixbuf_render_pixmap_and_mask ##### -->
<para>
</para>
@pixbuf:
@pixmap_return:
@mask_return:
@alpha_threshold:
<!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

10
docs/reference/gdk-pixbuf/tmpl/scaling.sgml
View File

@ -84,18 +84,15 @@ expose_cb (GtkWidget *widget, GdkEventExpose *event, gpointer data)
@GDK_INTERP_NEAREST: Nearest neighbor sampling; this is the fastest
and lowest quality mode.
@GDK_INTERP_TILES: This is an accurate simulation of the PostScript
image operator without any interpolation enabled. Each pixel is
rendered as a tiny parallelogram of solid color, the edges of which
are implemented with antialiasing. It resembles nearest neighbor for
enlargement, and bilinear for reduction.
@GDK_INTERP_BILINEAR: Bilinear interpolation. For enlargement, it is
equivalent to point-sampling the ideal bilinear-interpolated image.
For reduction, it is equivalent to laying down small tiles and
integrating over the coverage area.
@GDK_INTERP_HYPER: This is the slowest and highest quality
reconstruction function. It is derived from the hyperbolic filters in
Wolberg's "Digital Image Warping", and is formally defined as the
@ -188,12 +185,11 @@ image (the filter is designed to be idempotent for 1:1 pixel mapping).
@check_size:
@color1:
@color2:
@Returns:
<!--
@Returns: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

8
docs/reference/gdk-pixbuf/tmpl/util.sgml
View File

@ -29,6 +29,7 @@ Utility and miscellaneous convenience functions.
@b:
@Returns:
<!-- ##### FUNCTION gdk_pixbuf_copy_area ##### -->
<para>
@ -41,12 +42,11 @@ Utility and miscellaneous convenience functions.
@height:
@dest_pixbuf:
@dest_x:
@dest_y:
<!--
@dest_y: <!--
Local variables:
mode: sgml
sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "")
End:
-->

144
docs/reference/gdk/Makefile.am
View File

@ -6,45 +6,145 @@ DOC_MODULE=gdk
# The top-level SGML file.
DOC_MAIN_SGML_FILE=gdk-docs.sgml
# We could alternatively use this for using installed headers.
INCLUDE_DIR=`gtk-config --prefix`/include/gdk
# The directory containing the source code (if it contains documentation).
DOC_SOURCE_DIR=$(top_srcdir)/gdk
# Extra options to supply to gtkdoc-fixref
FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html
# Header files to ignore when scanning
IGNORE_HFILES= \
gdkkeysyms.h \
gdkinternals.h \
gdkprivate.h \
gdkpoly-generic.h \
gdkregion-generic.h \
linux-fb \
nanox \
win32 \
x11
# Extra files to add when scanning
EXTRA_HFILES= \
$(top_srcdir)/gdk/x11/gdkx.h
tmpl_sources = \
tmpl/color_contexts.sgml \
tmpl/colors.sgml \
tmpl/cursors.sgml \
tmpl/dnd.sgml \
tmpl/drawing.sgml \
tmpl/event_structs.sgml \
tmpl/events.sgml \
tmpl/fonts.sgml \
tmpl/gcs.sgml \
tmpl/gdk-unused.sgml \
tmpl/general.sgml \
tmpl/images.sgml \
tmpl/input.sgml \
tmpl/input_contexts.sgml \
tmpl/input_devices.sgml \
tmpl/input_methods.sgml \
tmpl/keys.sgml \
tmpl/pango_interaction.sgml \
tmpl/pixbufs.sgml \
tmpl/pixmaps.sgml \
tmpl/properties.sgml \
tmpl/regions.sgml \
tmpl/rgb.sgml \
tmpl/selections.sgml \
tmpl/threads.sgml \
tmpl/visuals.sgml \
tmpl/windows.sgml \
tmpl/x_interaction.sgml
# Extra SGML files that are included by DOC_MAIN_SGML_FILE
content_files =
####################################
# Everything below here is generic #
####################################
TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
scan:
gtkdoc-scan --module=$(DOC_MODULE) $(INCLUDE_DIR)/gdk.h $(INCLUDE_DIR)/gdktypes.h $(INCLUDE_DIR)/gdkrgb.h
EXTRA_DIST = \
$(DOC_MAIN_SGML_FILE) \
$(content_files) \
$(DOC_MODULE)-sections.txt \
$(DOC_MODULE)-overrides.txt
templates: scan
gtkdoc-mktmpl --module=$(DOC_MODULE)
if ENABLE_GTK_DOC
all-local: html/index.html
$(DOC_MODULE)-decl.txt:
$(MAKE) scan
$(tmpl_sources): $(DOC_MODULE)-decl.txt $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt
$(MAKE) templates
sgml/$(DOC_MODULE)-doc.bottom: $(tmpl_sources) $(DOC_MODULE)-decl.txt
$(MAKE) sgml
html/index.html: sgml/$(DOC_MODULE)-doc.bottom $(DOC_MAIN_SGML_FILE) $(content_fiels)
$(MAKE) html
endif
scan:
-(cd $(srcdir) \
&& gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(EXTRA_HFILES))
templates:
cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE)
sgml:
gtkdoc-mkdb --module=$(DOC_MODULE)
cd $(srcdir) \
&& gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR)
html:
if ! test -d html ; then mkdir html ; fi
-cd html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
test -d $(srcdir)/html || mkdir $(srcdir)/html
-cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
@echo '-- Fixing Crossreferences'
gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
clean-local:
rm -f *~ *.bak *.hierarchy *.signals *.args *-unused.txt
rm -f *~ *.bak *.signals *-unused.txt
maintainer-clean-local: clean
rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
cd $(srcdir) && rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
install-data-local:
install -d -m 0755 $(TARGET_DIR)
install -m 0644 html/*.html $(TARGET_DIR)
install -m 0644 html/index.sgml $(TARGET_DIR)
gtkdoc-fixxref --module=$(DOC_MODULE) --html-dir=$(HTML_DIR)
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
(installfiles=`echo $(srcdir)/html/*.html`; \
if test "$$installfiles" = '$(srcdir)/html/*.html'; \
then echo '-- Nothing to install' ; \
else \
for i in $$installfiles; do \
echo '-- Installing '$$i ; \
$(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
done; \
echo '-- Installing $(srcdir)/html/index.sgml' ; \
$(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \
fi)
EXTRA_DIST = \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE)-sections.txt \
gdk-overrides.txt \
gdk-decl.txt
#
# Require gtk-doc when making dist
#
if ENABLE_GTK_DOC
dist-check-gtkdoc:
else
dist-check-gtkdoc:
@echo "*** gtk-doc must be installed and enabled in order to make dist
@false
endif
dist-hook:
dist-hook: dist-check-gtkdoc
mkdir $(distdir)/html
mkdir $(distdir)/sgml
mkdir $(distdir)/tmpl
cp -p tmpl/*.sgml $(distdir)/tmpl
-cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
-cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml
.PHONY : html sgml templates scan

5520
docs/reference/gdk/gdk-decl.txt
View File

File diff suppressed because it is too large Load Diff

14
docs/reference/gdk/gdk-docs.sgml
View File

@ -3,6 +3,7 @@
<!entity gdk-Bitmaps-and-Pixmaps SYSTEM "sgml/pixmaps.sgml">
<!entity gdk-Images SYSTEM "sgml/images.sgml">
<!entity gdk-GdkRGB SYSTEM "sgml/rgb.sgml">
<!entity gdk-Pixbufs SYSTEM "sgml/pixbufs.sgml">
<!entity gdk-Colormaps-and-Colors SYSTEM "sgml/colors.sgml">
<!entity gdk-Fonts SYSTEM "sgml/fonts.sgml">
<!entity gdk-Drawing-Primitives SYSTEM "sgml/drawing.sgml">
@ -13,6 +14,7 @@
<!entity gdk-Properties-and-Atoms SYSTEM "sgml/properties.sgml">
<!entity gdk-Input-Methods SYSTEM "sgml/input_methods.sgml">
<!entity gdk-Input-Contexts SYSTEM "sgml/input_contexts.sgml">
<!entity gdk-Pango-Interaction SYSTEM "sgml/pango_interaction.sgml">
<!entity gdk-Color-Contexts SYSTEM "sgml/color_contexts.sgml">
<!entity gdk-Points-Rectangles-and-Regions SYSTEM "sgml/regions.sgml">
<!entity gdk-Threads SYSTEM "sgml/threads.sgml">
@ -23,14 +25,16 @@
<!entity gdk-Cursors SYSTEM "sgml/cursors.sgml">
<!entity gdk-Input SYSTEM "sgml/input.sgml">
<!entity gdk-Drag-and-Drop SYSTEM "sgml/dnd.sgml">
<!entity gdk-X-Window-System-Interaction SYSTEM
"sgml/x_interaction.sgml">
]>
<book id="index">
<bookinfo>
<title>GDK Reference Manual</title>
</bookinfo>
<chapter id="gdk">
<title>GDK</title>
<reference id="reference">
<title>API Reference</title>
&gdk-General;
&gdk-Points-Rectangles-and-Regions;
@ -40,6 +44,7 @@
&gdk-Bitmaps-and-Pixmaps;
&gdk-GdkRGB;
&gdk-Images;
&gdk-Pixbufs;
&gdk-Colormaps-and-Colors;
&gdk-Color-Contexts;
@ -66,7 +71,10 @@
&gdk-Key-Values;
&gdk-Pango-Interaction;
&gdk-Input-Methods;
&gdk-Input-Contexts;
</chapter>
&gdk-X-Window-System-Interaction;
</reference>
</book>

28
docs/reference/gdk/gdk-overrides.txt
View File

@ -1,6 +1,13 @@
# GdkPixmap, GdkBitmap and GdkDrawable are the same as GdkWindow.
<STRUCT>
<NAME>GdkWindow</NAME>
struct GdkPixmap
{
gpointer user_data;
};
</STRUCT>
<STRUCT>
<NAME>GdkPixmap</NAME>
struct GdkPixmap
{
@ -21,3 +28,24 @@ struct GdkDrawable
gpointer user_data;
};
</STRUCT>
<MACRO>
<NAME>GDK_WINDOWING_X11</NAME>
#define GDK_WINDOWING_X11
</MACRO>
<MACRO>
<NAME>GDK_WINDOWING_WIN32</NAME>
#define GDK_WINDOWING_WIN32
</MACRO>
<MACRO>
<NAME>GDK_WINDOWING_NANOX</NAME>
#define GDK_WINDOWING_NANOX
</MACRO>
<MACRO>
<NAME>GDK_WINDOWING_FB</NAME>
#define GDK_WINDOWING_FB
</MACRO>

305
docs/reference/gdk/gdk-sections.txt
View File

@ -24,6 +24,7 @@ gdk_screen_height_mm
<SUBSECTION>
gdk_pointer_grab
GdkGrabStatus
gdk_pointer_ungrab
gdk_pointer_is_grabbed
@ -46,13 +47,15 @@ gdk_set_use_xshm
gdk_error_trap_push
gdk_error_trap_pop
<SUBSECTION>
GDK_WINDOWING_X11
GDK_WINDOWING_WIN32
GDK_WINDOWING_NANOX
GDK_WINDOWING_FB
<SUBSECTION Private>
GdkStatus
gdk_time_get
gdk_timer_get
gdk_timer_set
gdk_timer_enable
gdk_timer_disable
GDKVAR
</SECTION>
<SECTION>
@ -71,6 +74,20 @@ gdk_pixmap_unref
GdkBitmap
gdk_bitmap_ref
gdk_bitmap_unref
<SUBSECTION Standard>
GDK_PIXMAP
GDK_PIXMAP_GET_CLASS
GDK_PIXMAP_OBJECT
GDK_TYPE_PIXMAP
GDK_IS_PIXMAP
GDK_PIXMAP_CLASS
GDK_IS_PIXMAP_CLASS
<SUBSECTION Private>
gdk_pixmap_get_type
GdkPixmapObject
GdkPixmapObjectClass
</SECTION>
<SECTION>
@ -81,10 +98,24 @@ gdk_image_new
GdkImageType
gdk_image_new_bitmap
gdk_image_get
gdk_image_ref
gdk_image_unref
gdk_image_destroy
<SUBSECTION>
gdk_image_put_pixel
gdk_image_get_pixel
<SUBSECTION Standard>
GDK_IMAGE
GDK_TYPE_IMAGE
GDK_IS_IMAGE
GDK_IMAGE_CLASS
GDK_IMAGE_GET_CLASS
GDK_IS_IMAGE_CLASS
<SUBSECTION Private>
GdkImageClass
gdk_image_get_type
</SECTION>
<SECTION>
@ -98,6 +129,7 @@ gdk_draw_rgb_image_dithalign
gdk_draw_indexed_image
gdk_draw_gray_image
gdk_draw_rgb_32_image
gdk_draw_rgb_32_image_dithalign
GdkRgbDither
<SUBSECTION>
@ -109,16 +141,29 @@ GdkRgbCmap
gdk_rgb_gc_set_foreground
gdk_rgb_gc_set_background
gdk_rgb_xpixel_from_rgb
gdk_rgb_find_color
<SUBSECTION>
gdk_rgb_set_install
gdk_rgb_set_min_colors
gdk_rgb_get_visual
gdk_rgb_get_colormap
gdk_rgb_get_cmap
gdk_rgb_ditherable
gdk_rgb_set_verbose
</SECTION>
<SECTION>
<TITLE>Pixbufs</TITLE>
<FILE>pixbufs</FILE>
GdkPixbufAlphaMode
gdk_pixbuf_render_threshold_alpha
gdk_pixbuf_render_to_drawable
gdk_pixbuf_render_to_drawable_alpha
gdk_pixbuf_render_pixmap_and_mask
gdk_pixbuf_get_from_drawable
</SECTION>
<SECTION>
<TITLE>Colormaps and Colors</TITLE>
<FILE>colors</FILE>
@ -146,6 +191,18 @@ gdk_color_alloc
gdk_color_change
gdk_color_equal
gdk_color_hash
<SUBSECTION Standard>
GDK_COLORMAP
GDK_COLORMAP_GET_CLASS
GDK_TYPE_COLORMAP
GDK_IS_COLORMAP
GDK_COLORMAP_CLASS
GDK_IS_COLORMAP_CLASS
<SUBSECTION Private>
GdkColormapClass
gdk_colormap_get_type
</SECTION>
<SECTION>
@ -155,6 +212,7 @@ GdkFont
GdkFontType
gdk_font_load
gdk_fontset_load
gdk_font_from_description
gdk_font_ref
gdk_font_unref
gdk_font_id
@ -176,6 +234,10 @@ gdk_string_height
gdk_text_height
gdk_char_height
<SUBSECTION>
gdk_font_full_name_get
gdk_font_full_name_free
<SUBSECTION>
GdkWChar
gdk_wcstombs
@ -185,6 +247,19 @@ gdk_mbstowcs
<SECTION>
<TITLE>Drawing Primitives</TITLE>
<FILE>drawing</FILE>
GdkDrawable
GdkDrawableClass
gdk_drawable_ref
gdk_drawable_unref
gdk_drawable_set_data
gdk_drawable_get_data
gdk_drawable_get_visual
gdk_drawable_set_colormap
gdk_drawable_get_colormap
gdk_drawable_get_depth
gdk_drawable_get_size
<SUBSECTION>
gdk_draw_point
gdk_draw_points
gdk_draw_line
@ -194,6 +269,9 @@ GdkSegment
gdk_draw_rectangle
gdk_draw_arc
gdk_draw_polygon
gdk_draw_glyphs
gdk_draw_layout_line
gdk_draw_layout
<SUBSECTION>
gdk_draw_string
@ -202,8 +280,17 @@ gdk_draw_text_wc
<SUBSECTION>
gdk_draw_pixmap
gdk_draw_drawable
gdk_draw_image
<SUBSECTION Standard>
GDK_DRAWABLE
GDK_DRAWABLE_GET_CLASS
GDK_TYPE_DRAWABLE
GDK_IS_DRAWABLE
GDK_DRAWABLE_CLASS
GDK_IS_DRAWABLE_CLASS
<SUBSECTION Private>
gdk_draw_bitmap
</SECTION>
@ -212,6 +299,7 @@ gdk_draw_bitmap
<TITLE>Graphics Contexts</TITLE>
<FILE>gcs</FILE>
GdkGC
GdkGCClass
GdkGCValues
GdkGCValuesMask
@ -222,9 +310,12 @@ gdk_gc_new_with_values
gdk_gc_ref
gdk_gc_unref
gdk_gc_destroy
gdk_gc_set_values
gdk_gc_get_values
gdk_gc_set_foreground
gdk_gc_set_background
gdk_gc_set_rgb_fg_color
gdk_gc_set_rgb_bg_color
gdk_gc_set_font
gdk_gc_set_function
gdk_gc_set_fill
@ -245,6 +336,17 @@ GdkCapStyle
GdkJoinStyle
gdk_gc_set_dashes
gdk_gc_copy
gdk_gc_set_colormap
gdk_gc_get_colormap
<SUBSECTION Standard>
GDK_GC
GDK_TYPE_GC
GDK_IS_GC
gdk_gc_get_type
GDK_GC_CLASS
GDK_GC_GET_CLASS
GDK_IS_GC_CLASS
</SECTION>
<SECTION>
@ -283,6 +385,7 @@ gdk_window_new
gdk_window_destroy
gdk_window_ref
gdk_window_unref
gdk_window_get_window_type
gdk_window_at_pointer
gdk_window_show
gdk_window_hide
@ -292,6 +395,7 @@ gdk_window_withdraw
gdk_window_move
gdk_window_resize
gdk_window_move_resize
gdk_window_scroll
gdk_window_reparent
gdk_window_clear
gdk_window_clear_area
@ -300,6 +404,22 @@ gdk_window_copy_area
gdk_window_raise
gdk_window_lower
gdk_window_register_dnd
<SUBSECTION>
gdk_window_begin_paint_rect
gdk_window_begin_paint_region
gdk_window_end_paint
<SUBSECTION>
gdk_window_invalidate_rect
gdk_window_invalidate_region
gdk_window_get_update_area
gdk_window_freeze_updates
gdk_window_thaw_updates
gdk_window_process_all_updates
gdk_window_process_updates
<SUBSECTION>
gdk_window_set_user_data
gdk_window_set_override_redirect
gdk_window_add_filter
@ -334,6 +454,7 @@ GdkModifierType
gdk_window_get_parent
gdk_window_get_toplevel
gdk_window_get_children
gdk_window_peek_children
gdk_window_get_events
gdk_window_set_events
gdk_window_set_icon
@ -346,8 +467,21 @@ GdkWMDecoration
gdk_window_set_functions
GdkWMFunction
gdk_window_get_toplevels
GdkDrawable
gdk_drawable_set_data
<SUBSECTION Standard>
GDK_WINDOW
GDK_WINDOW_GET_CLASS
GDK_WINDOW_OBJECT
GDK_TYPE_WINDOW
GDK_IS_WINDOW
GDK_WINDOW_CLASS
GDK_IS_WINDOW_CLASS
<SUBSECTION Private>
gdk_window_object_get_type
gdk_drawable_get_type
GdkWindowObject
GdkWindowObjectClass
</SECTION>
<SECTION>
@ -391,6 +525,19 @@ gdk_im_set_best_style
<SUBSECTION>
gdk_im_begin
gdk_im_end
<SUBSECTION Private>
gdk_iswalnum
gdk_iswspace
GDK_HAVE_WCHAR_H
GDK_HAVE_WCTYPE_H
</SECTION>
<SECTION>
<TITLE>Pango Interaction</TITLE>
<FILE>pango_interaction</FILE>
gdk_pango_context_get
gdk_pango_context_set_colormap
</SECTION>
<SECTION>
@ -448,34 +595,36 @@ GdkRegion
gdk_region_new
gdk_region_polygon
GdkFillRule
gdk_region_copy
gdk_region_rectangle
gdk_region_destroy
<SUBSECTION>
gdk_regions_intersect
gdk_regions_union
gdk_regions_subtract
gdk_regions_xor
gdk_region_union_with_rect
gdk_region_offset
gdk_region_shrink
<SUBSECTION>
gdk_region_get_clipbox
gdk_region_empty
gdk_region_equal
gdk_region_point_in
gdk_region_rect_in
GdkOverlapType
gdk_region_get_clipbox
<SUBSECTION>
gdk_region_offset
gdk_region_shrink
gdk_region_union_with_rect
gdk_region_intersect
gdk_region_union
gdk_region_subtract
gdk_region_xor
</SECTION>
<SECTION>
<TITLE>Threads</TITLE>
<FILE>threads</FILE>
gdk_threads_mutex
GDK_THREADS_ENTER
GDK_THREADS_LEAVE
gdk_threads_enter
gdk_threads_leave
gdk_threads_mutex
</SECTION>
<SECTION>
@ -489,33 +638,44 @@ gdk_keyval_is_upper
gdk_keyval_is_lower
<SUBSECTION>
gdk_keyval_convert_case
gdk_keyval_to_upper
gdk_keyval_to_lower
<SUBSECTION>
gdk_keyval_to_unicode
gdk_unicode_to_keyval
</SECTION>
<SECTION>
<TITLE>Input Devices</TITLE>
<FILE>input_devices</FILE>
GDK_CORE_POINTER
gdk_input_list_devices
GdkDeviceInfo
GdkDevice
GdkInputSource
GdkInputMode
GdkDeviceKey
GdkDeviceAxis
GdkAxisUse
gdk_devices_list
gdk_core_pointer
gdk_device_set_source
gdk_device_set_mode
gdk_device_set_key
gdk_device_set_axis_use
<SUBSECTION>
gdk_device_get_state
gdk_device_get_history
gdk_device_free_history
GdkTimeCoord
gdk_device_get_axis
<SUBSECTION>
gdk_input_set_extension_events
GdkExtensionMode
gdk_input_set_source
GdkInputSource
gdk_input_set_mode
GdkInputMode
gdk_input_set_axes
GdkAxisUse
gdk_input_set_key
gdk_input_window_get_pointer
gdk_input_motion_events
GdkTimeCoord
<SUBSECTION Private>
gdk_input_init
gdk_input_exit
GDK_MAX_TIMECOORD_AXES
</SECTION>
<SECTION>
@ -525,6 +685,8 @@ GdkEventType
GdkEventMask
GDK_CURRENT_TIME
GDK_PRIORITY_EVENTS
GDK_PRIORITY_REDRAW
<SUBSECTION>
gdk_events_pending
@ -535,6 +697,7 @@ gdk_event_put
gdk_event_copy
gdk_event_free
gdk_event_get_time
gdk_event_get_axis
<SUBSECTION>
gdk_event_handler_set
@ -559,6 +722,7 @@ GdkEvent
GdkEventAny
GdkEventKey
GdkEventButton
GdkEventScroll
GdkEventMotion
GdkEventExpose
GdkEventVisibility
@ -567,12 +731,14 @@ GdkEventFocus
GdkEventConfigure
GdkEventProperty
GdkEventSelection
GdkNativeWindow
GdkEventDND
GdkEventProximity
GdkEventClient
GdkEventNoExpose
<SUBSECTION>
GdkScrollDirection
GdkVisibilityState
GdkCrossingMode
GdkNotifyType
@ -586,6 +752,8 @@ GdkCursor
GdkCursorType
gdk_cursor_new
gdk_cursor_new_from_pixmap
gdk_cursor_ref
gdk_cursor_unref
gdk_cursor_destroy
</SECTION>
@ -619,4 +787,75 @@ gdk_drag_context_unref
GdkDragContext
GdkDragAction
gdk_drag_status
<SUBSECTION Standard>
GDK_DRAG_CONTEXT
GDK_TYPE_DRAG_CONTEXT
GDK_IS_DRAG_CONTEXT
GDK_DRAG_CONTEXT_CLASS
GDK_DRAG_CONTEXT_GET_CLASS
GDK_IS_DRAG_CONTEXT_CLASS
<SUBSECTION Private>
GdkDragContextClass
gdk_drag_context_get_type
</SECTION>
<SECTION>
<TITLE>X Window System Interaction</TITLE>
<FILE>x_interaction</FILE>
GDK_GC_X11
GDK_GC_X11_GET_CLASS
GDK_ROOT_WINDOW
GDK_ROOT_PARENT
GDK_DISPLAY
GDK_WINDOW_XDISPLAY
GDK_WINDOW_XID
GDK_PIXMAP_XDISPLAY
GDK_PIXMAP_XID
GDK_DRAWABLE_XDISPLAY
GDK_DRAWABLE_XID
GDK_IMAGE_XDISPLAY
GDK_IMAGE_XIMAGE
GDK_GC_XDISPLAY
GDK_COLORMAP_XDISPLAY
GDK_COLORMAP_XCOLORMAP
GDK_VISUAL_XVISUAL
GDK_FONT_XDISPLAY
GDK_FONT_XFONT
GDK_GC_XGC
GDK_GC_GET_XGC
GDK_WINDOW_XWINDOW
gdk_screen
gdk_display_name
gdk_leader_window
gdk_selection_property
gdk_progclass
gdkx_visual_get
gdkx_colormap_get
gdk_get_client_window
gdk_pixmap_foreign_new
gdk_window_foreign_new
gdk_xid_table_lookup
gdk_window_lookup
gdk_pixmap_lookup
gdk_font_lookup
<SUBSECTION Private>
GDK_TYPE_GC_X11
GDK_IS_GC_X11
gdk_gc_x11_get_type
GDK_GC_X11_CLASS
GDK_IS_GC_X11_CLASS
GdkGCX11
GdkGCX11Class
GdkGCXData
GdkColormapPrivateX11
GdkCursorPrivate
GdkFontPrivateX
GdkImagePrivateX11
GdkVisualPrivate
GdkICPrivate
gdk_display
gdk_root_window
</SECTION>

4
docs/reference/gdk/tmpl/colors.sgml
View File

@ -109,6 +109,7 @@ pseudo-color colormaps.</entry>
</tbody></tgroup></informaltable>
</para>
@parent_instance:
@size:
@colors:
@ -384,7 +385,8 @@ table that stores #GdkColor's.
</para>
@colora: a #GdkColor.
@colorb: NOT USED.
@Returns: The hash function appled to @colora
<!-- # Unused Parameters # -->
@colorb: NOT USED.

21
docs/reference/gdk/tmpl/cursors.sgml
View File

@ -20,6 +20,7 @@ standard and pixmap cursors.
</para>
@type:
@ref_count:
<!-- ##### ENUM GdkCursorType ##### -->
<para>
@ -89,11 +90,29 @@ The color does not have to be allocated first.
@Returns: a new #GdkCursor.
<!-- ##### FUNCTION gdk_cursor_destroy ##### -->
<!-- ##### FUNCTION gdk_cursor_ref ##### -->
<para>
</para>
@cursor:
@Returns:
<!-- ##### FUNCTION gdk_cursor_unref ##### -->
<para>
</para>
@cursor:
<!-- ##### MACRO gdk_cursor_destroy ##### -->
<para>
Destroys a cursor, freeing any resources allocated for it.
</para>
<!-- # Unused Parameters # -->
@cursor: a #GdkCursor.

4
docs/reference/gdk/tmpl/dnd.sgml
View File

@ -146,6 +146,9 @@ the GTK+ documentation for more information.
@GDK_DRAG_PROTO_XDND:
@GDK_DRAG_PROTO_ROOTWIN:
@GDK_DRAG_PROTO_NONE:
@GDK_DRAG_PROTO_WIN32_DROPFILES:
@GDK_DRAG_PROTO_OLE2:
@GDK_DRAG_PROTO_LOCAL:
<!-- ##### FUNCTION gdk_drag_context_unref ##### -->
<para>
@ -160,6 +163,7 @@ the GTK+ documentation for more information.
</para>
@parent_instance:
@protocol:
@is_source:
@source_window:

153
docs/reference/gdk/tmpl/drawing.sgml
View File

@ -25,6 +25,103 @@ more information.
</para>
<!-- ##### STRUCT GdkDrawable ##### -->
<para>
</para>
@user_data:
<!-- ##### STRUCT GdkDrawableClass ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_drawable_ref ##### -->
<para>
</para>
@drawable:
@Returns:
<!-- ##### FUNCTION gdk_drawable_unref ##### -->
<para>
</para>
@drawable:
<!-- ##### FUNCTION gdk_drawable_set_data ##### -->
<para>
</para>
@drawable:
@key:
@data:
@destroy_func:
<!-- ##### FUNCTION gdk_drawable_get_data ##### -->
<para>
</para>
@drawable:
@key:
@Returns:
<!-- ##### FUNCTION gdk_drawable_get_visual ##### -->
<para>
</para>
@drawable:
@Returns:
<!-- ##### FUNCTION gdk_drawable_set_colormap ##### -->
<para>
</para>
@drawable:
@colormap:
<!-- ##### FUNCTION gdk_drawable_get_colormap ##### -->
<para>
</para>
@drawable:
@Returns:
<!-- ##### FUNCTION gdk_drawable_get_depth ##### -->
<para>
</para>
@drawable:
@Returns:
<!-- ##### FUNCTION gdk_drawable_get_size ##### -->
<para>
</para>
@drawable:
@width:
@height:
<!-- ##### FUNCTION gdk_draw_point ##### -->
<para>
Draws a point, using the foreground color and other attributes of the #GdkGC.
@ -157,6 +254,43 @@ polygon.
@npoints: the number of points.
<!-- ##### FUNCTION gdk_draw_glyphs ##### -->
<para>
</para>
@drawable:
@gc:
@font:
@x:
@y:
@glyphs:
<!-- ##### FUNCTION gdk_draw_layout_line ##### -->
<para>
</para>
@drawable:
@gc:
@x:
@y:
@line:
<!-- ##### FUNCTION gdk_draw_layout ##### -->
<para>
</para>
@drawable:
@gc:
@x:
@y:
@layout:
<!-- ##### FUNCTION gdk_draw_string ##### -->
<para>
Draws a string of characters in the given font or fontset.
@ -200,11 +334,12 @@ If the font is a 1-byte font, the string is converted into 1-byte characters
@text_length: the number of characters to draw.
<!-- ##### FUNCTION gdk_draw_pixmap ##### -->
<!-- ##### MACRO gdk_draw_pixmap ##### -->
<para>
Draws a pixmap, or a part of a pixmap, onto another drawable.
</para>
<!-- # Unused Parameters # -->
@drawable: a #GdkDrawable (a #GdkWindow or a #GdkPixmap).
@gc: a #GdkGC.
@src: the source #GdkPixmap to draw.
@ -218,6 +353,22 @@ the right edge of the source pixmap.
to the bottom edge of the source pixmap.
<!-- ##### FUNCTION gdk_draw_drawable ##### -->
<para>
</para>
@drawable:
@gc:
@src:
@xsrc:
@ysrc:
@xdest:
@ydest:
@width:
@height:
<!-- ##### FUNCTION gdk_draw_image ##### -->
<para>
Draws a #GdkImage onto a drawable.

130
docs/reference/gdk/tmpl/event_structs.sgml
View File

@ -143,22 +143,34 @@ must also occur within 1/2 second of the first button press.
@time: the time of the event in milliseconds.
@x: the x coordinate of the mouse relative to the window.
@y: the y coordinate of the mouse relative to the window.
@pressure: the pressure of the button press, intended for input devices such
as graphics tablets. It defaults to 0.5.
@xtilt: the horizontal tilt of the input device. Defaults to 0.
@ytilt: the vertical tilt of the input device. Defaults to 0.
@axes:
@state: a bit-mask representing the state of the modifier keys (e.g. Control,
Shift and Alt) and the pointer buttons. See #GdkModifierType.
@button: the button which was pressed or released, numbered from 1 to 5.
Normally button 1 is the left mouse button, 2 is the middle button,
and 3 is the right button. On 2-button mice, the middle button can often
be simulated by pressing both mouse buttons together.
@source: the input device where the event came from, usually %GDK_SOURCE_MOUSE.
@deviceid: the input device ID, usually %GDK_CORE_POINTER but may be
different if touch screens or graphics tablets are being used.
@device:
@x_root: the x coordinate of the mouse relative to the root of the screen.
@y_root: the y coordinate of the mouse relative to the root of the screen.
<!-- ##### STRUCT GdkEventScroll ##### -->
<para>
</para>
@type:
@window:
@send_event:
@time:
@x:
@y:
@state:
@direction:
@device:
@x_root:
@y_root:
<!-- ##### STRUCT GdkEventMotion ##### -->
<para>
@ -170,13 +182,10 @@ different if touch screens or graphics tablets are being used.
@time:
@x:
@y:
@pressure:
@xtilt:
@ytilt:
@axes:
@state:
@is_hint:
@source:
@deviceid:
@device:
@x_root:
@y_root:
@ -206,15 +215,6 @@ Generated when the window visibility status has changed.
@state: the new visibility state (%GDK_VISIBILITY_FULLY_OBSCURED,
%GDK_VISIBILITY_PARTIAL or %GDK_VISIBILITY_UNOBSCURED).
<!-- ##### ENUM GdkVisibilityState ##### -->
<para>
Specifies the visiblity status of a window for a #GdkEventVisibility.
</para>
@GDK_VISIBILITY_UNOBSCURED: the window is completely visible.
@GDK_VISIBILITY_PARTIAL: the window is partially visible.
@GDK_VISIBILITY_FULLY_OBSCURED: the window is not visible at all.
<!-- ##### STRUCT GdkEventCrossing ##### -->
<para>
@ -234,27 +234,6 @@ Specifies the visiblity status of a window for a #GdkEventVisibility.
@focus:
@state:
<!-- ##### ENUM GdkCrossingMode ##### -->
<para>
</para>
@GDK_CROSSING_NORMAL:
@GDK_CROSSING_GRAB:
@GDK_CROSSING_UNGRAB:
<!-- ##### ENUM GdkNotifyType ##### -->
<para>
</para>
@GDK_NOTIFY_ANCESTOR:
@GDK_NOTIFY_VIRTUAL:
@GDK_NOTIFY_INFERIOR:
@GDK_NOTIFY_NONLINEAR:
@GDK_NOTIFY_NONLINEAR_VIRTUAL:
@GDK_NOTIFY_UNKNOWN:
<!-- ##### STRUCT GdkEventFocus ##### -->
<para>
Describes a change of keyboard focus.
@ -292,14 +271,6 @@ Describes a property change on a window.
@state: whether the property was changed (%GDK_PROPERTY_NEW_VALUE) or
deleted (%GDK_PROPERTY_DELETE).
<!-- ##### ENUM GdkPropertyState ##### -->
<para>
Specifies the type of a property change for a #GdkEventProperty.
</para>
@GDK_PROPERTY_NEW_VALUE: the property value wan changed.
@GDK_PROPERTY_DELETE: the property was deleted.
<!-- ##### STRUCT GdkEventSelection ##### -->
<para>
@ -311,8 +282,14 @@ Specifies the type of a property change for a #GdkEventProperty.
@selection:
@target:
@property:
@requestor:
@time: the time of the event in milliseconds.
@requestor:
<!-- ##### TYPEDEF GdkNativeWindow ##### -->
<para>
</para>
<!-- ##### STRUCT GdkEventDND ##### -->
<para>
@ -336,8 +313,7 @@ Specifies the type of a property change for a #GdkEventProperty.
@window: the window which received the event.
@send_event: TRUE if the event was sent explicitly (e.g. using XSendEvent).
@time: the time of the event in milliseconds.
@source:
@deviceid:
@device:
<!-- ##### STRUCT GdkEventClient ##### -->
<para>
@ -366,3 +342,51 @@ FIXME: add more here.
@window: the window which received the event.
@send_event: TRUE if the event was sent explicitly (e.g. using XSendEvent).
<!-- ##### ENUM GdkScrollDirection ##### -->
<para>
</para>
@GDK_SCROLL_UP:
@GDK_SCROLL_DOWN:
@GDK_SCROLL_LEFT:
@GDK_SCROLL_RIGHT:
<!-- ##### ENUM GdkVisibilityState ##### -->
<para>
Specifies the visiblity status of a window for a #GdkEventVisibility.
</para>
@GDK_VISIBILITY_UNOBSCURED: the window is completely visible.
@GDK_VISIBILITY_PARTIAL: the window is partially visible.
@GDK_VISIBILITY_FULLY_OBSCURED: the window is not visible at all.
<!-- ##### ENUM GdkCrossingMode ##### -->
<para>
</para>
@GDK_CROSSING_NORMAL:
@GDK_CROSSING_GRAB:
@GDK_CROSSING_UNGRAB:
<!-- ##### ENUM GdkNotifyType ##### -->
<para>
</para>
@GDK_NOTIFY_ANCESTOR:
@GDK_NOTIFY_VIRTUAL:
@GDK_NOTIFY_INFERIOR:
@GDK_NOTIFY_NONLINEAR:
@GDK_NOTIFY_NONLINEAR_VIRTUAL:
@GDK_NOTIFY_UNKNOWN:
<!-- ##### ENUM GdkPropertyState ##### -->
<para>
Specifies the type of a property change for a #GdkEventProperty.
</para>
@GDK_PROPERTY_NEW_VALUE: the property value wan changed.
@GDK_PROPERTY_DELETE: the property was deleted.

20
docs/reference/gdk/tmpl/events.sgml
View File

@ -81,6 +81,7 @@ has changed.
@GDK_VISIBILITY_NOTIFY: the window visibility status has changed.
@GDK_NO_EXPOSE: indicates that the source region was completely available
when parts of a drawable were copied. This is not very useful.
@GDK_SCROLL:
<!-- ##### ENUM GdkEventMask ##### -->
<para>
@ -118,6 +119,7 @@ events when the application asks for them, by calling gdk_window_get_pointer().
@GDK_PROXIMITY_IN_MASK:
@GDK_PROXIMITY_OUT_MASK:
@GDK_SUBSTRUCTURE_MASK:
@GDK_SCROLL_MASK:
@GDK_ALL_EVENTS_MASK: the combination of all the above event masks.
<!-- ##### MACRO GDK_CURRENT_TIME ##### -->
@ -135,6 +137,13 @@ This is the priority that events from the X server are given in the
<!-- ##### MACRO GDK_PRIORITY_REDRAW ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_events_pending ##### -->
<para>
Checks if any events are waiting to be processed.
@ -217,6 +226,17 @@ Gets the timestamp from a #GdkEvent.
no timestamp.
<!-- ##### FUNCTION gdk_event_get_axis ##### -->
<para>
</para>
@event:
@axis_use:
@value:
@Returns:
<!-- ##### FUNCTION gdk_event_handler_set ##### -->
<para>
Sets the function to call to handle all events from GDK.

26
docs/reference/gdk/tmpl/fonts.sgml
View File

@ -356,6 +356,15 @@ assumptions about the initial reference count.
@Returns: a #GdkFont, or NULL if the fontset could not be loaded.
<!-- ##### FUNCTION gdk_font_from_description ##### -->
<para>
</para>
@font_desc:
@Returns:
<!-- ##### FUNCTION gdk_font_ref ##### -->
<para>
Increase the reference count of a count by one.
@ -579,6 +588,23 @@ relation to the baseline. See gdk_text_extents().
@Returns: the height of the character in pixels.
<!-- ##### FUNCTION gdk_font_full_name_get ##### -->
<para>
</para>
@font:
@Returns:
<!-- ##### FUNCTION gdk_font_full_name_free ##### -->
<para>
</para>
@name:
<!-- ##### TYPEDEF GdkWChar ##### -->
<para>
Specifies a wide character type, used to represent character codes.

73
docs/reference/gdk/tmpl/gcs.sgml
View File

@ -37,7 +37,18 @@ It is an opaque structure with no user-visible
elements.
</para>
@dummy_var:
@parent_instance:
@clip_x_origin:
@clip_y_origin:
@ts_x_origin:
@ts_y_origin:
@colormap:
<!-- ##### STRUCT GdkGCClass ##### -->
<para>
</para>
<!-- ##### STRUCT GdkGCValues ##### -->
<para>
@ -209,6 +220,7 @@ useful. For bitmaps, %GDK_AND and %GDK_OR are also useful.
@GDK_COPY_INVERT:
@GDK_OR_INVERT:
@GDK_NAND:
@GDK_NOR:
@GDK_SET:
<!-- ##### FUNCTION gdk_gc_new ##### -->
@ -216,9 +228,11 @@ useful. For bitmaps, %GDK_AND and %GDK_OR are also useful.
Create a new graphics context with default values.
</para>
@drawable:
@Returns: the new graphics context.
<!-- # Unused Parameters # -->
@window: a #GdkDrawable. The created GC must always be used
with drawables of the same depth as this one.
@Returns: the new graphics context.
<!-- ##### FUNCTION gdk_gc_new_with_values ##### -->
@ -226,12 +240,14 @@ Create a new graphics context with default values.
Create a new GC with the given initial values.
</para>
@window: a #GdkDrawable. The created GC must always be used
with drawables of the same depth as this one.
@drawable:
@values: a structure containing initial values for the GC.
@values_mask: a bit mask indicating which fields in @values
are set.
@Returns: the new graphics context.
<!-- # Unused Parameters # -->
@window: a #GdkDrawable. The created GC must always be used
with drawables of the same depth as this one.
<!-- ##### FUNCTION gdk_gc_ref ##### -->
@ -253,15 +269,26 @@ context will be destroyed.
@gc: a #GdkGC.
<!-- ##### FUNCTION gdk_gc_destroy ##### -->
<!-- ##### MACRO gdk_gc_destroy ##### -->
<para>
Identical to gdk_gc_unref(). This function is obsolete
and should not be used.
</para>
<!-- # Unused Parameters # -->
@gc: a #GdkGC.
<!-- ##### FUNCTION gdk_gc_set_values ##### -->
<para>
</para>
@gc:
@values:
@values_mask:
<!-- ##### FUNCTION gdk_gc_get_values ##### -->
<para>
Retrieves the current values from a graphics context.
@ -289,6 +316,24 @@ Sets the background color for a graphics context.
@color: the new background color.
<!-- ##### FUNCTION gdk_gc_set_rgb_fg_color ##### -->
<para>
</para>
@gc:
@color:
<!-- ##### FUNCTION gdk_gc_set_rgb_bg_color ##### -->
<para>
</para>
@gc:
@color:
<!-- ##### FUNCTION gdk_gc_set_font ##### -->
<para>
Sets the font for a graphics context. (Note that
@ -637,3 +682,21 @@ onto another graphics context.
@src_gc: the source graphics context.
<!-- ##### FUNCTION gdk_gc_set_colormap ##### -->
<para>
</para>
@gc:
@colormap:
<!-- ##### FUNCTION gdk_gc_get_colormap ##### -->
<para>
</para>
@gc:
@Returns:

195
docs/reference/gdk/tmpl/gdk-unused.sgml
View File

@ -0,0 +1,195 @@
<!-- ##### SECTION ./tmpl/gdkregion.sgml:See_Also ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_regions_xor ##### -->
<para>
Returns the difference between the union and the intersection of two regions.
This is a region containing the pixels that are in one of the source regions,
but which are not in both.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion.
@Returns: the difference between the union and the intersection of @source1
and @source2.
<!-- ##### FUNCTION gdk_input_motion_events ##### -->
<para>
Retrieves the motion history for a given device/window pair.
</para>
@window: a #GdkWindow.
@deviceid: the device for which to retrieve motion history.
@start: the start time.
@stop: the stop time.
@nevents_return: location to store the number of events returned.
@Returns: a newly allocated array containing all the events
from @start to @stop. This array should be freed
with g_free() when you are finished using it.
<!-- ##### SECTION ./tmpl/gdkregion.sgml:Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:Short_Description ##### -->
<!-- ##### STRUCT GdkDeviceInfo ##### -->
<para>
The #GdkDeviceInfo structure contains information about a
device. It has the following fields:
</para>
@deviceid: a unique integer ID for this device.
@name: the human-readable name for the device.
@source: the type of device.
@mode: a value indicating whether the device is enabled and
how the device coordinates map to the screen.
@has_cursor: if %TRUE, a cursor will be displayed indicating
the current on-screen location to the user. Otherwise,
the application is responsible for drawing a cursor
itself.
@num_axes: the number of axes for this device.
@axes: a pointer to an array of GdkAxisUse values which
give the mapping of axes onto the possible valuators
for a GDK device.
@num_keys: the number of macro buttons.
@keys: a pointer to an array of #GdkDeviceKey structures
which describe what key press events are generated
for each macro button.
<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:Title ##### -->
Pango Interaction
<!-- ##### FUNCTION gdk_regions_union ##### -->
<para>
Returns the union of two regions.
This is all pixels in either of @source1 or @source2.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion.
@Returns: the union of @source1 and @source2.
<!-- ##### SECTION ./tmpl/gdkregion.sgml:Short_Description ##### -->
<!-- ##### FUNCTION gdk_input_set_key ##### -->
<para>
Sets the key event generated when a macro button is pressed.
</para>
@deviceid: the device to configure.
@index: the index of the macro button.
@keyval: the key value for the #GdkKeypressEvent to generate.
(a value of 0 means no event will be generated.)
@modifiers: the modifier field for the generated
#GdkKeyPressEvent.
<!-- ##### FUNCTION gdk_input_list_devices ##### -->
<para>
Lists all available input devices, along with their
configuration information.
</para>
@Returns: A #GList of #GdkDeviceInfo structures. This list
is internal data of GTK+ and should not be modified
or freed.
<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:See_Also ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_regions_subtract ##### -->
<para>
Subtracts one region from another.
The result is a region containing all the pixels which are in @source1, but
which are not in @source2.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion to subtract from @source1.
@Returns: @source1 - @source2.
<!-- ##### FUNCTION gdk_input_window_get_pointer ##### -->
<para>
Returns information about the current position of the pointer
within a window, including extended device information.
Any of the return parameters may be %NULL, in which case,
they will be ignored.
</para>
@window: a #GdkWindow.
@deviceid: a device ID.
@x: location to store current x postion.
@y: location to store current y postion.
@pressure: location to store current pressure.
@xtilt: location to store current tilt in the x direction.
@ytilt: location to store current tilt in the y direction.
@mask: location to store the current modifier state.
<!-- ##### MACRO GDK_CORE_POINTER ##### -->
<para>
This macro contains an integer value representing
the device ID for the core pointer device.
</para>
<!-- ##### FUNCTION gdk_input_set_axes ##### -->
<para>
Sets the mapping of the axes (valuators) of a device
onto the predefined valuator types that GTK+ understands.
</para>
@deviceid: the device to configure.
@axes: an array of GdkAxisUse. This length of this array
must match the number of axes for the device.
<!-- ##### FUNCTION gdk_input_set_source ##### -->
<para>
Sets the source type for a device.
</para>
@deviceid: the device to configure
@source: the new source type.
<!-- ##### SECTION ./tmpl/gdkregion.sgml:Title ##### -->
Points, Rectangles and Regions
<!-- ##### FUNCTION gdk_regions_intersect ##### -->
<para>
Returns the intersection of two regions.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion.
@Returns: the intersection of @source1 and @source2.
<!-- ##### FUNCTION gdk_input_set_mode ##### -->
<para>
Enables or disables a device, and determines how the
device maps onto the screen.
</para>
@deviceid: the device to configure.
@mode: the new mode.
@Returns: %TRUE if the device supports the given mode, otherwise
%FALSE and the device's mode is unchanged.
<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:Long_Description ##### -->
<para>
</para>

39
docs/reference/gdk/tmpl/general.sgml
View File

@ -212,6 +212,17 @@ the time isn't known.
@Returns: 0 if the grab was successful.
<!-- ##### ENUM GdkGrabStatus ##### -->
<para>
</para>
@GDK_GRAB_SUCCESS:
@GDK_GRAB_ALREADY_GRABBED:
@GDK_GRAB_INVALID_TIME:
@GDK_GRAB_NOT_VIEWABLE:
@GDK_GRAB_FROZEN:
<!-- ##### FUNCTION gdk_pointer_ungrab ##### -->
<para>
Ungrabs the pointer, if it is grabbed by this application.
@ -345,3 +356,31 @@ Removes the X error trap installed with gdk_error_trap_push().
@Returns: the X error code, or 0 if no error occurred.
<!-- ##### MACRO GDK_WINDOWING_X11 ##### -->
<para>
</para>
<!-- ##### MACRO GDK_WINDOWING_WIN32 ##### -->
<para>
</para>
<!-- ##### MACRO GDK_WINDOWING_NANOX ##### -->
<para>
</para>
<!-- ##### MACRO GDK_WINDOWING_FB ##### -->
<para>
</para>

26
docs/reference/gdk/tmpl/images.sgml
View File

@ -60,6 +60,7 @@ displays.
The #GdkImage struct contains information on the image and the pixel data.
</para>
@parent_instance:
@type: the type of the image.
@visual: the visual.
@byte_order: the byte order.
@ -69,6 +70,7 @@ The #GdkImage struct contains information on the image and the pixel data.
@bpp: the number of bytes per pixel.
@bpl: the number of bytes per line of the image.
@mem: the pixel data.
@windowing_data:
<!-- ##### FUNCTION gdk_image_new ##### -->
<para>
@ -116,19 +118,39 @@ Creates a new #GdkImage with a depth of 1 from the given data.
Gets part of a #GdkWindow and stores it in a new #GdkImage.
</para>
@window: the #GdkWindow to copy from.
@drawable:
@x: the left edge of the rectangle to copy from @window.
@y: the top edge of the rectangle to copy from @window.
@width: the width of the area to copy, in pixels.
@height: the height of the area to copy, in pixels.
@Returns: a new #GdkImage with a copy of the given area of @window.
<!-- # Unused Parameters # -->
@window: the #GdkWindow to copy from.
<!-- ##### FUNCTION gdk_image_destroy ##### -->
<!-- ##### FUNCTION gdk_image_ref ##### -->
<para>
</para>
@image:
@Returns:
<!-- ##### FUNCTION gdk_image_unref ##### -->
<para>
</para>
@image:
<!-- ##### MACRO gdk_image_destroy ##### -->
<para>
Destroys a #GdkImage, freeing any resources allocated for it.
</para>
<!-- # Unused Parameters # -->
@image: a #GdkImage.

325
docs/reference/gdk/tmpl/input_devices.sgml
View File

@ -91,48 +91,45 @@ sets of additional valuators than the pressure xtilt and ytilt.
</para>
<!-- ##### MACRO GDK_CORE_POINTER ##### -->
<!-- ##### STRUCT GdkDevice ##### -->
<para>
This macro contains an integer value representing
the device ID for the core pointer device.
</para>
@name:
@source:
@mode:
@has_cursor:
@num_axes:
@axes:
@num_keys:
@keys:
<!-- ##### FUNCTION gdk_input_list_devices ##### -->
<!-- ##### ENUM GdkInputSource ##### -->
<para>
Lists all available input devices, along with their
configuration information.
An enumeration describing the type of an input device
in general terms.
</para>
@Returns: A #GList of #GdkDeviceInfo structures. This list
is internal data of GTK+ and should not be modified
or freed.
@GDK_SOURCE_MOUSE: the device is a mouse. (This will be reported for the core
pointer, even if it is something else, such as a trackball.)
@GDK_SOURCE_PEN: the device is a stylus of a graphics tablet or similar device.
@GDK_SOURCE_ERASER: the device is an eraser. Typically, this would be the other end
of a stylus on a graphics tablet.
@GDK_SOURCE_CURSOR: the device is a graphics tablet "puck" or similar device.
<!-- ##### STRUCT GdkDeviceInfo ##### -->
<!-- ##### ENUM GdkInputMode ##### -->
<para>
The #GdkDeviceInfo structure contains information about a
device. It has the following fields:
An enumeration that describes the mode of an input device.
</para>
@deviceid: a unique integer ID for this device.
@name: the human-readable name for the device.
@source: the type of device.
@mode: a value indicating whether the device is enabled and
how the device coordinates map to the screen.
@has_cursor: if %TRUE, a cursor will be displayed indicating
the current on-screen location to the user. Otherwise,
the application is responsible for drawing a cursor
itself.
@num_axes: the number of axes for this device.
@axes: a pointer to an array of GdkAxisUse values which
give the mapping of axes onto the possible valuators
for a GDK device.
@num_keys: the number of macro buttons.
@keys: a pointer to an array of #GdkDeviceKey structures
which describe what key press events are generated
for each macro button.
@GDK_MODE_DISABLED: the device is disabled and will not report any events.
@GDK_MODE_SCREEN: the device is enabled. The device's coordinate space
maps to the entire screen.
@GDK_MODE_WINDOW: the device is enabled. The device's coordinate space
is mapped to a single window. The manner in which this window
is chosen is undefined, but it will typically be the same
way in which the focus window for key events is determined.
<!-- ##### STRUCT GdkDeviceKey ##### -->
<para>
@ -145,6 +142,140 @@ a normal X key event. It has the following fields:
If this is 0, no keypress will be generated.
@modifiers: the modifiers set for the generated key event.
<!-- ##### STRUCT GdkDeviceAxis ##### -->
<para>
</para>
@use:
@min:
@max:
<!-- ##### ENUM GdkAxisUse ##### -->
<para>
An enumeration describing the way in which a device
axis (valuator) maps onto the predefined valuator
types that GTK+ understands.
</para>
@GDK_AXIS_IGNORE: the axis is ignored.
@GDK_AXIS_X: the axis is used as the x axis.
@GDK_AXIS_Y: the axis is used as the y axis.
@GDK_AXIS_PRESSURE: the axis is used for pressure information.
@GDK_AXIS_XTILT: the axis is used for x tilt information.
@GDK_AXIS_YTILT: the axis is used for x tilt information.
@GDK_AXIS_WHEEL:
@GDK_AXIS_LAST: a constant equal to the numerically highest axis value.
<!-- ##### FUNCTION gdk_devices_list ##### -->
<para>
</para>
@Returns:
<!-- ##### VARIABLE gdk_core_pointer ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_device_set_source ##### -->
<para>
</para>
@device:
@source:
<!-- ##### FUNCTION gdk_device_set_mode ##### -->
<para>
</para>
@device:
@mode:
@Returns:
<!-- ##### FUNCTION gdk_device_set_key ##### -->
<para>
</para>
@device:
@index:
@keyval:
@modifiers:
<!-- ##### FUNCTION gdk_device_set_axis_use ##### -->
<para>
</para>
@device:
@index:
@use:
<!-- ##### FUNCTION gdk_device_get_state ##### -->
<para>
</para>
@device:
@window:
@axes:
@mask:
<!-- ##### FUNCTION gdk_device_get_history ##### -->
<para>
</para>
@device:
@window:
@start:
@stop:
@events:
@n_events:
@Returns:
<!-- ##### FUNCTION gdk_device_free_history ##### -->
<para>
</para>
@events:
@n_events:
<!-- ##### STRUCT GdkTimeCoord ##### -->
<para>
The #GdkTimeCoord structure stores a single event in a
motion history. It contains the following fields:
</para>
@time: The timestamp for this event.
@axes:
<!-- ##### FUNCTION gdk_device_get_axis ##### -->
<para>
</para>
@device:
@axes:
@use:
@value:
@Returns:
<!-- ##### FUNCTION gdk_input_set_extension_events ##### -->
<para>
Turns extension events on or off for a particular window,
@ -167,135 +298,3 @@ are desired for a particular widget.
@GDK_EXTENSION_EVENTS_CURSOR: extension events are desired only if a cursor
will be displayed for the device.
<!-- ##### FUNCTION gdk_input_set_source ##### -->
<para>
Sets the source type for a device.
</para>
@deviceid: the device to configure
@source: the new source type.
<!-- ##### ENUM GdkInputSource ##### -->
<para>
An enumeration describing the type of an input device
in general terms.
</para>
@GDK_SOURCE_MOUSE: the device is a mouse. (This will be reported for the core
pointer, even if it is something else, such as a trackball.)
@GDK_SOURCE_PEN: the device is a stylus of a graphics tablet or similar device.
@GDK_SOURCE_ERASER: the device is an eraser. Typically, this would be the other end
of a stylus on a graphics tablet.
@GDK_SOURCE_CURSOR: the device is a graphics tablet "puck" or similar device.
<!-- ##### FUNCTION gdk_input_set_mode ##### -->
<para>
Enables or disables a device, and determines how the
device maps onto the screen.
</para>
@deviceid: the device to configure.
@mode: the new mode.
@Returns: %TRUE if the device supports the given mode, otherwise
%FALSE and the device's mode is unchanged.
<!-- ##### ENUM GdkInputMode ##### -->
<para>
An enumeration that describes the mode of an input device.
</para>
@GDK_MODE_DISABLED: the device is disabled and will not report any events.
@GDK_MODE_SCREEN: the device is enabled. The device's coordinate space
maps to the entire screen.
@GDK_MODE_WINDOW: the device is enabled. The device's coordinate space
is mapped to a single window. The manner in which this window
is chosen is undefined, but it will typically be the same
way in which the focus window for key events is determined.
<!-- ##### FUNCTION gdk_input_set_axes ##### -->
<para>
Sets the mapping of the axes (valuators) of a device
onto the predefined valuator types that GTK+ understands.
</para>
@deviceid: the device to configure.
@axes: an array of GdkAxisUse. This length of this array
must match the number of axes for the device.
<!-- ##### ENUM GdkAxisUse ##### -->
<para>
An enumeration describing the way in which a device
axis (valuator) maps onto the predefined valuator
types that GTK+ understands.
</para>
@GDK_AXIS_IGNORE: the axis is ignored.
@GDK_AXIS_X: the axis is used as the x axis.
@GDK_AXIS_Y: the axis is used as the y axis.
@GDK_AXIS_PRESSURE: the axis is used for pressure information.
@GDK_AXIS_XTILT: the axis is used for x tilt information.
@GDK_AXIS_YTILT: the axis is used for x tilt information.
@GDK_AXIS_LAST: a constant equal to the numerically highest axis value.
<!-- ##### FUNCTION gdk_input_set_key ##### -->
<para>
Sets the key event generated when a macro button is pressed.
</para>
@deviceid: the device to configure.
@index: the index of the macro button.
@keyval: the key value for the #GdkKeypressEvent to generate.
(a value of 0 means no event will be generated.)
@modifiers: the modifier field for the generated
#GdkKeyPressEvent.
<!-- ##### FUNCTION gdk_input_window_get_pointer ##### -->
<para>
Returns information about the current position of the pointer
within a window, including extended device information.
Any of the return parameters may be %NULL, in which case,
they will be ignored.
</para>
@window: a #GdkWindow.
@deviceid: a device ID.
@x: location to store current x postion.
@y: location to store current y postion.
@pressure: location to store current pressure.
@xtilt: location to store current tilt in the x direction.
@ytilt: location to store current tilt in the y direction.
@mask: location to store the current modifier state.
<!-- ##### FUNCTION gdk_input_motion_events ##### -->
<para>
Retrieves the motion history for a given device/window pair.
</para>
@window: a #GdkWindow.
@deviceid: the device for which to retrieve motion history.
@start: the start time.
@stop: the stop time.
@nevents_return: location to store the number of events returned.
@Returns: a newly allocated array containing all the events
from @start to @stop. This array should be freed
with g_free() when you are finished using it.
<!-- ##### STRUCT GdkTimeCoord ##### -->
<para>
The #GdkTimeCoord structure stores a single event in a
motion history. It contains the following fields:
</para>
@time: The timestamp for this event.
@x: the x position.
@y: the y position.
@pressure: the pressure.
@xtilt: the tilt in the x direction.
@ytilt: the tilt in the y direction.

28
docs/reference/gdk/tmpl/keys.sgml
View File

@ -71,6 +71,16 @@ Returns TRUE if the given key value is in lower case.
case conversion.
<!-- ##### FUNCTION gdk_keyval_convert_case ##### -->
<para>
</para>
@symbol:
@lower:
@upper:
<!-- ##### FUNCTION gdk_keyval_to_upper ##### -->
<para>
Converts a key value to upper case, if applicable.
@ -91,3 +101,21 @@ Converts a key value to lower case, if applicable.
in lower case or it is not subject to case conversion.
<!-- ##### FUNCTION gdk_keyval_to_unicode ##### -->
<para>
</para>
@keyval:
@Returns:
<!-- ##### FUNCTION gdk_unicode_to_keyval ##### -->
<para>
</para>
@wc:
@Returns:

16
docs/reference/gdk/tmpl/pixmaps.sgml
View File

@ -147,21 +147,23 @@ in which case a default color will be used.
@Returns: the #GdkPixmap.
<!-- ##### FUNCTION gdk_pixmap_ref ##### -->
<!-- ##### MACRO gdk_pixmap_ref ##### -->
<para>
Increase the reference count of a pixmap.
</para>
@pixmap: a #GdkPixmap
@Returns: @pixmap
<!-- # Unused Parameters # -->
@pixmap: a #GdkPixmap
<!-- ##### FUNCTION gdk_pixmap_unref ##### -->
<!-- ##### MACRO gdk_pixmap_unref ##### -->
<para>
Decrease the reference count of a pixmap. If the resulting
reference count is zero, destroy the pixmap.
</para>
<!-- # Unused Parameters # -->
@pixmap: a #GdkPixmap
@ -175,22 +177,24 @@ refers generically to any of these types.
@user_data:
<!-- ##### FUNCTION gdk_bitmap_ref ##### -->
<!-- ##### MACRO gdk_bitmap_ref ##### -->
<para>
Increase the reference count of a bitmap. An alias
for gdk_pixmap_ref().
</para>
@pixmap:
@Returns:
<!-- # Unused Parameters # -->
@pixmap:
<!-- ##### FUNCTION gdk_bitmap_unref ##### -->
<!-- ##### MACRO gdk_bitmap_unref ##### -->
<para>
Decrease the reference count of a bitmap. An alias
for gdk_pixmap_unref().
</para>
<!-- # Unused Parameters # -->
@pixmap:

196
docs/reference/gdk/tmpl/regions.sgml
View File

@ -30,45 +30,41 @@ usually used for clipping graphical operations (see gdk_gc_set_clip_region()).
<!-- ##### STRUCT GdkPoint ##### -->
<para>
Defines the x and y coordinates of a point.
Note that both are defined as #gint16 values, so the coordinates are limited
to between -32,768 and 32,767.
</para>
@x: the x coordinate of the point.
@y: the y coordinate of the point.
@x:
@y:
<!-- ##### STRUCT GdkRectangle ##### -->
<para>
Defines the position and size of a rectangle.
</para>
@x: the x coordinate of the left edge of the rectangle.
@y: the y coordinate of the top of the rectangle.
@width: the width of the rectangle.
@height: the height of the rectangle.
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gdk_rectangle_intersect ##### -->
<para>
Calculates the intersection of two rectangles.
</para>
@src1: a #GdkRectangle.
@src2: a #GdkRectangle.
@dest: the intersection of @src1 and @src2.
@Returns: TRUE if the rectangles intersect.
@src1:
@src2:
@dest:
@Returns:
<!-- ##### FUNCTION gdk_rectangle_union ##### -->
<para>
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.
</para>
@src1: a #GdkRectangle.
@src2: a #GdkRectangle.
@dest: the union of @src1 and @src2.
@src1:
@src2:
@dest:
<!-- ##### STRUCT GdkRegion ##### -->
@ -78,7 +74,6 @@ The only user-visible field of the structure is the user_data member, which
can be used to attach arbitrary data to the #GdkRegion.
</para>
@user_data: arbitrary data attached to the #GdkRegion.
<!-- ##### FUNCTION gdk_region_new ##### -->
<para>
@ -112,6 +107,24 @@ The fill rule is only relevant for polygons which overlap themselves.
included in the region, while areas overlapped an even number of times are not.
@GDK_WINDING_RULE: overlapping areas are always included.
<!-- ##### FUNCTION gdk_region_copy ##### -->
<para>
</para>
@region:
@Returns:
<!-- ##### FUNCTION gdk_region_rectangle ##### -->
<para>
</para>
@rectangle:
@Returns:
<!-- ##### FUNCTION gdk_region_destroy ##### -->
<para>
Destroys a #GdkRegion.
@ -120,81 +133,13 @@ Destroys a #GdkRegion.
@region: a #GdkRegion.
<!-- ##### FUNCTION gdk_regions_intersect ##### -->
<!-- ##### FUNCTION gdk_region_get_clipbox ##### -->
<para>
Returns the intersection of two regions.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion.
@Returns: the intersection of @source1 and @source2.
<!-- ##### FUNCTION gdk_regions_union ##### -->
<para>
Returns the union of two regions.
This is all pixels in either of @source1 or @source2.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion.
@Returns: the union of @source1 and @source2.
<!-- ##### FUNCTION gdk_regions_subtract ##### -->
<para>
Subtracts one region from another.
The result is a region containing all the pixels which are in @source1, but
which are not in @source2.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion to subtract from @source1.
@Returns: @source1 - @source2.
<!-- ##### FUNCTION gdk_regions_xor ##### -->
<para>
Returns the difference between the union and the intersection of two regions.
This is a region containing the pixels that are in one of the source regions,
but which are not in both.
</para>
@source1: a #GdkRegion.
@source2: a #GdkRegion.
@Returns: the difference between the union and the intersection of @source1
and @source2.
<!-- ##### FUNCTION gdk_region_union_with_rect ##### -->
<para>
Returns the union of a region and a rectangle.
Returns the smallest rectangle which includes the entire #GdkRegion.
</para>
@region: a #GdkRegion.
@rect: a #GdkRectangle.
@Returns: the union of @region and @rect.
<!-- ##### FUNCTION gdk_region_offset ##### -->
<para>
Moves a region the specified distance.
</para>
@region: a #GdkRegion.
@dx: the distance to move the region horizontally.
@dy: the distance to move the region vertically.
<!-- ##### FUNCTION gdk_region_shrink ##### -->
<para>
Resizes a region by the specified amount.
Positive values shrink the region. Negative values expand it.
</para>
@region: a #GdkRegion.
@dx: the number of pixels to shrink the region horizontally.
@dy: the number of pixels to shrink the region vertically.
@rectangle: returns the smallest rectangle which includes all of @region.
<!-- ##### FUNCTION gdk_region_empty ##### -->
@ -248,12 +193,71 @@ Specifies the possible values returned by gdk_region_rect_in().
@GDK_OVERLAP_RECTANGLE_OUT: if the rectangle is outside the #GdkRegion.
@GDK_OVERLAP_RECTANGLE_PART: if the rectangle is partly inside the #GdkRegion.
<!-- ##### FUNCTION gdk_region_get_clipbox ##### -->
<!-- ##### FUNCTION gdk_region_offset ##### -->
<para>
Returns the smallest rectangle which includes the entire #GdkRegion.
Moves a region the specified distance.
</para>
@region: a #GdkRegion.
@rectangle: returns the smallest rectangle which includes all of @region.
@dx: the distance to move the region horizontally.
@dy: the distance to move the region vertically.
<!-- ##### FUNCTION gdk_region_shrink ##### -->
<para>
Resizes a region by the specified amount.
Positive values shrink the region. Negative values expand it.
</para>
@region: a #GdkRegion.
@dx: the number of pixels to shrink the region horizontally.
@dy: the number of pixels to shrink the region vertically.
<!-- ##### FUNCTION gdk_region_union_with_rect ##### -->
<para>
Returns the union of a region and a rectangle.
</para>
@region: a #GdkRegion.
@rect: a #GdkRectangle.
<!-- # Unused Parameters # -->
@Returns: the union of @region and @rect.
<!-- ##### FUNCTION gdk_region_intersect ##### -->
<para>
</para>
@source1:
@source2:
<!-- ##### FUNCTION gdk_region_union ##### -->
<para>
</para>
@source1:
@source2:
<!-- ##### FUNCTION gdk_region_subtract ##### -->
<para>
</para>
@source1:
@source2:
<!-- ##### FUNCTION gdk_region_xor ##### -->
<para>
</para>
@source1:
@source2:

39
docs/reference/gdk/tmpl/rgb.sgml
View File

@ -292,6 +292,24 @@ memory bandwidth.
start of the next.
<!-- ##### FUNCTION gdk_draw_rgb_32_image_dithalign ##### -->
<para>
</para>
@drawable:
@gc:
@x:
@y:
@width:
@height:
@dith:
@buf:
@rowstride:
@xdith:
@ydith:
<!-- ##### ENUM GdkRgbDither ##### -->
<para>
@ -359,7 +377,7 @@ colors. This is used only for gdk_draw_indexed_image().
</para>
@colors:
@lut:
@n_colors:
<!-- ##### FUNCTION gdk_rgb_gc_set_foreground ##### -->
<para>
@ -392,6 +410,15 @@ a #GdkColor struct.
@Returns: The X pixel value.
<!-- ##### FUNCTION gdk_rgb_find_color ##### -->
<para>
</para>
@colormap:
@color:
<!-- ##### FUNCTION gdk_rgb_set_install ##### -->
<para>
If @install is TRUE, directs GdkRgb to always install a new "private"
@ -428,7 +455,15 @@ colormap should be used when creating windows that will be drawn in by GdkRgb.
@Returns: The #GdkVisual chosen by GdkRgb.
<!-- ##### FUNCTION gdk_rgb_get_cmap ##### -->
<!-- ##### FUNCTION gdk_rgb_get_colormap ##### -->
<para>
</para>
@Returns:
<!-- ##### MACRO gdk_rgb_get_cmap ##### -->
<para>
Gets the colormap set by GdkRgb. This colormap and the corresponding
visual should be used when creating windows that will be drawn in by GdkRgb.

12
docs/reference/gdk/tmpl/threads.sgml
View File

@ -14,12 +14,6 @@ Threads
</para>
<!-- ##### VARIABLE gdk_threads_mutex ##### -->
<para>
</para>
<!-- ##### MACRO GDK_THREADS_ENTER ##### -->
<para>
@ -48,3 +42,9 @@ Threads
<!-- ##### VARIABLE gdk_threads_mutex ##### -->
<para>
</para>

184
docs/reference/gdk/tmpl/windows.sgml
View File

@ -51,7 +51,6 @@ Windows
@GDK_WINDOW_CHILD:
@GDK_WINDOW_DIALOG:
@GDK_WINDOW_TEMP:
@GDK_WINDOW_PIXMAP:
@GDK_WINDOW_FOREIGN:
<!-- ##### ENUM GdkWindowClass ##### -->
@ -123,7 +122,26 @@ Windows
@window:
<!-- ##### FUNCTION gdk_window_ref ##### -->
<!-- ##### MACRO gdk_window_ref ##### -->
<para>
</para>
@Returns:
<!-- # Unused Parameters # -->
@window:
<!-- ##### MACRO gdk_window_unref ##### -->
<para>
</para>
<!-- # Unused Parameters # -->
@window:
<!-- ##### FUNCTION gdk_window_get_window_type ##### -->
<para>
</para>
@ -132,14 +150,6 @@ Windows
@Returns:
<!-- ##### FUNCTION gdk_window_unref ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gdk_window_at_pointer ##### -->
<para>
@ -224,6 +234,16 @@ Windows
@height:
<!-- ##### FUNCTION gdk_window_scroll ##### -->
<para>
</para>
@window:
@dx:
@dy:
<!-- ##### FUNCTION gdk_window_reparent ##### -->
<para>
@ -267,20 +287,23 @@ Windows
@height:
<!-- ##### FUNCTION gdk_window_copy_area ##### -->
<!-- ##### MACRO gdk_window_copy_area ##### -->
<para>
</para>
@window:
@drawable:
@gc:
@x:
@y:
@source_window:
@source_drawable:
@source_x:
@source_y:
@width:
@height:
<!-- # Unused Parameters # -->
@window:
@source_window:
<!-- ##### FUNCTION gdk_window_raise ##### -->
@ -307,6 +330,93 @@ Windows
@window:
<!-- ##### FUNCTION gdk_window_begin_paint_rect ##### -->
<para>
</para>
@window:
@rectangle:
<!-- ##### FUNCTION gdk_window_begin_paint_region ##### -->
<para>
</para>
@window:
@region:
<!-- ##### FUNCTION gdk_window_end_paint ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gdk_window_invalidate_rect ##### -->
<para>
</para>
@window:
@rect:
@invalidate_children:
<!-- ##### FUNCTION gdk_window_invalidate_region ##### -->
<para>
</para>
@window:
@region:
@invalidate_children:
<!-- ##### FUNCTION gdk_window_get_update_area ##### -->
<para>
</para>
@window:
@Returns:
<!-- ##### FUNCTION gdk_window_freeze_updates ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gdk_window_thaw_updates ##### -->
<para>
</para>
@window:
<!-- ##### FUNCTION gdk_window_process_all_updates ##### -->
<para>
</para>
<!-- ##### FUNCTION gdk_window_process_updates ##### -->
<para>
</para>
@window:
@update_children:
<!-- ##### FUNCTION gdk_window_set_user_data ##### -->
<para>
@ -467,11 +577,12 @@ Windows
@cursor:
<!-- ##### FUNCTION gdk_window_set_colormap ##### -->
<!-- ##### MACRO gdk_window_set_colormap ##### -->
<para>
</para>
<!-- # Unused Parameters # -->
@window:
@colormap:
@ -528,41 +639,45 @@ Windows
@y:
<!-- ##### FUNCTION gdk_window_get_size ##### -->
<!-- ##### MACRO gdk_window_get_size ##### -->
<para>
</para>
<!-- # Unused Parameters # -->
@window:
@width:
@height:
<!-- ##### FUNCTION gdk_window_get_visual ##### -->
<!-- ##### MACRO gdk_window_get_visual ##### -->
<para>
</para>
@window:
@Returns:
<!-- # Unused Parameters # -->
@window:
<!-- ##### FUNCTION gdk_window_get_colormap ##### -->
<!-- ##### MACRO gdk_window_get_colormap ##### -->
<para>
</para>
@window:
@Returns:
<!-- # Unused Parameters # -->
@window:
<!-- ##### FUNCTION gdk_window_get_type ##### -->
<!-- ##### MACRO gdk_window_get_type ##### -->
<para>
</para>
@window:
@Returns:
<!-- # Unused Parameters # -->
@window:
<!-- ##### FUNCTION gdk_window_get_origin ##### -->
@ -647,6 +762,15 @@ Windows
@Returns:
<!-- ##### FUNCTION gdk_window_peek_children ##### -->
<para>
</para>
@window:
@Returns:
<!-- ##### FUNCTION gdk_window_get_events ##### -->
<para>
@ -763,21 +887,3 @@ Windows
@Returns:
<!-- ##### STRUCT GdkDrawable ##### -->
<para>
</para>
@user_data:
<!-- ##### FUNCTION gdk_drawable_set_data ##### -->
<para>
</para>
@drawable:
@key:
@data:
@destroy_func:

1
docs/reference/gtk/.cvsignore
View File

@ -2,5 +2,6 @@ Makefile
Makefile.in
sgml
html
.libs
gtk-decl-list.txt
gtk-unused.txt

152
docs/reference/gtk/Makefile.am
View File

@ -6,54 +6,148 @@ DOC_MODULE=gtk
# The top-level SGML file.
DOC_MAIN_SGML_FILE=gtk-docs.sgml
# We could alternatively use this for using installed headers.
INCLUDE_DIR=`gtk-config --prefix`/include/gtk
# The directory containing the source code
DOC_SOURCE_DIR=$(top_srcdir)/gtk
# Extra options to supply to gtkdoc-fixref
FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
# Header files to ignore when scanning
IGNORE_HFILES= \
fnmatch.h \
gdk-pixbuf-loader.h \
gtkdebug.h \
gtkhsv.h \
gtkimcontextsimple.h \
gtkintl.h \
gtkprivate.h \
gtktextbtree.h \
gtktextchild.h \
gtktextdisplay.h \
gtktextiterprivate.h \
gtktextlayout.h \
gtktextmarkprivate.h \
gtktextsegment.h \
gtktexttagprivate.h \
gtktexttypes.h \
gtktypebuiltins.h
GTKDOC_CFLAGS = @STRIP_BEGIN@ \
@CFLAGS@ \
-I$(top_srcdir) \
-I$(top_builddir)/gdk \
-DGTK_DISABLE_COMPAT_H \
@GTK_DEBUG_FLAGS@ \
@GTK_XIM_FLAGS@ \
@GTK_LOCALE_FLAGS@ \
@PANGO_CFLAGS@ \
@GLIB_CFLAGS@ \
@more_cflags@ \
@STRIP_END@
GTKDOC_LIBS = @STRIP_BEGIN@ \
$(top_builddir)/gdk-pixbuf/libgdk_pixbuf-1.3.la \
$(top_builddir)/gdk/@gdktargetlib@ \
$(top_builddir)/gtk/@gtktargetlib@ \
@more_ldflags@ \
@more_libs@ \
@GDK_WLIBS@ \
@PANGO_LIBS@ \
@GLIB_LIBS@ \
@GTK_LIBS_EXTRA@ \
-lm \
@STRIP_END@
GTKDOC_CC=$(LIBTOOL) --mode=compile $(CC)
GTKDOC_LD=$(LIBTOOL) --mode=link $(CC)
content_files = \
objects_grouped.sgml
####################################
# Everything below here is generic #
####################################
TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
CFLAGS=`gtk-config --cflags`
LDFLAGS=`gtk-config --libs`
EXTRA_DIST = \
$(DOC_MAIN_SGML_FILE) \
$(content_files) \
$(DOC_MODULE)-sections.txt \
$(DOC_MODULE)-overrides.txt
if ENABLE_GTK_DOC
all-local: html/index.html
$(DOC_MODULE)-decl.txt:
$(MAKE) scan
$(tmpl_sources): $(DOC_MODULE)-decl.txt $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt
$(MAKE) templates
sgml/$(DOC_MODULE)-doc.bottom: $(tmpl_sources) $(DOC_MODULE)-decl.txt
$(MAKE) sgml
html/index.html: sgml/$(DOC_MODULE)-doc.bottom $(DOC_MAIN_SGML_FILE) $(content_fiels)
$(MAKE) html
endif
scan:
CFLAGS=$(CFLAGS) LDFLAGS=$(LDFLAGS) gtkdoc-scanobj --module=$(DOC_MODULE)
gtkdoc-scan --module=$(DOC_MODULE) --ignore-headers='gtkintl.h' $(INCLUDE_DIR)/*.h
(cd $(srcdir) \
&& CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj --module=$(DOC_MODULE) \
&& gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(EXTRA_HFILES))
templates: scan
gtkdoc-mktmpl --module=$(DOC_MODULE)
templates:
cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE)
sgml:
gtkdoc-mkdb --module=$(DOC_MODULE)
cd $(srcdir) \
&& gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR)
html:
if ! test -d html ; then mkdir html ; fi
-cd html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
test -d $(srcdir)/html || mkdir $(srcdir)/html
-cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
@echo '-- Fixing Crossreferences'
gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
clean-local:
rm -f *~ *.bak *.hierarchy *.signals *.args *-unused.txt
rm -f *~ *.bak *.signals *-unused.txt
maintainer-clean-local: clean
rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
cd $(srcdir) && rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
install-data-local:
install -d -m 0755 $(TARGET_DIR)
install -m 0644 html/*.html $(TARGET_DIR)
install -m 0644 html/index.sgml $(TARGET_DIR)
gtkdoc-fixxref --module=$(DOC_MODULE) --html-dir=$(HTML_DIR)
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
(installfiles=`echo $(srcdir)/html/*.html`; \
if test "$$installfiles" = '$(srcdir)/html/*.html'; \
then echo '-- Nothing to install' ; \
else \
for i in $$installfiles; do \
echo '-- Installing '$$i ; \
$(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
done; \
echo '-- Installing $(srcdir)/html/index.sgml' ; \
$(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \
fi)
EXTRA_DIST = \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE)-sections.txt \
gtk-overrides.txt \
gtk-decl.txt \
gtk.hierarchy \
gtk.signals \
gtk.args \
gtk.types \
objects_grouped.sgml
#
# Require gtk-doc when making dist
#
if ENABLE_GTK_DOC
dist-check-gtkdoc:
else
dist-check-gtkdoc:
@echo "*** gtk-doc must be installed and enabled in order to make dist
@false
endif
dist-hook:
dist-hook: dist-check-gtkdoc
mkdir $(distdir)/html
mkdir $(distdir)/sgml
mkdir $(distdir)/tmpl
cp -p tmpl/*.sgml $(distdir)/tmpl
-cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html
-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
-cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml
.PHONY : html sgml templates scan

5033
docs/reference/gtk/gtk-decl.txt
View File

File diff suppressed because it is too large Load Diff

18
docs/reference/gtk/gtk-docs.sgml
View File

@ -40,6 +40,8 @@
<!entity GtkHScrollbar SYSTEM "sgml/gtkhscrollbar.sgml">
<!entity GtkHSeparator SYSTEM "sgml/gtkhseparator.sgml">
<!entity GtkImage SYSTEM "sgml/gtkimage.sgml">
<!entity GtkIMContext SYSTEM "sgml/gtkimcontext.sgml">
<!entity GtkIMMulticontext SYSTEM "sgml/gtkimmulticontext.sgml">
<!entity GtkInputDialog SYSTEM "sgml/gtkinputdialog.sgml">
<!entity GtkInvisible SYSTEM "sgml/gtkinvisible.sgml">
<!entity GtkItem SYSTEM "sgml/gtkitem.sgml">
@ -77,6 +79,12 @@
<!entity GtkTable SYSTEM "sgml/gtktable.sgml">
<!entity GtkTearoffMenuItem SYSTEM "sgml/gtktearoffmenuitem.sgml">
<!entity GtkText SYSTEM "sgml/gtktext.sgml">
<!entity GtkTextBuffer SYSTEM "sgml/gtktextbuffer.sgml">
<!entity gtk-GtkTextIter SYSTEM "sgml/gtktextiter.sgml">
<!entity gtk-GtkTextMark SYSTEM "sgml/gtktextmark.sgml">
<!entity GtkTextTag SYSTEM "sgml/gtktexttag.sgml">
<!entity GtkTextTagTable SYSTEM "sgml/gtktexttagtable.sgml">
<!entity GtkTextView SYSTEM "sgml/gtktextview.sgml">
<!entity GtkTipsQuery SYSTEM "sgml/gtktipsquery.sgml">
<!entity GtkToggleButton SYSTEM "sgml/gtktogglebutton.sgml">
<!entity GtkToolbar SYSTEM "sgml/gtktoolbar.sgml">
@ -108,7 +116,6 @@
<!entity gtk-Types SYSTEM "sgml/gtktypeutils.sgml">
<!entity gtk-Bindings SYSTEM "sgml/gtkbindings.sgml">
<!entity gtk-Standard-Enumerations SYSTEM "sgml/gtkenums.sgml">
<!entity gtk-Private-Information SYSTEM "sgml/gtkprivate.sgml">
<!entity index-Object-Tree SYSTEM "sgml/tree_index.sgml">
@ -181,7 +188,6 @@ An advanced widget set.
&gtk-Types;
&gtk-Bindings;
&gtk-Standard-Enumerations;
&gtk-Private-Information;
</chapter>
<chapter id="gtkobjects" role="no-toc">
@ -228,6 +234,8 @@ An advanced widget set.
&GtkHScrollbar;
&GtkHSeparator;
&GtkImage;
&GtkIMContext;
&GtkIMMulticontext;
&GtkInputDialog;
&GtkInvisible;
&GtkItem;
@ -265,6 +273,12 @@ An advanced widget set.
&GtkTable;
&GtkTearoffMenuItem;
&GtkText;
&GtkTextBuffer;
&gtk-GtkTextIter;
&gtk-GtkTextMark;
&GtkTextTag;
&GtkTextTagTable;
&GtkTextView;
&GtkTipsQuery;
&GtkToggleButton;
&GtkToolbar;

13
docs/reference/gtk/gtk-overrides.txt
View File

@ -17,3 +17,16 @@ GtkObject *object,
GtkArg *arg,
guint arg_id
</USER_FUNCTION>
# GtkAllocation is the same as GtkRectangle
<STRUCT>
<NAME>GtkAllocation</NAME>
struct GtkAllocation
{
gint x;
gint y;
gint width;
gint height;
};
</STRUCT>

729
docs/reference/gtk/gtk-sections.txt
View File

File diff suppressed because it is too large Load Diff

538
docs/reference/gtk/gtk.args
View File

@ -40,6 +40,30 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkAspectFrame::xalign</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkAspectFrame::yalign</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkAspectFrame::ratio</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkAspectFrame::obey_child</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkBox::spacing</NAME>
<TYPE>gint</TYPE>
@ -54,7 +78,7 @@
<ARG>
<NAME>GtkButton::label</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
@ -106,6 +130,12 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCList::sort_type</NAME>
<TYPE>GtkSortType</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkContainer::border_width</NAME>
<TYPE>gulong</TYPE>
@ -124,6 +154,12 @@
<FLAGS>w</FLAGS>
</ARG>
<ARG>
<NAME>GtkContainer::reallocate_redraws</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCTree::n_columns</NAME>
<TYPE>guint</TYPE>
@ -166,6 +202,36 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCurve::curve_type</NAME>
<TYPE>GtkCurveType</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCurve::min_x</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCurve::max_x</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCurve::min_y</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkCurve::max_y</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkEditable::text_position</NAME>
<TYPE>gint</TYPE>
@ -192,7 +258,7 @@
<ARG>
<NAME>GtkFrame::label</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
@ -220,27 +286,39 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkHandleBox::handle_position</NAME>
<TYPE>GtkPositionType</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkHandleBox::snap_edge</NAME>
<TYPE>GtkPositionType</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkHScale::adjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkHScrollbar::adjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkLabel::label</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkLabel::pattern</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
@ -250,6 +328,18 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkLabel::wrap</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkList::selection_mode</NAME>
<TYPE>GtkSelectionMode</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkMenuBar::shadow</NAME>
<TYPE>GtkShadowType</TYPE>
@ -334,6 +424,12 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkNotebook::homogeneous</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkObject::user_data</NAME>
<TYPE>gpointer</TYPE>
@ -400,6 +496,18 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkPaned::handle_size</NAME>
<TYPE>guint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkPreview::expand</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkProgress::activity_mode</NAME>
<TYPE>gboolean</TYPE>
@ -427,7 +535,7 @@
<ARG>
<NAME>GtkProgressBar::adjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
@ -460,6 +568,18 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkProgressBar::fraction</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkProgressBar::pulse_step</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkRadioButton::group</NAME>
<TYPE>GtkRadioButton</TYPE>
@ -472,6 +592,30 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkRuler::lower</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkRuler::upper</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkRuler::position</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkRuler::max_size</NAME>
<TYPE>gfloat</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkScale::digits</NAME>
<TYPE>gint</TYPE>
@ -520,6 +664,12 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkScrolledWindow::shadow</NAME>
<TYPE>GtkShadowType</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkSpinButton::adjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
@ -607,13 +757,13 @@
<ARG>
<NAME>GtkText::hadjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkText::vadjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
@ -628,6 +778,318 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::name</NAME>
<TYPE>gstring</TYPE>
<FLAGS>rwX</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background</NAME>
<TYPE>gstring</TYPE>
<FLAGS>w</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_gdk</NAME>
<TYPE>GdkColor</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_full_height</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_stipple</NAME>
<TYPE>GdkPixmap</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::direction</NAME>
<TYPE>GEnum</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::editable</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::font</NAME>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::font_desc</NAME>
<TYPE>GtkBoxed</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::foreground</NAME>
<TYPE>gstring</TYPE>
<FLAGS>w</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::foreground_gdk</NAME>
<TYPE>GdkColor</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::foreground_stipple</NAME>
<TYPE>GdkPixmap</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::justify</NAME>
<TYPE>GEnum</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::language</NAME>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::left_margin</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::left_wrapped_line_margin</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::offset</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::overstrike</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::pixels_above_lines</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::pixels_below_lines</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::pixels_inside_wrap</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::right_margin</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::underline</NAME>
<TYPE>GEnum</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::wrap_mode</NAME>
<TYPE>GEnum</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_full_height_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_gdk_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::background_stipple_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::editable_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::font_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::foreground_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::foreground_gdk_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::foreground_stipple_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::justify_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::language_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::left_margin_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::left_wrapped_line_margin_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::offset_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::overstrike_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::pixels_above_lines_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::pixels_below_lines_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::pixels_inside_wrap_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::right_margin_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::underline_set</NAME>
<TYPE>GEnum</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextTag::wrap_mode_set</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::height_lines</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::width_columns</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::pixels_above_lines</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::pixels_below_lines</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::pixels_inside_wrap</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::editable</NAME>
<TYPE>gboolean</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTextView::wrap_mode</NAME>
<TYPE>GEnum</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTipsQuery::emit_always</NAME>
<TYPE>gboolean</TYPE>
@ -642,13 +1104,13 @@
<ARG>
<NAME>GtkTipsQuery::label_inactive</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkTipsQuery::label_no_tip</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
@ -664,16 +1126,46 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkToolbar::orientation</NAME>
<TYPE>GtkOrientation</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkToolbar::toolbar_style</NAME>
<TYPE>GtkToolbarStyle</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkToolbar::space_size</NAME>
<TYPE>guint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkToolbar::space_style</NAME>
<TYPE>GtkToolbarSpaceStyle</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkToolbar::relief</NAME>
<TYPE>GtkReliefStyle</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkViewport::hadjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkViewport::vadjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
@ -685,18 +1177,18 @@
<ARG>
<NAME>GtkVScale::adjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkVScrollbar::adjustment</NAME>
<TYPE>GtkAdjustment</TYPE>
<FLAGS>rwx</FLAGS>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkWidget::name</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
@ -810,7 +1302,7 @@
<ARG>
<NAME>GtkWindow::title</NAME>
<TYPE>GtkString</TYPE>
<TYPE>gstring</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
@ -844,3 +1336,15 @@
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkWindow::default_width</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>
<ARG>
<NAME>GtkWindow::default_height</NAME>
<TYPE>gint</TYPE>
<FLAGS>rw</FLAGS>
</ARG>

12
docs/reference/gtk/gtk.hierarchy
View File

@ -25,8 +25,8 @@ GtkObject
GtkListItem
GtkTreeItem
GtkWindow
GtkColorSelectionDialog
GtkDialog
GtkColorSelectionDialog
GtkInputDialog
GtkFileSelection
GtkFontSelectionDialog
@ -41,6 +41,7 @@ GtkObject
GtkVButtonBox
GtkVBox
GtkColorSelection
GtkFontSelection
GtkGammaCurve
GtkHBox
GtkCombo
@ -48,8 +49,6 @@ GtkObject
GtkCList
GtkCTree
GtkFixed
GtkNotebook
GtkFontSelection
GtkPaned
GtkHPaned
GtkVPaned
@ -58,9 +57,11 @@ GtkObject
GtkMenuShell
GtkMenu
GtkMenuBar
GtkNotebook
GtkPacker
GtkSocket
GtkTable
GtkTextView
GtkToolbar
GtkTree
GtkCalendar
@ -90,4 +91,9 @@ GtkObject
GtkData
GtkAdjustment
GtkTooltips
GtkIMContext
GtkIMMulticontext
GtkItemFactory
GtkTextBuffer
GtkTextTag
GtkTextTagTable

227
docs/reference/gtk/gtk.signals
View File

@ -212,14 +212,14 @@ GtkColorSelection *colorselection
<NAME>GtkContainer::add</NAME>
<RETURNS>void</RETURNS>
GtkContainer *container
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
<NAME>GtkContainer::remove</NAME>
<RETURNS>void</RETURNS>
GtkContainer *container
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
@ -239,7 +239,7 @@ GtkDirectionType direction
<NAME>GtkContainer::set-focus-child</NAME>
<RETURNS>void</RETURNS>
GtkContainer *container
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
@ -416,14 +416,39 @@ GtkEditable *editable
<NAME>GtkHandleBox::child-attached</NAME>
<RETURNS>void</RETURNS>
GtkHandleBox *handlebox
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
<NAME>GtkHandleBox::child-detached</NAME>
<RETURNS>void</RETURNS>
GtkHandleBox *handlebox
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
<NAME>GtkIMContext::preedit-start</NAME>
<RETURNS>void</RETURNS>
GtkIMContext *imcontext
</SIGNAL>
<SIGNAL>
<NAME>GtkIMContext::preedit-end</NAME>
<RETURNS>void</RETURNS>
GtkIMContext *imcontext
</SIGNAL>
<SIGNAL>
<NAME>GtkIMContext::preedit-changed</NAME>
<RETURNS>void</RETURNS>
GtkIMContext *imcontext
</SIGNAL>
<SIGNAL>
<NAME>GtkIMContext::commit</NAME>
<RETURNS>void</RETURNS>
GtkIMContext *imcontext
gstring arg1
</SIGNAL>
<SIGNAL>
@ -468,14 +493,14 @@ GtkList *list
<NAME>GtkList::select-child</NAME>
<RETURNS>void</RETURNS>
GtkList *list
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
<NAME>GtkList::unselect-child</NAME>
<RETURNS>void</RETURNS>
GtkList *list
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
@ -603,6 +628,19 @@ gint page_num
GtkObject *object
</SIGNAL>
<SIGNAL>
<NAME>GtkSpinButton::input</NAME>
<RETURNS>gint</RETURNS>
GtkSpinButton *spinbutton
gpointer arg1
</SIGNAL>
<SIGNAL>
<NAME>GtkSpinButton::output</NAME>
<RETURNS>gboolean</RETURNS>
GtkSpinButton *spinbutton
</SIGNAL>
<SIGNAL>
<NAME>GtkStatusbar::text-pushed</NAME>
<RETURNS>void</RETURNS>
@ -619,6 +657,163 @@ guint context_id
gchar *text
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::insert-text</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
gpointer arg1
gpointer arg2
gint arg3
gboolean arg4
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::delete-text</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
gpointer arg1
gpointer arg2
gboolean arg3
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::changed</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::modified-changed</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::mark-set</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
gpointer arg1
gpointer arg2
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::mark-deleted</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
gpointer arg1
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::apply-tag</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
gpointer arg1
gpointer arg2
gpointer arg3
</SIGNAL>
<SIGNAL>
<NAME>GtkTextBuffer::remove-tag</NAME>
<RETURNS>void</RETURNS>
GtkTextBuffer *textbuffer
gpointer arg1
gpointer arg2
gpointer arg3
</SIGNAL>
<SIGNAL>
<NAME>GtkTextTag::event</NAME>
<RETURNS>gint</RETURNS>
GtkTextTag *texttag
GtkObject arg1
GdkEvent *event
gpointer arg2
</SIGNAL>
<SIGNAL>
<NAME>GtkTextTagTable::tag-changed</NAME>
<RETURNS>void</RETURNS>
GtkTextTagTable *texttagtable
GtkObject arg1
gboolean arg2
</SIGNAL>
<SIGNAL>
<NAME>GtkTextTagTable::tag-added</NAME>
<RETURNS>void</RETURNS>
GtkTextTagTable *texttagtable
GtkObject arg1
</SIGNAL>
<SIGNAL>
<NAME>GtkTextTagTable::tag-removed</NAME>
<RETURNS>void</RETURNS>
GtkTextTagTable *texttagtable
GtkObject arg1
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::move-insert</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
GEnum arg1
gint arg2
gboolean arg3
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::set-anchor</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::scroll-text</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
GEnum arg1
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::delete-text</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
GEnum arg1
gint arg2
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::cut-text</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::copy-text</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::paste-text</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::toggle-overwrite</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
</SIGNAL>
<SIGNAL>
<NAME>GtkTextView::set-scroll-adjustments</NAME>
<RETURNS>void</RETURNS>
GtkTextView *textview
GtkAdjustment arg1
GtkAdjustment arg2
</SIGNAL>
<SIGNAL>
<NAME>GtkTipsQuery::start-query</NAME>
<RETURNS>void</RETURNS>
@ -680,14 +875,14 @@ GtkTree *tree
<NAME>GtkTree::select-child</NAME>
<RETURNS>void</RETURNS>
GtkTree *tree
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
<NAME>GtkTree::unselect-child</NAME>
<RETURNS>void</RETURNS>
GtkTree *tree
GtkWidget *widget
GtkWidget widget
</SIGNAL>
<SIGNAL>
@ -792,6 +987,13 @@ GtkWidget *widget
GtkStyle *previous_style
</SIGNAL>
<SIGNAL>
<NAME>GtkWidget::direction-changed</NAME>
<RETURNS>void</RETURNS>
GtkWidget *widget
GtkTextDirection arg1
</SIGNAL>
<SIGNAL>
<NAME>GtkWidget::add-accelerator</NAME>
<RETURNS>void</RETURNS>
@ -839,6 +1041,13 @@ GtkWidget *widget
GdkEventButton *event
</SIGNAL>
<SIGNAL>
<NAME>GtkWidget::scroll-event</NAME>
<RETURNS>gboolean</RETURNS>
GtkWidget *widget
GdkEvent *event
</SIGNAL>
<SIGNAL>
<NAME>GtkWidget::motion-notify-event</NAME>
<RETURNS>gboolean</RETURNS>

7
docs/reference/gtk/gtk.types
View File

@ -39,8 +39,9 @@ gtk_hruler_get_type
gtk_hscale_get_type
gtk_hscrollbar_get_type
gtk_hseparator_get_type
gtk_identifier_get_type
gtk_image_get_type
gtk_im_context_get_type
gtk_im_multicontext_get_type
gtk_input_dialog_get_type
gtk_invisible_get_type
gtk_item_get_type
@ -78,6 +79,10 @@ gtk_statusbar_get_type
gtk_table_get_type
gtk_tearoff_menu_item_get_type
gtk_text_get_type
gtk_text_buffer_get_type
gtk_text_tag_get_type
gtk_text_tag_table_get_type
gtk_text_view_get_type
gtk_tips_query_get_type
gtk_toggle_button_get_type
gtk_toolbar_get_type

1454
docs/reference/gtk/tmpl/gtk-unused.sgml
View File

File diff suppressed because it is too large Load Diff

22
docs/reference/gtk/tmpl/gtkaccelgroup.sgml
View File

@ -226,28 +226,6 @@ Keyboard Accelerators
@Returns:
<!-- ##### FUNCTION gtk_accel_group_marshal_add ##### -->
<para>
</para>
@object:
@func:
@func_data:
@args:
<!-- ##### FUNCTION gtk_accel_group_marshal_remove ##### -->
<para>
</para>
@object:
@func:
@func_data:
@args:
<!-- ##### FUNCTION gtk_accel_groups_from_object ##### -->
<para>

27
docs/reference/gtk/tmpl/gtkarg.sgml
View File

@ -93,6 +93,24 @@ Frees the argument, and optionally its contents.
@free_contents: whether to free the string, if it is a string.
<!-- ##### FUNCTION gtk_arg_reset ##### -->
<para>
</para>
@arg:
<!-- ##### FUNCTION gtk_arg_values_equal ##### -->
<para>
</para>
@arg1:
@arg2:
@Returns:
<!-- ##### FUNCTION gtk_args_collect ##### -->
<para>
Private: given a hashtable of argument information it takes a vararg
@ -200,3 +218,12 @@ A #GHashFunc for hashing #GtkArgInfos.
@Returns: a hash value for that #GtkArgInfo.
<!-- ##### FUNCTION gtk_arg_to_valueloc ##### -->
<para>
</para>
@arg:
@value_pointer:

20
docs/reference/gtk/tmpl/gtkaspectframe.sgml
View File

@ -63,3 +63,23 @@ to 1.0 (right aligned)
ratio is taken from the requistion of the child.
<!-- ##### ARG GtkAspectFrame:xalign ##### -->
<para>
</para>
<!-- ##### ARG GtkAspectFrame:yalign ##### -->
<para>
</para>
<!-- ##### ARG GtkAspectFrame:ratio ##### -->
<para>
</para>
<!-- ##### ARG GtkAspectFrame:obey_child ##### -->
<para>
</para>

14
docs/reference/gtk/tmpl/gtkclist.sgml
View File

@ -114,7 +114,6 @@ A macro to test whether the CList is in "add mode."
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_AUTO_SORT ##### -->
<para>
A macro to test whether the CList has automatic sorting
@ -124,7 +123,6 @@ switched on.
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_AUTO_RESIZE_BLOCKED ##### -->
<para>
A macro to check if automatic resizing of columns is blocked.
@ -133,7 +131,6 @@ A macro to check if automatic resizing of columns is blocked.
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_REORDERABLE ##### -->
<para>
A macro to test if the CList's columns are re-orderable
@ -142,7 +139,6 @@ A macro to test if the CList's columns are re-orderable
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_USE_DRAG_ICONS ##### -->
<para>
A macro to check if the USE_DRAG_ICONS property is enabled.
@ -151,7 +147,6 @@ A macro to check if the USE_DRAG_ICONS property is enabled.
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_DRAW_DRAG_LINE ##### -->
<para>
A macro to check if the DRAW_DRAG_LINE property is enabled.
@ -160,7 +155,6 @@ A macro to check if the DRAW_DRAG_LINE property is enabled.
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_DRAW_DRAG_RECT ##### -->
<para>
A macro to check if the DRAW_DRAG_RECT property is enabled.
@ -169,7 +163,6 @@ A macro to check if the DRAW_DRAG_RECT property is enabled.
@clist: The #GtkCList widget to check.
<!-- ##### MACRO GTK_CLIST_ROW ##### -->
<para>
A macro to cast a GList element to a CListRow pointer.
@ -216,7 +209,7 @@ Function prototype for the compare function callback.
</para>
@clist: The #GtkCList that is affected.
@ptr1: A #gconstpointer to the first node to compare.
@ptr1: A #gconstpointer to the first node to compare.
@ptr2: A #gconstpointer to the second node to compare.
@Returns: 0 if the nodes are equal, less than 0 if the first node should
come before the second, and greater than 1 if the second come before the
@ -1315,3 +1308,8 @@ A boolean value for setting whether to use icons during drag
operations.
</para>
<!-- ##### ARG GtkCList:sort_type ##### -->
<para>
</para>

100
docs/reference/gtk/tmpl/gtkcolorsel.sgml
View File

@ -64,18 +64,40 @@ time.
@policy: a #GtkUpdateType value indicating the desired policy.
<!-- ##### FUNCTION gtk_color_selection_set_opacity ##### -->
<!-- ##### FUNCTION gtk_color_selection_set_use_opacity ##### -->
<para>
Controls whether opacity can be set with the #GtkColorSelection.
If this functionality is enabled, the necessary additional widgets
are added to the #GtkColorSelection and the opacity value can be
retrieved via the fourth value in the color array returned by
the gtk_color_selection_get_color() function.
</para>
@colorsel: a #GtkColorSelection.
@use_opacity: a boolean indicating whether the opacity selection
is enabled.
@colorsel:
@use_opacity:
<!-- ##### FUNCTION gtk_color_selection_get_use_opacity ##### -->
<para>
</para>
@colorsel:
@Returns:
<!-- ##### FUNCTION gtk_color_selection_set_use_palette ##### -->
<para>
</para>
@colorsel:
@use_palette:
<!-- ##### FUNCTION gtk_color_selection_get_use_palette ##### -->
<para>
</para>
@colorsel:
@Returns:
<!-- ##### FUNCTION gtk_color_selection_set_color ##### -->
@ -99,6 +121,66 @@ Retrieve the currently selected color value.
blue, and opacity.
<!-- ##### FUNCTION gtk_color_selection_set_old_color ##### -->
<para>
</para>
@colorsel:
@color:
<!-- ##### FUNCTION gtk_color_selection_get_old_color ##### -->
<para>
</para>
@colorsel:
@color:
<!-- ##### FUNCTION gtk_color_selection_set_palette_color ##### -->
<para>
</para>
@colorsel:
@x:
@y:
@color:
<!-- ##### FUNCTION gtk_color_selection_get_palette_color ##### -->
<para>
</para>
@colorsel:
@x:
@y:
@color:
@Returns:
<!-- ##### FUNCTION gtk_color_selection_unset_palette_color ##### -->
<para>
</para>
@colorsel:
@x:
@y:
<!-- ##### FUNCTION gtk_color_selection_is_adjusting ##### -->
<para>
</para>
@colorsel:
@Returns:
<!-- ##### SIGNAL GtkColorSelection::color-changed ##### -->
<para>
This signal is emitted when the color changes in the #GtkColorSelection

2
docs/reference/gtk/tmpl/gtkcolorseldlg.sgml
View File

@ -68,3 +68,5 @@ Creates a new #GtkColorSelectionDialog.
@title: a string containing the title text for the dialog.
@Returns: a #GtkColorSelectionDialog.

46
docs/reference/gtk/tmpl/gtkcontainer.sgml
View File

@ -111,6 +111,15 @@ GtkContainer
@Returns:
<!-- ##### FUNCTION gtk_container_set_reallocate_redraws ##### -->
<para>
</para>
@container:
@needs_redraws:
<!-- ##### FUNCTION gtk_container_set_focus_child ##### -->
<para>
@ -138,22 +147,6 @@ GtkContainer
@adjustment:
<!-- ##### FUNCTION gtk_container_register_toplevel ##### -->
<para>
</para>
@container:
<!-- ##### FUNCTION gtk_container_unregister_toplevel ##### -->
<para>
</para>
@container:
<!-- ##### FUNCTION gtk_container_resize_children ##### -->
<para>
@ -330,14 +323,6 @@ GtkContainer
@Returns:
<!-- ##### FUNCTION gtk_container_get_toplevels ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gtk_container_set_border_width ##### -->
<para>
@ -347,6 +332,14 @@ GtkContainer
@border_width:
<!-- ##### FUNCTION gtk_container_dequeue_resize_handler ##### -->
<para>
</para>
@container:
<!-- ##### SIGNAL GtkContainer::add ##### -->
<para>
@ -402,3 +395,8 @@ GtkContainer
</para>
<!-- ##### ARG GtkContainer:reallocate_redraws ##### -->
<para>
</para>

25
docs/reference/gtk/tmpl/gtkcurve.sgml
View File

@ -123,3 +123,28 @@ calling gtk_curve_reset() or gtk_curve_set_gamma().
@curve: the object which received the signal.
<!-- ##### ARG GtkCurve:curve_type ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:min_x ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:max_x ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:min_y ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:max_y ##### -->
<para>
</para>

42
docs/reference/gtk/tmpl/gtkdebug.sgml
View File

@ -1,42 +0,0 @@
<!-- ##### SECTION Title ##### -->
Debugging
<!-- ##### SECTION Short_Description ##### -->
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### ENUM GtkDebugFlag ##### -->
<para>
</para>
@GTK_DEBUG_OBJECTS:
@GTK_DEBUG_MISC:
@GTK_DEBUG_SIGNALS:
@GTK_DEBUG_DND:
@GTK_DEBUG_PLUGSOCKET:
<!-- ##### VARIABLE gtk_debug_flags ##### -->
<para>
</para>
<!-- ##### MACRO GTK_NOTE ##### -->
<para>
</para>
@type:
@action:

6
docs/reference/gtk/tmpl/gtkenums.sgml
View File

@ -142,7 +142,7 @@ Used for packing widgets into #GtkBox widgets. (See also: #GtkVBox,
#GtkHBox, and #GtkButtonBox).
</para>
@GTK_PACK_START: The
@GTK_PACK_START: The
@GTK_PACK_END:
<!-- ##### ENUM GtkPathPriorityType ##### -->
@ -244,7 +244,7 @@ Used to change the appearance of an outline typically provided by a #GtkFrame.
@GTK_SHADOW_IN: The outline is bevelled inwards.
@GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
@GTK_SHADOW_ETCHED_IN: The outline itself is an inward bevel, but the frame
does
does
@GTK_SHADOW_ETCHED_OUT:
<!-- ##### ENUM GtkStateType ##### -->
@ -283,6 +283,7 @@ Used to customize the appearance of a #GtkToolbar.
@GTK_TOOLBAR_ICONS: Buttons should display only icons in the toolbar.
@GTK_TOOLBAR_TEXT: Buttons should display only text labels in the toolbar.
@GTK_TOOLBAR_BOTH: Buttons should display text and icons in the toolbar.
@GTK_TOOLBAR_BOTH_HORIZ:
<!-- ##### ENUM GtkTroughType ##### -->
<para>
@ -320,6 +321,7 @@ Window placement can be influenced using this enumeration.
@GTK_WIN_POS_NONE: No influence is made on placement.
@GTK_WIN_POS_CENTER: Windows should be placed in the center of the screen.
@GTK_WIN_POS_MOUSE: Windows should be placed at the current mouse position.
@GTK_WIN_POS_CENTER_ALWAYS:
<!-- ##### ENUM GtkWindowType ##### -->
<para>

45
docs/reference/gtk/tmpl/gtkfeatures.sgml
View File

@ -61,3 +61,48 @@ Checks that the GTK+ library in use is compatable with the given version.
a string describing the version mismatch.
<!-- ##### MACRO GTK_MAJOR_VERSION ##### -->
<para>
</para>
<!-- ##### MACRO GTK_MINOR_VERSION ##### -->
<para>
</para>
<!-- ##### MACRO GTK_MICRO_VERSION ##### -->
<para>
</para>
<!-- ##### MACRO GTK_BINARY_AGE ##### -->
<para>
</para>
<!-- ##### MACRO GTK_INTERFACE_AGE ##### -->
<para>
</para>
<!-- ##### MACRO GTK_CHECK_VERSION ##### -->
<para>
</para>
@major:
@minor:
@micro:

26
docs/reference/gtk/tmpl/gtkfontsel.sgml
View File

@ -106,29 +106,3 @@ Sets the text displayed in the preview area.
@text: the text to display in the preview area.
<!-- ##### FUNCTION gtk_font_selection_set_filter ##### -->
<para>
Sets one of the two font filters, to limit the fonts shown.
</para>
@fontsel: a #GtkFontSelection.
@filter_type: which of the two font filters to set, either
#GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
can be changed by the user, but the base filter is permanent.
@font_type: the types of font to be shown. This is a bitwise combination of
#GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
or #GTK_FONT_ALL to show all three font types.
@foundries: a NULL-terminated array of strings containing foundry names which
will be shown, or NULL to show all foundries.
@weights: a NULL-terminated array of strings containing weight names which
will be shown, or NULL to show all weights.
@slants: a NULL-terminated array of strings containing slant names which
will be shown, or NULL to show all slants.
@setwidths: a NULL-terminated array of strings containing setwidth names which
will be shown, or NULL to show all setwidths.
@spacings: a NULL-terminated array of strings containing spacings which
will be shown, or NULL to show all spacings.
@charsets: a NULL-terminated array of strings containing charset names which
will be shown, or NULL to show all charsets.

49
docs/reference/gtk/tmpl/gtkfontseldlg.sgml
View File

@ -127,52 +127,3 @@ Sets the text displayed in the preview area.
@text: the text to display in the preview area.
<!-- ##### FUNCTION gtk_font_selection_dialog_set_filter ##### -->
<para>
Sets one of the two font filters, to limit the fonts shown.
</para>
@fsd: a #GtkFontSelectionDialog.
@filter_type: which of the two font filters to set, either
#GTK_FONT_FILTER_BASE or #GTK_FONT_FILTER_USER. The user filter
can be changed by the user, but the base filter is permanent.
@font_type: the types of font to be shown. This is a bitwise combination of
#GTK_FONT_BITMAP, #GTK_FONT_SCALABLE and #GTK_FONT_SCALABLE_BITMAP,
or #GTK_FONT_ALL to show all three font types.
@foundries: a NULL-terminated array of strings containing foundry names which
will be shown, or NULL to show all foundries.
@weights: a NULL-terminated array of strings containing weight names which
will be shown, or NULL to show all weights.
@slants: a NULL-terminated array of strings containing slant names which
will be shown, or NULL to show all slants.
@setwidths: a NULL-terminated array of strings containing setwidth names which
will be shown, or NULL to show all setwidths.
@spacings: a NULL-terminated array of strings containing spacings which
will be shown, or NULL to show all spacings.
@charsets: a NULL-terminated array of strings containing charset names which
will be shown, or NULL to show all charsets.
<!-- ##### ENUM GtkFontType ##### -->
<para>
A set of bit flags used to specify the type of fonts shown
when calling gtk_font_selection_dialog_set_filter() or
gtk_font_selection_set_filter().
</para>
@GTK_FONT_BITMAP: bitmap fonts.
@GTK_FONT_SCALABLE: scalable fonts.
@GTK_FONT_SCALABLE_BITMAP: scaled bitmap fonts.
@GTK_FONT_ALL: a bitwise combination of all of the above.
<!-- ##### ENUM GtkFontFilterType ##### -->
<para>
A set of bit flags used to specify the filter being set
when calling gtk_font_selection_dialog_set_filter() or
gtk_font_selection_set_filter().
</para>
@GTK_FONT_FILTER_BASE: the base filter, which can't be changed by the user.
@GTK_FONT_FILTER_USER: the user filter, which can be changed from within the
'Filter' page of the #GtkFontSelection widget.

11
docs/reference/gtk/tmpl/gtkframe.sgml
View File

@ -45,6 +45,17 @@ the current label, if any, is removed.
@label:
<!-- ##### FUNCTION gtk_frame_set_label_widget ##### -->
<para>
</para>
@frame:
@label_widget:
<!-- # Unused Parameters # -->
@title_widget:
<!-- ##### FUNCTION gtk_frame_set_label_align ##### -->
<para>
Set the alignment of the Frame widget's label. The

14
docs/reference/gtk/tmpl/gtkhandlebox.sgml
View File

@ -155,3 +155,17 @@ handlebox are detached from the main window.
Determines the shadow type for the handlebox.
</para>
<!-- ##### ARG GtkHandleBox:handle_position ##### -->
<para>
Determines the side of the handlebox where the handle is drawn.
</para>
<!-- ##### ARG GtkHandleBox:snap_edge ##### -->
<para>
Determines the snap edge of a handlebox. The snap edge is
the edge of the detached child that must be aligned
with the corresponding edge of the "ghost" left
behind when the child was detached to reattach
the torn-off window. See gtk_handle_box_set_snap_edge().
</para>

96
docs/reference/gtk/tmpl/gtkimcontext.sgml Normal file
View File

@ -0,0 +1,96 @@
<!-- ##### SECTION Title ##### -->
GtkIMContext
<!-- ##### SECTION Short_Description ##### -->
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### STRUCT GtkIMContext ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_im_context_set_client_window ##### -->
<para>
</para>
@context:
@window:
<!-- ##### FUNCTION gtk_im_context_get_preedit_string ##### -->
<para>
</para>
@context:
@str:
@attrs:
<!-- ##### FUNCTION gtk_im_context_filter_keypress ##### -->
<para>
</para>
@context:
@event:
@Returns:
<!-- ##### FUNCTION gtk_im_context_focus_in ##### -->
<para>
</para>
@context:
<!-- ##### FUNCTION gtk_im_context_focus_out ##### -->
<para>
</para>
@context:
<!-- ##### SIGNAL GtkIMContext::preedit-start ##### -->
<para>
</para>
@imcontext: the object which received the signal.
<!-- ##### SIGNAL GtkIMContext::preedit-end ##### -->
<para>
</para>
@imcontext: the object which received the signal.
<!-- ##### SIGNAL GtkIMContext::preedit-changed ##### -->
<para>
</para>
@imcontext: the object which received the signal.
<!-- ##### SIGNAL GtkIMContext::commit ##### -->
<para>
</para>
@imcontext: the object which received the signal.
@arg1:

30
docs/reference/gtk/tmpl/gtkimmulticontext.sgml Normal file
View File

@ -0,0 +1,30 @@
<!-- ##### SECTION Title ##### -->
GtkIMMulticontext
<!-- ##### SECTION Short_Description ##### -->
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### STRUCT GtkIMMulticontext ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_im_multicontext_new ##### -->
<para>
</para>
@Returns:

32
docs/reference/gtk/tmpl/gtkitemfactory.sgml
View File

@ -136,6 +136,18 @@ GtkItemFactory
@scanner:
<!-- ##### FUNCTION gtk_item_factory_add_foreign ##### -->
<para>
</para>
@accel_widget:
@full_path:
@accel_group:
@keyval:
@modifiers:
<!-- ##### FUNCTION gtk_item_factory_from_widget ##### -->
<para>
@ -154,6 +166,16 @@ GtkItemFactory
@Returns:
<!-- ##### FUNCTION gtk_item_factory_get_item ##### -->
<para>
</para>
@ifactory:
@path:
@Returns:
<!-- ##### FUNCTION gtk_item_factory_get_widget ##### -->
<para>
@ -174,6 +196,16 @@ GtkItemFactory
@Returns:
<!-- ##### FUNCTION gtk_item_factory_get_item_by_action ##### -->
<para>
</para>
@ifactory:
@action:
@Returns:
<!-- ##### FUNCTION gtk_item_factory_dump_items ##### -->
<para>

5
docs/reference/gtk/tmpl/gtklabel.sgml
View File

@ -136,3 +136,8 @@ pointer, it isn't copied.
The #GtkJustification setting. See gtk_label_set_justify() for more info.
</para>
<!-- ##### ARG GtkLabel:wrap ##### -->
<para>
</para>

20
docs/reference/gtk/tmpl/gtklist.sgml
View File

@ -34,21 +34,6 @@ type.</para></listitem>
</para>
@container: the parent class object
@children: a GList with the children of the list; belonging to #GtkListitem
@selection: a GList with selected items of the list
@undo_selection:
@undo_unselection:
@last_focus_child:
@undo_focus_child:
@htimer:
@vtimer:
@anchor:
@drag_pos:
@anchor_state:
@selection_mode: the selection mode of the list
@drag_selection:
@add_mode:
<!-- ##### FUNCTION gtk_list_new ##### -->
<para>
@ -370,3 +355,8 @@ The child @widget has just been unselected.
@list: the object which received the signal.
@widget: the newly unselected child.
<!-- ##### ARG GtkList:selection_mode ##### -->
<para>
</para>

14
docs/reference/gtk/tmpl/gtkmain.sgml
View File

@ -60,7 +60,15 @@ You should call this function before <function>gtk_init</function> to
support internationalization of your GTK+ applications.
</para>
@Returns: A string corresponding to the locale set.
@Returns: A string corresponding to the locale set.
<!-- ##### FUNCTION gtk_get_default_language ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gtk_init ##### -->
@ -247,7 +255,7 @@ the event:
After finishing the delivery the event is popped from the event stack.
</para></listitem>
</orderedlist>
@event: An event to process (normally) passed by Gdk.
@ -259,7 +267,7 @@ cleaned from any arguments that GTK+ handles itself.
</para>
@argc: Pointer to the number of arguments remaining after gtk_init.
@argv: Points to the argument vector.
@argv: Points to the argument vector.
<!-- ##### FUNCTION gtk_true ##### -->

27
docs/reference/gtk/tmpl/gtkmenu.sgml
View File

@ -159,6 +159,33 @@ Set the #GtkAccelGroup which holds global accelerators for the menu.
@accel_group: the #GtkAccelGroup to be associated with the menu.
<!-- ##### FUNCTION gtk_menu_get_accel_group ##### -->
<para>
</para>
@menu:
@Returns:
<!-- ##### FUNCTION gtk_menu_get_uline_accel_group ##### -->
<para>
</para>
@menu:
@Returns:
<!-- ##### FUNCTION gtk_menu_ensure_uline_accel_group ##### -->
<para>
</para>
@menu:
@Returns:
<!-- ##### FUNCTION gtk_menu_set_title ##### -->
<para>
Sets the title string for the menu. The title is displayed when the menu

2
docs/reference/gtk/tmpl/gtkmenuitem.sgml
View File

@ -38,8 +38,6 @@ only a few are really useful.
</para>
@item: the parent class object
@submenu: the submenu attached to this item; read only
<!-- ##### FUNCTION gtk_menu_item_new ##### -->
<para>

8
docs/reference/gtk/tmpl/gtkmenushell.sgml
View File

@ -89,6 +89,14 @@ Selects the menu item from the menu shell.
@menu_item: The #GtkMenuItem to select.
<!-- ##### FUNCTION gtk_menu_shell_deselect ##### -->
<para>
</para>
@menu_shell:
<!-- ##### FUNCTION gtk_menu_shell_activate_item ##### -->
<para>
Activates the menu item within the menu shell.

67
docs/reference/gtk/tmpl/gtknotebook.sgml
View File

@ -27,28 +27,6 @@ place. <!-- TODO: talk about the menu -->
</para>
@container: the parent class object
@cur_page: the currently displayed page
@children: a GList with the children of the notebook; belonging to
#GtkNotebookPage
@first_tab:
@focus_tab:
@menu:
@panel:
@timer:
@tab_hborder:
@tab_vborder:
@show_tabs:
@homogeneous:
@show_border:
@tab_pos:
@scrollable:
@in_child:
@click_child:
@button:
@need_timer:
@child_has_focus:
@have_visible_child:
<!-- ##### MACRO GTK_NOTEBOOK_PAGE ##### -->
<para>
@ -153,7 +131,7 @@ bounds, it is assumed to be the current number of pages.
</para>
@notebook: the notebook widget
@child: the content of the new page
@child: the content of the new page
@tab_label: the bookmark of the page
@menu_label: the menu label of the page
@position: the position to insert the page
@ -273,24 +251,6 @@ Sets whether there should be a border around the bookmarks or not.
@border_width: a boolean value
<!-- ##### FUNCTION gtk_notebook_set_tab_hborder ##### -->
<para>
Sets whether the tabs should have a horizontal border.
</para>
@notebook: the notebook widget
@tab_hborder: a boolean value
<!-- ##### FUNCTION gtk_notebook_set_tab_vborder ##### -->
<para>
Sets whether the tabs should have a vertical border.
</para>
@notebook: the notebook widget
@tab_vborder: a boolean value
<!-- ##### FUNCTION gtk_notebook_popup_enable ##### -->
<para>
Enables the popup menu: if the user clicks with the right mouse button on
@ -357,7 +317,7 @@ Looks for the packing attributes of the bookmarks of @child.
@notebook: the notebook widget
@child: the page
@expand: a pointer to return the expand value (or NULL)
@expand: a pointer to return the expand value (or NULL)
@fill: a pointer to return the fill value (or NULL)
@pack_type: a pointer to return the pack_type (or NULL)
@ -392,6 +352,15 @@ Creates a new label and sets it as the menu label of @child.
@menu_text: the label text
<!-- ##### FUNCTION gtk_notebook_set_tab_hborder ##### -->
<para>
Sets whether the tabs should have a horizontal border.
</para>
@notebook: the notebook widget
@tab_hborder: a boolean value
<!-- ##### FUNCTION gtk_notebook_set_tab_label ##### -->
<para>
Changes the bookmark label of @child. Nothing happens if @child is not in
@ -426,6 +395,15 @@ Creates a new label and sets it as the bookmark label of @child.
@tab_text: the label text
<!-- ##### FUNCTION gtk_notebook_set_tab_vborder ##### -->
<para>
Sets whether the tabs should have a vertical border.
</para>
@notebook: the notebook widget
@tab_vborder: a boolean value
<!-- ##### SIGNAL GtkNotebook::switch-page ##### -->
<para>
Emitted when the user or a function changes the current page.
@ -480,3 +458,8 @@ Whether the bookmarks should be scrollable or not
Whether the popup menu is enabled or not
</para>
<!-- ##### ARG GtkNotebook:homogeneous ##### -->
<para>
</para>

56
docs/reference/gtk/tmpl/gtkobject.sgml
View File

@ -178,39 +178,23 @@ The object itself. You should never use these members directly-
instead you the accessing macros.
</para>
@klass: a pointer to the GtkObjectClass (or deriver) which contains
the methods defined by this object.
@flags: the state of the object: whether it has been constructed
or destroyed, for example.
@ref_count: a reference count. It is incremented when new
pointers to this object are made, and decremented when the
pointers are deleted. When the reference count
returns to 0, the object is deleted. By default, objects
have reference count 0 when created.
@object_data:
<!-- ##### MACRO GTK_OBJECT_TYPE ##### -->
<para>
Get the type of an object.
</para>
@object:
<!-- # Unused Parameters # -->
@obj: the object whose type we wish to get.
<!-- ##### MACRO GTK_OBJECT_SIGNALS ##### -->
<!-- ##### MACRO GTK_OBJECT_TYPE_NAME ##### -->
<para>
Get the array of signals defined for this object.
</para>
@obj: the object to fetch the signals from.
<!-- ##### MACRO GTK_OBJECT_NSIGNALS ##### -->
<para>
Get the number of signals defined by this object.
</para>
@obj: the object to query.
@object:
<!-- ##### ENUM GtkObjectFlags ##### -->
@ -226,6 +210,7 @@ there own references, if they believe they are nearly primary
ownership of the object.
GTK_CONNECTED: refers to whether are signals are connected to this
object.
@GTK_CONNECTED:
@GTK_CONSTRUCTED: refers to whether the arguments for this object are
ready.
@ -452,6 +437,7 @@ Increase the reference count of the object.
</para>
@object: the object to reference.
@Returns:
<!-- ##### FUNCTION gtk_object_unref ##### -->
@ -509,6 +495,16 @@ See gtk_object_unref().
@object: the object to destroy.
<!-- ##### FUNCTION gtk_object_get ##### -->
<para>
</para>
@object:
@first_arg_name:
@Varargs:
<!-- ##### FUNCTION gtk_object_getv ##### -->
<para>
Gets an array of argument values from an object.
@ -540,12 +536,12 @@ void set_box_properties(GtkBox* box)
</informalexample>
</para>
@object: the object whose arguments should be set.
@first_arg_name: the name of the first argument to set.
@Varargs: the value of the first argument, followed optionally
by more name/value pairs, followed by NULL.
<!-- ##### FUNCTION gtk_object_setv ##### -->
<para>
Set an array of arguments.
@ -614,7 +610,6 @@ If you specified a destroy handler with gtk_object_set_data_full(),
it will be invoked.
</para>
@object: the object maintaining the association.
@key: name of the key for that association.
@ -775,6 +770,8 @@ to get an id from a string.
</para>
@object: object containing the associations.
@key_id:
<!-- # Unused Parameters # -->
@data_id: quark of the key.
@ -852,19 +849,6 @@ Query information about an argument type.
It is the caller's responsibility to call g_free() in the event of error.
<!-- ##### FUNCTION gtk_trace_referencing ##### -->
<para>
Private: print debugging information while doing a gtk_object_ref() or
a gtk_object_unref().
</para>
@object: object to reference or unreference.
@func: name of caller's function to print (used within macros).
@dummy: unused.
@line: line number (used within macros).
@do_ref: whether to reference or unreference.
<!-- ##### SIGNAL GtkObject::destroy ##### -->
<para>
Indicates that an object is being destroyed.

9
docs/reference/gtk/tmpl/gtkoptionmenu.sgml
View File

@ -69,3 +69,12 @@ selected value for the option menu.
0 to n-1.
<!-- ##### FUNCTION gtk_option_menu_get_history ##### -->
<para>
</para>
@option_menu:
@Returns:

42
docs/reference/gtk/tmpl/gtkpaned.sgml
View File

@ -73,7 +73,6 @@ gtk_widget_set_usize (frame1, 50, -1);
</para>
@handle_size:
@gutter_size:
<!-- ##### FUNCTION gtk_paned_add1 ##### -->
<para>
@ -114,17 +113,8 @@ Old name for gtk_paned_set_handle_size()
Old name for gtk_paned_set_gutter_size()
</para>
<!-- ##### FUNCTION gtk_paned_compute_position ##### -->
<para>
Internal function used by #GtkHPaned and #GtkVPaned
</para>
@paned:
@allocation:
@child1_req:
@child2_req:
@p:
@s:
<!-- ##### FUNCTION gtk_paned_pack1 ##### -->
@ -149,11 +139,14 @@ Add a child to the bottom or right pane.
@shrink: can this child be made smaller than its requsition.
<!-- ##### FUNCTION gtk_paned_set_gutter_size ##### -->
<!-- ##### MACRO gtk_paned_set_gutter_size ##### -->
<para>
Set the width of the gutter. (The area between the two panes).
</para>
@p:
@s:
<!-- # Unused Parameters # -->
@paned: a paned widget
@size: the width of the widget in pixels
@ -169,13 +162,24 @@ Set the the handle size to @size x @size pixels.
<!-- ##### FUNCTION gtk_paned_set_position ##### -->
<para>
Set the position of the separator, as if set by the user.
If position is negative, the remembered position is
forgotten, and the division is recomputed from the
the requisitions of the children.
</para>
@paned: a paned widget
@position: the new position of the separator.
@paned:
@position:
<!-- ##### FUNCTION gtk_paned_get_position ##### -->
<para>
</para>
@paned:
@Returns:
<!-- ##### ARG GtkPaned:handle_size ##### -->
<para>
</para>

7
docs/reference/gtk/tmpl/gtkpreview.sgml
View File

@ -254,3 +254,10 @@ once used for changing the colormap and visual on the fly.
<!-- ##### ARG GtkPreview:expand ##### -->
<para>
Determines the way that the the preview widget behaves
when the size it is allocated is larger than the requested
size. See gtk_preview_set_expand().
</para>

120
docs/reference/gtk/tmpl/gtkprivate.sgml
View File

@ -1,120 +0,0 @@
<!-- ##### SECTION Title ##### -->
Private Information
<!-- ##### SECTION Short_Description ##### -->
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### ENUM GtkPrivateFlags ##### -->
<para>
</para>
@PRIVATE_GTK_USER_STYLE:
@PRIVATE_GTK_REDRAW_PENDING:
@PRIVATE_GTK_RESIZE_PENDING:
@PRIVATE_GTK_RESIZE_NEEDED:
@PRIVATE_GTK_LEAVE_PENDING:
@PRIVATE_GTK_HAS_SHAPE_MASK:
@PRIVATE_GTK_IN_REPARENT:
@PRIVATE_GTK_IS_OFFSCREEN:
<!-- ##### MACRO GTK_PRIVATE_FLAGS ##### -->
<para>
</para>
@wid:
<!-- ##### MACRO GTK_WIDGET_USER_STYLE ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_WIDGET_REDRAW_PENDING ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_CONTAINER_RESIZE_PENDING ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_WIDGET_RESIZE_NEEDED ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_WIDGET_LEAVE_PENDING ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_WIDGET_HAS_SHAPE_MASK ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_WIDGET_IN_REPARENT ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_WIDGET_IS_OFFSCREEN ##### -->
<para>
</para>
@obj:
<!-- ##### MACRO GTK_PRIVATE_SET_FLAG ##### -->
<para>
</para>
@wid:
@flag:
<!-- ##### MACRO GTK_PRIVATE_UNSET_FLAG ##### -->
<para>
</para>
@wid:
@flag:

4
docs/reference/gtk/tmpl/gtkprogress.sgml
View File

@ -10,6 +10,7 @@ A #GtkProgress is the abstract base class used to derive
a #GtkProgressBar which provides a visual representation of
the progress of a long running operation.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
@ -21,6 +22,7 @@ The #GtkProgress-struct struct contains private data only.
and should be accessed using the functions below.
</para>
<!-- ##### FUNCTION gtk_progress_set_show_text ##### -->
<para>
Controls whether progress text is shown.
@ -30,6 +32,7 @@ Controls whether progress text is shown.
@show_text: a boolean indicating whether the progress text
is shown.
<!-- ##### FUNCTION gtk_progress_set_text_alignment ##### -->
<para>
Controls the alignment of the text within the progress bar area.
@ -202,3 +205,4 @@ A number between 0.0 and 1.0 specifying the horizontal alignment.
<para>
A number between 0.0 and 1.0 specifying the vertical alignment.
</para>

53
docs/reference/gtk/tmpl/gtkprogressbar.sgml
View File

@ -69,6 +69,9 @@ An enumeration representing the styles for drawing the progress bar.
</tbody></tgroup></informaltable>
</para>
@GTK_PROGRESS_CONTINUOUS:
@GTK_PROGRESS_DISCRETE:
<!-- ##### ENUM GtkProgressBarOrientation ##### -->
<para>
An enumeration representing possible orientations and growth
@ -101,6 +104,11 @@ directions for the visible progress bar.
</tbody></tgroup></informaltable>
</para>
@GTK_PROGRESS_LEFT_TO_RIGHT:
@GTK_PROGRESS_RIGHT_TO_LEFT:
@GTK_PROGRESS_BOTTOM_TO_TOP:
@GTK_PROGRESS_TOP_TO_BOTTOM:
<!-- ##### FUNCTION gtk_progress_bar_new ##### -->
<para>
Creates a new #GtkProgressBar.
@ -109,6 +117,41 @@ Creates a new #GtkProgressBar.
@Returns: a #GtkProgressBar.
<!-- ##### FUNCTION gtk_progress_bar_pulse ##### -->
<para>
</para>
@pbar:
<!-- ##### FUNCTION gtk_progress_bar_set_text ##### -->
<para>
</para>
@pbar:
@text:
<!-- ##### FUNCTION gtk_progress_bar_set_fraction ##### -->
<para>
</para>
@pbar:
@fraction:
<!-- ##### FUNCTION gtk_progress_bar_set_pulse_step ##### -->
<para>
</para>
@pbar:
@fraction:
<!-- ##### FUNCTION gtk_progress_bar_new_with_adjustment ##### -->
<para>
Creates a new #GtkProgressBar with an associated #GtkAdjustment.
@ -216,3 +259,13 @@ The number of blocks which which make up progress bar
when it is shown in %GTK_PROGRESS_DISCRETE style.
</para>
<!-- ##### ARG GtkProgressBar:fraction ##### -->
<para>
</para>
<!-- ##### ARG GtkProgressBar:pulse_step ##### -->
<para>
</para>

1
docs/reference/gtk/tmpl/gtkradiomenuitem.sgml
View File

@ -13,7 +13,6 @@ instant exactly one of the radio menu items from a group is selected.
The correct way to create a group of radio menu items is aproximativly
this:
</para>
<para>
<example>
<title>How to create a group of radio menu items.</title>
<programlisting>

36
docs/reference/gtk/tmpl/gtkrc.sgml
View File

@ -424,18 +424,23 @@ This can later be composited together with other
#GtkRcStyle structures to form a #GtkStyle.
</para>
@parent_instance:
@name:
@font_name:
@fontset_name:
@bg_pixmap_name:
@font_desc:
@color_flags:
@fg:
@bg:
@text:
@base:
@engine:
@engine_data:
@ref_count:
@xthickness:
@ythickness:
<!-- ##### STRUCT GtkRcStyleClass ##### -->
<para>
</para>
<!-- ##### ENUM GtkRcFlags ##### -->
<para>
@ -510,10 +515,13 @@ specific portions of a RC file.
@GTK_RC_TOKEN_INSENSITIVE:
@GTK_RC_TOKEN_FG:
@GTK_RC_TOKEN_BG:
@GTK_RC_TOKEN_BASE:
@GTK_RC_TOKEN_TEXT:
@GTK_RC_TOKEN_BASE:
@GTK_RC_TOKEN_XTHICKNESS:
@GTK_RC_TOKEN_YTHICKNESS:
@GTK_RC_TOKEN_FONT:
@GTK_RC_TOKEN_FONTSET:
@GTK_RC_TOKEN_FONT_NAME:
@GTK_RC_TOKEN_BG_PIXMAP:
@GTK_RC_TOKEN_PIXMAP_PATH:
@GTK_RC_TOKEN_STYLE:
@ -756,6 +764,15 @@ a reference count of 1.
@Returns: the newly create #GtkRcStyle
<!-- ##### FUNCTION gtk_rc_style_copy ##### -->
<para>
</para>
@orig:
@Returns:
<!-- ##### FUNCTION gtk_rc_style_ref ##### -->
<para>
Increment the reference count of a #GtkRcStyle.
@ -773,10 +790,3 @@ free if the result is 0.
@rc_style: a #GtkRcStyle
<!-- ##### FUNCTION gtk_rc_init ##### -->
<para>
Internal function.
</para>

20
docs/reference/gtk/tmpl/gtkruler.sgml
View File

@ -60,3 +60,23 @@ This sets the range of the ruler using gfloat lower, gfloat upper, gfloat positi
@max_size: the maximum size of the ruler
<!-- ##### ARG GtkRuler:lower ##### -->
<para>
</para>
<!-- ##### ARG GtkRuler:upper ##### -->
<para>
</para>
<!-- ##### ARG GtkRuler:position ##### -->
<para>
</para>
<!-- ##### ARG GtkRuler:max_size ##### -->
<para>
</para>

Some files were not shown because too many files have changed in this diff Show More