From 906a8784bae894efa99c5e8e98ff330cf57a434c Mon Sep 17 00:00:00 2001 From: Sven Neumann Date: Fri, 8 Mar 2002 12:36:40 +0000 Subject: [PATCH] Handle gtk-doc just like GTK+ does it now: 2002-03-08 Sven Neumann Handle gtk-doc just like GTK+ does it now: * configure.in: check for gtk-doc version 0.9. Do not build the API reference by default. * autogen.sh: pass --enable-gtk-doc to configure. * Makefile.am: Added a slightly modified distcheck rule that passes --enable-gtk-doc to the configure inside. * NEWS: updated. Revival of the API reference framework. Misc fixes. --- ChangeLog | 14 + Makefile.am | 24 + NEWS | 2 + autogen.sh | 12 +- configure.in | 45 +- devel-docs/ChangeLog | 63 + devel-docs/libgimp/.cvsignore | 7 +- devel-docs/libgimp/Makefile.am | 199 +- devel-docs/libgimp/libgimp-decl.txt | 2725 ----------------- devel-docs/libgimp/libgimp.args | 0 devel-docs/libgimp/libgimp.hierarchy | 21 - devel-docs/libgimp/libgimp.signals | 0 devel-docs/libgimp/libgimp.types | 5 - devel-docs/libgimp/tmpl/gimp.sgml | 16 - .../libgimp/tmpl/gimpcolorselector.sgml | 4 +- devel-docs/libgimp/tmpl/gimpdrawable.sgml | 2 +- devel-docs/libgimp/tmpl/gimpenums.sgml | 43 +- devel-docs/libgimp/tmpl/gimpgradients.sgml | 2 +- devel-docs/libgimp/tmpl/gimpmenu.sgml | 4 +- devel-docs/libgimp/tmpl/gimptools.sgml | 15 +- devel-docs/libgimpbase/.cvsignore | 7 +- devel-docs/libgimpbase/Makefile.am | 194 +- devel-docs/libgimpbase/libgimpbase-decl.txt | 773 ----- devel-docs/libgimpbase/libgimpbase-include.c | 15 - devel-docs/libgimpbase/libgimpbase.args | 0 devel-docs/libgimpbase/libgimpbase.hierarchy | 21 - devel-docs/libgimpbase/libgimpbase.signals | 0 devel-docs/libgimpbase/libgimpbase.types | 3 - devel-docs/libgimpbase/tmpl/gimpprotocol.sgml | 2 +- devel-docs/libgimpbase/tmpl/gimputils.sgml | 19 - devel-docs/libgimpcolor/.cvsignore | 7 +- devel-docs/libgimpcolor/Makefile.am | 194 +- devel-docs/libgimpcolor/libgimpcolor-decl.txt | 306 -- .../libgimpcolor/libgimpcolor-include.c | 15 - devel-docs/libgimpcolor/libgimpcolor.args | 0 .../libgimpcolor/libgimpcolor.hierarchy | 21 - devel-docs/libgimpcolor/libgimpcolor.signals | 0 devel-docs/libgimpcolor/libgimpcolor.types | 3 - devel-docs/libgimpmath/.cvsignore | 7 +- devel-docs/libgimpmath/Makefile.am | 194 +- devel-docs/libgimpmath/libgimpmath-decl.txt | 396 --- devel-docs/libgimpmath/libgimpmath-include.c | 15 - devel-docs/libgimpmath/libgimpmath.args | 0 devel-docs/libgimpmath/libgimpmath.hierarchy | 21 - devel-docs/libgimpmath/libgimpmath.signals | 0 devel-docs/libgimpmath/libgimpmath.types | 3 - devel-docs/libgimpmath/tmpl/gimpmath.sgml | 28 - devel-docs/libgimpwidgets/.cvsignore | 7 +- devel-docs/libgimpwidgets/Makefile.am | 208 +- .../libgimpwidgets/libgimpwidgets-decl.txt | 1001 ------ devel-docs/libgimpwidgets/libgimpwidgets.args | 0 .../libgimpwidgets/libgimpwidgets.hierarchy | 35 - .../libgimpwidgets/libgimpwidgets.signals | 48 - .../libgimpwidgets/libgimpwidgets.types | 1 + .../libgimpwidgets/tmpl/gimpchainbutton.sgml | 2 + .../libgimpwidgets/tmpl/gimpcolorbutton.sgml | 2 + .../libgimpwidgets/tmpl/gimpdialog.sgml | 8 - .../libgimpwidgets/tmpl/gimphelpui.sgml | 10 - .../libgimpwidgets/tmpl/gimpquerybox.sgml | 4 +- .../libgimpwidgets/tmpl/gimpsizeentry.sgml | 18 +- .../libgimpwidgets/tmpl/gimpwidgets.sgml | 21 +- .../libgimpwidgets/tmpl/gimpwidgetstypes.sgml | 2 +- po/ChangeLog | 4 + po/POTFILES.in | 1 + tips/ChangeLog | 1 + tips/Makefile.am | 1 - tips/gimp_tips.txt | 181 -- 67 files changed, 936 insertions(+), 6066 deletions(-) delete mode 100644 devel-docs/libgimp/libgimp-decl.txt delete mode 100644 devel-docs/libgimp/libgimp.args delete mode 100644 devel-docs/libgimp/libgimp.hierarchy delete mode 100644 devel-docs/libgimp/libgimp.signals delete mode 100644 devel-docs/libgimpbase/libgimpbase-decl.txt delete mode 100644 devel-docs/libgimpbase/libgimpbase-include.c delete mode 100644 devel-docs/libgimpbase/libgimpbase.args delete mode 100644 devel-docs/libgimpbase/libgimpbase.hierarchy delete mode 100644 devel-docs/libgimpbase/libgimpbase.signals delete mode 100644 devel-docs/libgimpcolor/libgimpcolor-decl.txt delete mode 100644 devel-docs/libgimpcolor/libgimpcolor-include.c delete mode 100644 devel-docs/libgimpcolor/libgimpcolor.args delete mode 100644 devel-docs/libgimpcolor/libgimpcolor.hierarchy delete mode 100644 devel-docs/libgimpcolor/libgimpcolor.signals delete mode 100644 devel-docs/libgimpmath/libgimpmath-decl.txt delete mode 100644 devel-docs/libgimpmath/libgimpmath-include.c delete mode 100644 devel-docs/libgimpmath/libgimpmath.args delete mode 100644 devel-docs/libgimpmath/libgimpmath.hierarchy delete mode 100644 devel-docs/libgimpmath/libgimpmath.signals delete mode 100644 devel-docs/libgimpwidgets/libgimpwidgets-decl.txt delete mode 100644 devel-docs/libgimpwidgets/libgimpwidgets.args delete mode 100644 devel-docs/libgimpwidgets/libgimpwidgets.hierarchy delete mode 100644 devel-docs/libgimpwidgets/libgimpwidgets.signals delete mode 100644 tips/gimp_tips.txt diff --git a/ChangeLog b/ChangeLog index 8e3949eb83..d4d4454aef 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,17 @@ +2002-03-08 Sven Neumann + + Handle gtk-doc just like GTK+ does it now: + + * configure.in: check for gtk-doc version 0.9. Do not build the API + reference by default. + + * autogen.sh: pass --enable-gtk-doc to configure. + + * Makefile.am: Added a slightly modified distcheck rule that passes + --enable-gtk-doc to the configure inside. + + * NEWS: updated. + 2002-03-08 Michael Natterer * app/core/core-types.h: added GimpPaletteEntry typedef. diff --git a/Makefile.am b/Makefile.am index 0c7229f59f..319825d2b7 100644 --- a/Makefile.am +++ b/Makefile.am @@ -74,3 +74,27 @@ uninstall-local: if DEFAULT_BINARY rm -f $(DESTDIR)$(bindir)/gimptool endif + +# This is a version of the automake-1.4 distcheck rule modified +# to pass --enable-gtk-doc to ./configure +# +mydistcheck: dist + -rm -rf $(distdir) + GZIP=$(GZIP_ENV) $(TAR) zxf $(distdir).tar.gz + mkdir $(distdir)/=build + mkdir $(distdir)/=inst + dc_install_base=`cd $(distdir)/=inst && pwd`; \ + cd $(distdir)/=build \ + && ../configure --srcdir=.. --prefix=$$dc_install_base --enable-gtk-doc \ + && $(MAKE) $(AM_MAKEFLAGS) \ + && $(MAKE) $(AM_MAKEFLAGS) dvi \ + && $(MAKE) $(AM_MAKEFLAGS) check \ + && $(MAKE) $(AM_MAKEFLAGS) install \ + && $(MAKE) $(AM_MAKEFLAGS) installcheck \ + && $(MAKE) $(AM_MAKEFLAGS) dist + -rm -rf $(distdir) + @banner="$(distdir).tar.gz is ready for distribution"; \ + dashes=`echo "$$banner" | sed s/./=/g`; \ + echo "$$dashes"; \ + echo "$$banner"; \ + echo "$$dashes" diff --git a/NEWS b/NEWS index a698d10f7d..5bc7d61133 100644 --- a/NEWS +++ b/NEWS @@ -30,6 +30,8 @@ Overview of Changes in GIMP 1.3.4 - Added GimpItem class to generalize core code even further [Mitch] - Improved preferences dialog [Mitch, Sven, Jimmac] - New tool icons [Jimmac] +- Editor widgets for brushes, gradients and palettes [Mitch] +- Revival of the API reference [Sven] - Bugfixes - More stuff not mentioned here (see the ChangeLog) diff --git a/autogen.sh b/autogen.sh index fe08b78d62..ce325f7cea 100755 --- a/autogen.sh +++ b/autogen.sh @@ -53,7 +53,7 @@ echo "automake, glib-gettextize and intltoolize. This test is not foolproof," echo "so if anything goes wrong, see the file HACKING for more information..." echo -echo "Testing libtool... " +echo -n "Testing libtool... " VER=`libtoolize --version | grep libtool | sed "s/.* \([0-9.]*\)[-a-z0-9]*$/\1/"` if expr $VER \>= 1.3.4 >/dev/null; then echo "looks OK." @@ -62,7 +62,7 @@ else DIE=1 fi -echo "Testing autoconf... " +echo -n "Testing autoconf... " VER=`autoconf --version | grep -iw autoconf | sed "s/.* \([0-9.]*\)[-a-z0-9]*$/\1/"` if expr $VER \>= 2.13 >/dev/null; then echo "looks OK." @@ -71,7 +71,7 @@ else DIE=1 fi -echo "Testing automake... " +echo -n "Testing automake... " VER=`automake --version | grep automake | sed "s/.* \([0-9.]*\)[-a-z0-9]*$/\1/"` if expr $VER \>= 1.4 >/dev/null; then echo "looks OK." @@ -80,7 +80,7 @@ else DIE=1 fi -echo "Testing glib-gettextize... " +echo -n "Testing glib-gettextize... " VER=`glib-gettextize --version | grep glib-gettextize | sed "s/.* \([0-9.]*\)/\1/"` if expr $VER \>= 1.3.14 >/dev/null; then echo "looks OK." @@ -89,7 +89,7 @@ else DIE=1 fi -echo "Testing intltoolize... " +echo -n "Testing intltoolize... " VER=`intltoolize --version | grep intltoolize | sed "s/.* \([0-9.]*\)/\1/"` if expr $VER \>= 0.17 >/dev/null; then echo "looks OK." @@ -151,7 +151,7 @@ intltoolize --copy --force --automake cd $ORIGDIR -$srcdir/configure --enable-maintainer-mode "$@" +$srcdir/configure --enable-maintainer-mode --enable-gtk-doc "$@" echo echo "Now type 'make' to compile $PROJECT." diff --git a/configure.in b/configure.in index eb6be38837..1ad2fdb11c 100644 --- a/configure.in +++ b/configure.in @@ -5,7 +5,7 @@ AC_INIT(etc/gimprc.in) GLIB_REQUIRED_VERSION=1.3.15 GTK_REQUIRED_VERSION=$GLIB_REQUIRED_VERSION PANGOFT2_REQUIRED_VERSION=0.26 -GTKDOC_REQUIRED_VERSION=0.6 +GTKDOC_REQUIRED_VERSION=0.9 # # Making releases: @@ -613,8 +613,23 @@ localedir='${prefix}/${DATADIRNAME}/locale' dnl This is for generating PDB docuemntation. AC_PATH_PROGS(EMACS, emacs xemacs, :) -dnl This is for the developers documentation. + +################################################## +# 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) + if $GTKDOC ; then gtk_doc_version=`gtkdoc-mkdb --version` AC_MSG_CHECKING([gtk-doc version ($gtk_doc_version) >= $GTKDOC_REQUIRED_VERSION]) @@ -629,28 +644,22 @@ EOF fi fi -dnl Let people disable the gtk-doc stuff. -AC_ARG_ENABLE(gtk-doc, [ --enable-gtk-doc use gtk-doc to build documentation [default=auto]], enable_gtk_doc="$enableval", enable_gtk_doc=auto) +AC_CHECK_PROG(DB2HTML, db2html, true, false) +AM_CONDITIONAL(HAVE_DOCBOOK, $DB2HTML) -if test x$enable_gtk_doc = xauto ; then - if test x$GTKDOC = xtrue ; then - enable_gtk_doc=yes - else - enable_gtk_doc=no +dnl Make people enable the gtk-doc stuff explicitely. +AC_ARG_ENABLE(gtk-doc, [ --enable-gtk-doc use gtk-doc to build documentation [default=no]], enable_gtk_doc="$enableval", enable_gtk_doc=auto) + +if test x$enable_gtk_doc = xyes ; then + if test x$GTKDOC != xtrue ; then + enable_gtk_doc=no fi fi +dnl NOTE: We need to use a separate automake conditional for this +dnl to make this work with the tarballs. AM_CONDITIONAL(ENABLE_GTK_DOC, test x$enable_gtk_doc = xyes) -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) - dnl This is for the mail plug-in sendmail_path=":" diff --git a/devel-docs/ChangeLog b/devel-docs/ChangeLog index 9909de5bbf..40dcf2e42d 100644 --- a/devel-docs/ChangeLog +++ b/devel-docs/ChangeLog @@ -1,3 +1,66 @@ +2002-03-08 Sven Neumann + + Revival of the API reference for GIMP-1.3. Needs more tweaking ... + + * libgimp/Makefile.am + * libgimp/libgimp.types + * libgimpbase/Makefile.am + * libgimpbase/libgimpbase.types + * libgimpcolor/Makefile.am + * libgimpcolor/libgimpcolor.types + * libgimpmath/Makefile.am + * libgimpmath/libgimpmath.types + * libgimpwidgets/Makefile.am + * libgimpwidgets/libgimpwidgets.types: updated. + + * libgimpbase/libgimp-include.c + * libgimp/libgimp-decl.txt + * libgimp/libgimp.args + * libgimp/libgimp.hierarchy + * libgimp/libgimp.signals: removed from CVS. + + * libgimpbase/libgimpbase-include.c + * libgimpbase/libgimpbase-decl.txt + * libgimpbase/libgimpbase.args + * libgimpbase/libgimpbase.hierarchy + * libgimpbase/libgimpbase.signals: removed from CVS. + + * libgimpcolor/libgimpcolor-include.c + * libgimpcolor/libgimpcolor-decl.txt + * libgimpcolor/libgimpcolor.args + * libgimpcolor/libgimpcolor.hierarchy + * libgimpcolor/libgimpcolor.signals: removed from CVS. + + * libgimpmath/libgimpmath-include.c + * libgimpmath/libgimpmath-decl.txt + * libgimpmath/libgimpmath.args + * libgimpmath/libgimpmath.hierarchy + * libgimpmath/libgimpmath.signals: removed from CVS. + + * libgimpwidgets/libgimpwidgets-decl.txt + * libgimpwidgets/libgimpwidgets.args + * libgimpwidgets/libgimpwidgets.hierarchy + * libgimpwidgets/libgimpwidgets.signals: removed from CVS. + + * libgimp/tmpl/gimp.sgml + * libgimp/tmpl/gimpcolorselector.sgml + * libgimp/tmpl/gimpdrawable.sgml + * libgimp/tmpl/gimpenums.sgml + * libgimp/tmpl/gimpgradients.sgml + * libgimp/tmpl/gimpmenu.sgml + * libgimp/tmpl/gimptools.sgml + * libgimpbase/tmpl/gimpprotocol.sgml + * libgimpbase/tmpl/gimputils.sgml + * libgimpmath/tmpl/gimpmath.sgml + * libgimpmathwidgets/tmpl/gimpchainbutton.sgml + * libgimpmathwidgets/tmpl/gimpcolorbutton.sgml + * libgimpmathwidgets/tmpl/gimpdialog.sgml + * libgimpmathwidgets/tmpl/gimphelpui.sgml + * libgimpmathwidgets/tmpl/gimpquerybox.sgml + * libgimpmathwidgets/tmpl/gimpsizeentry.sgml + * libgimpmathwidgets/tmpl/gimpwidgets.sgml + * libgimpmathwidgets/tmpl/gimpwidgetstypes.sgml: regenerated. + 2001-06-08 Michael Natterer * Makefile.am diff --git a/devel-docs/libgimp/.cvsignore b/devel-docs/libgimp/.cvsignore index 9fe1361957..0b69da0543 100644 --- a/devel-docs/libgimp/.cvsignore +++ b/devel-docs/libgimp/.cvsignore @@ -1,7 +1,12 @@ Makefile Makefile.in -libgimp.html +libgimp.args +libgimp.hierarchy +libgimp.signals +libgimp-decl.txt libgimp-decl-list.txt libgimp-unused.txt +libgimp-undocumented.txt html sgml +*.stamp diff --git a/devel-docs/libgimp/Makefile.am b/devel-docs/libgimp/Makefile.am index 1e757fd93c..8f57dad089 100644 --- a/devel-docs/libgimp/Makefile.am +++ b/devel-docs/libgimp/Makefile.am @@ -1,73 +1,152 @@ ## Process this file with automake to produce Makefile.in # The name of the module. -DOC_MODULE=libgimp +DOC_MODULE = libgimp # The top-level SGML file. -DOC_MAIN_SGML_FILE=libgimp-docs.sgml +DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml -# The directory containing the source code (if it contains documentation). -DOC_SOURCE_DIR=$(top_srcdir)/libgimp +# The directory containing the source code. +DOC_SOURCE_DIR = $(top_srcdir)/$(DOC_MODULE) -CFLAGS=`gimptool-1.4 --cflags` -LDFLAGS=`gimptool-1.4 --libs` +# Extra options to pass to gtkdoc-scangobj +SCANGOBJ_OPTIONS = + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS = + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS = + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS = --extra-dir=../libgimpbase/html --extra-dir=../libgimpcolor/html --extra-dir=../libgimpmath/html --extra-dir=../libgimpwidgets/html + +# Used for dependencies +HFILE_GLOB = $(DOC_SOURCE_DIR)/*.h +CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c + +# Header files to ignore when scanning +IGNORE_HFILES = \ + gimpintl.h \ + libgimp-intl.h \ + stdplugins-intl.h \ + gserialize.h + +# Images to copy into HTML directory +HTML_IMAGES= + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE) +content_files = + +# Other files to distribute +extra_files = + +# CFLAGS and LDFLAGS for compiling scan program. Only needed +# if $(DOC_MODULE).types is non-empty. +GTKDOC_CFLAGS = +GTKDOC_LIBS = + +GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) +GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) + + +#################################### +# Everything below here is generic # +#################################### + +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) -libgimp_docdir = $(HTML_DIR) - -EXTRA_DIST = \ - $(DOC_MAIN_SGML_FILE) \ - $(DOC_MODULE).hierarchy \ - $(DOC_MODULE).signals \ +EXTRA_DIST = \ + $(content_files) \ + $(extra_files) \ + $(HTML_IMAGES) \ + $(DOC_MAIN_SGML_FILE) \ $(DOC_MODULE).types \ - $(DOC_MODULE)-include.c \ - $(DOC_MODULE)-decl.txt \ $(DOC_MODULE)-sections.txt +DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \ + $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).signals + if ENABLE_GTK_DOC -html/index.html: sgml/libgimp-doc.bottom - $(MAKE) html -else -html/index.html: +all-local: html-build.stamp + +#### scan #### + +scan-build.stamp: $(HFILE_GLOB) + @echo '*** Scanning header files ***' + if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ + else \ + cd $(srcdir) ; \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + cd $(srcdir) && \ + gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES) + touch scan-build.stamp + +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp + @true + +#### templates #### + +tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt + @echo '*** Rebuilding template files ***' + cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) + touch tmpl-build.stamp + +tmpl.stamp: tmpl-build.stamp + @true + +#### sgml #### + +sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml + @echo '*** Building SGML ***' + cd $(srcdir) && \ + gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS) + touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo '*** Building HTML ***' + rm -rf $(srcdir)/html + mkdir $(srcdir)/html + cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) + @echo '-- Fixing Crossreferences' + cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + touch html-build.stamp endif -sgml/libgimp-doc.bottom: $(tmpl_sources) - $(MAKE) sgml - -scan: - -(cd $(srcdir) \ - && env \ - CFLAGS="$(CFLAGS)" \ - CPPFLAGS="$(CPPFLAGS)" \ - LDFLAGS="$(LDFLAGS)" \ - gtkdoc-scanobj --module=$(DOC_MODULE) \ - && gtkdoc-scan \ - --module=$(DOC_MODULE) \ - --source-dir=$(DOC_SOURCE_DIR) \ - --ignore-headers="gimpintl.h libgimp-intl.h stdplugins-intl.h gserialize.h") - -templates: scan - cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) - -sgml: - cd $(srcdir) \ - && gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) - -html: - test -d $(srcdir)/html || mkdir $(srcdir)/html - -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) +############## clean-local: - rm -f *~ *.bak *-unused.txt + rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) maintainer-clean-local: clean - cd $(srcdir) && 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-data-local: $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - (installfiles=`echo $(srcdir)/html/*.html`; \ - if test "$$installfiles" = '$(srcdir)/html/*.html'; \ + (installfiles=`echo $(srcdir)/html/*`; \ + if test "$$installfiles" = '$(srcdir)/html/*'; \ then echo '-- Nothing to install' ; \ else \ for i in $$installfiles; do \ @@ -76,17 +155,25 @@ 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: - mkdir $(distdir)/html - mkdir $(distdir)/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-check-gtkdoc dist-hook-local mkdir $(distdir)/tmpl - -cp $(srcdir)/html/*.html $(srcdir)/html/index.sgml $(distdir)/html + mkdir $(distdir)/sgml + mkdir $(distdir)/html -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml - -cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml + -cp $(srcdir)/html/* $(distdir)/html -.PHONY : html sgml templates scan +.PHONY : dist-hook-local diff --git a/devel-docs/libgimp/libgimp-decl.txt b/devel-docs/libgimp/libgimp-decl.txt deleted file mode 100644 index 096f48af9f..0000000000 --- a/devel-docs/libgimp/libgimp-decl.txt +++ /dev/null @@ -1,2725 +0,0 @@ - -GIMPVAR -# define GIMPVAR __declspec(dllexport) - - -GIMPVAR -# define GIMPVAR extern __declspec(dllimport) - - -GIMPVAR -# define GIMPVAR extern - - -gimp_get_data -#define gimp_get_data gimp_procedural_db_get_data - - -gimp_get_data_size -#define gimp_get_data_size gimp_procedural_db_get_data_size - - -gimp_set_data -#define gimp_set_data gimp_procedural_db_set_data - - -gimp_major_version -extern guint gimp_major_version; - - -gimp_minor_version -extern guint gimp_minor_version; - - -gimp_micro_version -extern guint gimp_micro_version; - - -GimpInitProc -void -void - - -GimpQuitProc -void -void - - -GimpQueryProc -void -void - - -GimpRunProc -void -gchar *name, - gint nparams, - GimpParam *param, - gint *nreturn_vals, - GimpParam **return_vals - - -GimpPlugInInfo -struct GimpPlugInInfo -{ - /* called when the gimp application initially starts up */ - GimpInitProc init_proc; - - /* called when the gimp application exits */ - GimpQuitProc quit_proc; - - /* called by the gimp so that the plug-in can inform the - * gimp of what it does. (ie. installing a procedure database - * procedure). - */ - GimpQueryProc query_proc; - - /* called to run a procedure the plug-in installed in the - * procedure database. - */ - GimpRunProc run_proc; -}; - - -GimpParamDef -struct GimpParamDef -{ - GimpPDBArgType type; - gchar *name; - gchar *description; -}; - - -GimpParamRegion -struct GimpParamRegion -{ - gint32 x; - gint32 y; - gint32 width; - gint32 height; -}; - - -GimpParamData -union GimpParamData -{ - gint32 d_int32; - gint16 d_int16; - gint8 d_int8; - gdouble d_float; - gchar *d_string; - gint32 *d_int32array; - gint16 *d_int16array; - gint8 *d_int8array; - gdouble *d_floatarray; - gchar **d_stringarray; - GimpRGB d_color; - GimpParamRegion d_region; - gint32 d_display; - gint32 d_image; - gint32 d_layer; - gint32 d_layer_mask; - gint32 d_channel; - gint32 d_drawable; - gint32 d_selection; - gint32 d_boundary; - gint32 d_path; - gint32 d_unit; - GimpParasite d_parasite; - gint32 d_tattoo; - GimpPDBStatusType d_status; -}; - - -GimpParam -struct GimpParam -{ - GimpPDBArgType type; - GimpParamData data; -}; - - -set_gimp_PLUG_IN_INFO_PTR -void -GimpPlugInInfo * - - -MAIN -# define MAIN() \ - static int \ - win32_gimp_main (int argc, char **argv) \ - { \ - set_gimp_PLUG_IN_INFO_PTR(&PLUG_IN_INFO); \ - return gimp_main (argc, argv); \ - } \ - \ - struct HINSTANCE__; \ - int _stdcall \ - WinMain (struct HINSTANCE__ *hInstance, \ - struct HINSTANCE__ *hPrevInstance, \ - char *lpszCmdLine, \ - int nCmdShow) \ - { \ - return win32_gimp_main (__argc, __argv); \ - } \ - \ - int \ - main (int argc, char *argv[]) \ - { \ - return win32_gimp_main (argc, argv); \ - } - - -MAIN -# define MAIN() \ - int \ - main (int argc, char *argv[]) \ - { \ - return gimp_main (argc, argv); \ - } - - -MAIN -# define MAIN() \ - int \ - main (int argc, char *argv[]) \ - { \ - set_gimp_PLUG_IN_INFO(&PLUG_IN_INFO); \ - return gimp_main (argc, argv); \ - } - - -gimp_main -gint -gint argc,gchar *argv[] - - -gimp_default_display -gint32 -void - - -gimp_install_procedure -void -gchar *name,gchar *blurb,gchar *help,gchar *author,gchar *copyright,gchar *date,gchar *menu_path,gchar *image_types,gint type,gint nparams,gint nreturn_vals,GimpParamDef *params,GimpParamDef *return_vals - - -gimp_install_temp_proc -void -gchar *name,gchar *blurb,gchar *help,gchar *author,gchar *copyright,gchar *date,gchar *menu_path,gchar *image_types,gint type,gint nparams,gint nreturn_vals,GimpParamDef *params,GimpParamDef *return_vals,GimpRunProc run_proc - - -gimp_uninstall_temp_proc -void -gchar *name - - -gimp_run_procedure -GimpParam * -gchar *name,gint *nreturn_vals,... - - -gimp_run_procedure2 -GimpParam * -gchar *name,gint *nreturn_vals,gint nparams,GimpParam *params - - -gimp_destroy_params -void -GimpParam *params,gint nparams - - -gimp_destroy_paramdefs -void -GimpParamDef *paramdefs,gint nparams - - -gimp_gamma -gdouble -void - - -gimp_install_cmap -gboolean -void - - -gimp_use_xshm -gboolean -void - - -gimp_color_cube -guchar * -void - - -gimp_min_colors -gint -void - - -gimp_get_progname -gchar * -void - - -gimp_attach_new_parasite -void -const gchar *name,gint flags,gint size,const gpointer data - - -gimp_brushes_get_brush_data -gchar * -gchar *name,gdouble *opacity,gint *spacing,GimpLayerModeEffects *paint_mode,gint *width,gint *height,gint *length,guint8 **mask_data - - -gimp_brushes_popup -gboolean -gchar *brush_callback,gchar *popup_title,gchar *initial_brush,gdouble opacity,gint spacing,GimpLayerModeEffects paint_mode - - -gimp_brushes_close_popup -gboolean -gchar *brush_callback - - -gimp_brushes_set_popup -gboolean -gchar *brush_callback,gchar *brush_name,gdouble opacity,gint spacing,GimpLayerModeEffects paint_mode - - -gimp_channel_get_image_id -#define gimp_channel_get_image_id gimp_drawable_image - - -gimp_channel_new -gint32 -gint32 image_ID,gchar *name,guint width,guint height,gdouble opacity,GimpRGB *color - - -gimp_channel_copy -gint32 -gint32 channel_ID - - -gimp_channel_delete -gboolean -gint32 channel_ID - - -gimp_channel_combine_masks -gboolean -gint32 channel1_ID,gint32 channel2_ID,GimpChannelOps operation,gint offx,gint offy - - -gimp_channel_get_name -gchar * -gint32 channel_ID - - -gimp_channel_set_name -gboolean -gint32 channel_ID,gchar *name - - -gimp_channel_get_visible -gboolean -gint32 channel_ID - - -gimp_channel_set_visible -gboolean -gint32 channel_ID,gboolean visible - - -gimp_channel_get_show_masked -gboolean -gint32 channel_ID - - -gimp_channel_set_show_masked -gboolean -gint32 channel_ID,gboolean show_masked - - -gimp_channel_get_opacity -gdouble -gint32 channel_ID - - -gimp_channel_set_opacity -gboolean -gint32 channel_ID,gdouble opacity - - -gimp_channel_get_color -gboolean -gint32 channel_ID,GimpRGB *color - - -gimp_channel_set_color -gboolean -gint32 channel_ID,GimpRGB *color - - -gimp_channel_get_tattoo -gint -gint32 channel_ID - - -gimp_channel_set_tattoo -gboolean -gint32 channel_ID,gint tattoo - - -gimp_brightness_contrast -gboolean -gint32 drawable_ID,gint brightness,gint contrast - - -gimp_levels -gboolean -gint32 drawable_ID,GimpChannelLutType channel,gint low_input,gint high_input,gdouble gamma,gint low_output,gint high_output - - -gimp_posterize -gboolean -gint32 drawable_ID,gint levels - - -gimp_desaturate -gboolean -gint32 drawable_ID - - -gimp_equalize -gboolean -gint32 drawable_ID,gboolean mask_only - - -gimp_invert -gboolean -gint32 drawable_ID - - -gimp_curves_spline -gboolean -gint32 drawable_ID,GimpChannelLutType channel,gint num_points,guint8 *control_pts - - -gimp_curves_explicit -gboolean -gint32 drawable_ID,GimpChannelLutType channel,gint num_bytes,guint8 *curve - - -gimp_color_balance -gboolean -gint32 drawable_ID,GimpTransferMode transfer_mode,gboolean preserve_lum,gdouble cyan_red,gdouble magenta_green,gdouble yellow_blue - - -gimp_histogram -gboolean -gint32 drawable_ID,GimpChannelLutType channel,gint start_range,gint end_range,gdouble *mean,gdouble *std_dev,gdouble *median,gdouble *pixels,gdouble *count,gdouble *percentile - - -gimp_hue_saturation -gboolean -gint32 drawable_ID,GimpHueRange hue_range,gdouble hue_offset,gdouble lightness,gdouble saturation - - -gimp_threshold -gboolean -gint32 drawable_ID,gint low_threshold,gint high_threshold - - -GimpColorDisplayInit -void -void - - -GimpColorDisplayNew -gpointer -gint type - - -GimpColorDisplayClone -gpointer -gpointer cd_ID - - -GimpColorDisplayConvert -void -gpointer cd_ID, - guchar *buf, - gint width, - gint height, - gint bpp, - gint bpl - - -GimpColorDisplayDestroy -void -gpointer cd_ID - - -GimpColorDisplayFinalize -void -void - - -GimpColorDisplayLoadState -void -gpointer cd_ID, - GimpParasite *state - - -GimpColorDisplaySaveState -GimpParasite * -gpointer cd_ID - - -GimpColorDisplayConfigure -void -gpointer cd_ID, - GFunc ok_func, - gpointer ok_data, - GFunc cancel_func, - gpointer cancel_data - - -GimpColorDisplayConfigureCancel -void -gpointer cd_ID - - -GimpColorDisplayMethods - - -GimpColorDisplayMethods -struct GimpColorDisplayMethods -{ - GimpColorDisplayInit init; - GimpColorDisplayNew new; - GimpColorDisplayClone clone; - GimpColorDisplayConvert convert; - GimpColorDisplayDestroy destroy; - GimpColorDisplayFinalize finalize; - GimpColorDisplayLoadState load; - GimpColorDisplaySaveState save; - GimpColorDisplayConfigure configure; - GimpColorDisplayConfigureCancel cancel; -}; - - -gimp_color_display_register -gboolean -const gchar *name,GimpColorDisplayMethods *methods - - -gimp_color_display_unregister -gboolean -const gchar *name - - -GimpColorSelectorChannelType -typedef enum -{ - GIMP_COLOR_SELECTOR_HUE, - GIMP_COLOR_SELECTOR_SATURATION, - GIMP_COLOR_SELECTOR_VALUE, - GIMP_COLOR_SELECTOR_RED, - GIMP_COLOR_SELECTOR_GREEN, - GIMP_COLOR_SELECTOR_BLUE, - GIMP_COLOR_SELECTOR_ALPHA -} GimpColorSelectorChannelType; - - -GimpColorSelectorCallback -void -gpointer data, - const GimpHSV *hsv, - const GimpRGB *rgb - - -GimpColorSelectorNewFunc -GtkWidget * -const GimpHSV *hsv, - const GimpRGB *rgb, - gboolean show_alpha, - GimpColorSelectorCallback cb, - gpointer data, - gpointer *selector_data - - -GimpColorSelectorFreeFunc -void -gpointer selector_data - - -GimpColorSelectorSetColorFunc -void -gpointer selector_data, - const GimpHSV *hsv, - const GimpRGB *rgb - - -GimpColorSelectorSetChannelFunc -void -gpointer selector_data, - GimpColorSelectorChannelType type - - -GimpColorSelectorFinishedCB -void -gpointer finished_data - - -GimpColorSelectorMethods - - -GimpColorSelectorMethods -struct GimpColorSelectorMethods -{ - GimpColorSelectorNewFunc new; - GimpColorSelectorFreeFunc free; - - GimpColorSelectorSetColorFunc set_color; - GimpColorSelectorSetChannelFunc set_channel; -}; - - -GimpColorSelectorID -typedef gpointer GimpColorSelectorID; - - -gimp_color_selector_register -GimpColorSelectorID -const gchar *name,const gchar *help_page,GimpColorSelectorMethods *methods - - -gimp_color_selector_unregister -gboolean -GimpColorSelectorID id,GimpColorSelectorFinishedCB finished_cb,gpointer finished_data - - -gimp_convert_rgb -gboolean -gint32 image_ID - - -gimp_convert_grayscale -gboolean -gint32 image_ID - - -gimp_convert_indexed -gboolean -gint32 image_ID,GimpConvertDitherType dither_type,GimpConvertPaletteType palette_type,gint num_cols,gboolean alpha_dither,gboolean remove_unused,gchar *palette - - -gimp_display_new -gint32 -gint32 image_ID - - -gimp_display_delete -gboolean -gint32 display_ID - - -gimp_displays_flush -gboolean -void - - -gimp_drawable_offset -#define gimp_drawable_offset gimp_channel_ops_offset - - -gimp_drawable_image_id -#define gimp_drawable_image_id gimp_drawable_image - - -gimp_drawable_bpp -#define gimp_drawable_bpp gimp_drawable_bytes - - -GimpDrawable -struct GimpDrawable -{ - gint32 id; /* drawable ID */ - guint width; /* width of drawble */ - guint height; /* height of drawble */ - guint bpp; /* bytes per pixel of drawable */ - guint ntile_rows; /* # of tile rows */ - guint ntile_cols; /* # of tile columns */ - GimpTile *tiles; /* the normal tiles */ - GimpTile *shadow_tiles; /* the shadow tiles */ -}; - - -gimp_drawable_get -GimpDrawable * -gint32 drawable_ID - - -gimp_drawable_detach -void -GimpDrawable *drawable - - -gimp_drawable_flush -void -GimpDrawable *drawable - - -gimp_drawable_delete -void -GimpDrawable *drawable - - -gimp_drawable_name -gchar * -gint32 drawable_ID - - -gimp_drawable_visible -gboolean -gint32 drawable_ID - - -gimp_drawable_set_name -void -gint32 drawable_ID,gchar *name - - -gimp_drawable_set_visible -void -gint32 drawable_ID,gboolean visible - - -gimp_drawable_get_tile -GimpTile * -GimpDrawable *drawable,gint shadow,gint row,gint col - - -gimp_drawable_get_tile2 -GimpTile * -GimpDrawable *drawable,gint shadow,gint x,gint y - - -gimp_drawable_get_thumbnail_data -guchar * -gint32 drawable_ID,gint *width,gint *height,gint *bpp - - -gimp_drawable_attach_new_parasite -void -gint32 drawable_ID,const gchar *name,gint flags,gint size,const gpointer data - - -gimp_drawable_merge_shadow -gboolean -gint32 drawable_ID,gboolean undo - - -gimp_drawable_fill -gboolean -gint32 drawable_ID,GimpFillType fill_type - - -gimp_drawable_update -gboolean -gint32 drawable_ID,gint x,gint y,gint width,gint height - - -gimp_drawable_mask_bounds -gboolean -gint32 drawable_ID,gint *x1,gint *y1,gint *x2,gint *y2 - - -gimp_drawable_image -gint32 -gint32 drawable_ID - - -gimp_drawable_type -GimpImageType -gint32 drawable_ID - - -gimp_drawable_has_alpha -gboolean -gint32 drawable_ID - - -gimp_drawable_type_with_alpha -GimpImageType -gint32 drawable_ID - - -gimp_drawable_is_rgb -gboolean -gint32 drawable_ID - - -gimp_drawable_is_gray -gboolean -gint32 drawable_ID - - -gimp_drawable_is_indexed -gboolean -gint32 drawable_ID - - -gimp_drawable_bytes -gint -gint32 drawable_ID - - -gimp_drawable_width -gint -gint32 drawable_ID - - -gimp_drawable_height -gint -gint32 drawable_ID - - -gimp_drawable_offsets -gboolean -gint32 drawable_ID,gint *offset_x,gint *offset_y - - -gimp_drawable_is_layer -gboolean -gint32 drawable_ID - - -gimp_drawable_is_layer_mask -gboolean -gint32 drawable_ID - - -gimp_drawable_is_channel -gboolean -gint32 drawable_ID - - -gimp_drawable_offset -gboolean -gint32 drawable_ID,gboolean wrap_around,GimpOffsetType fill_type,gint offset_x,gint offset_y - - -gimp_edit_cut -gboolean -gint32 drawable_ID - - -gimp_edit_copy -gboolean -gint32 drawable_ID - - -gimp_edit_paste -gint32 -gint32 drawable_ID,gboolean paste_into - - -gimp_edit_clear -gboolean -gint32 drawable_ID - - -gimp_edit_fill -gboolean -gint32 drawable_ID,GimpFillType fill_type - - -gimp_edit_stroke -gboolean -gint32 drawable_ID - - -GimpAddMaskType -typedef enum -{ - GIMP_WHITE_MASK, - GIMP_BLACK_MASK, - GIMP_ALPHA_MASK, - GIMP_SELECTION_MASK, - GIMP_INV_SELECTION_MASK -} GimpAddMaskType; - - -GimpBlendMode -typedef enum -{ - GIMP_FG_BG_RGB, - GIMP_FG_BG_HSV, - GIMP_FG_TRANS, - GIMP_CUSTOM -} GimpBlendMode; - - -GimpBrushApplicationMode -typedef enum -{ - GIMP_HARD, - GIMP_SOFT, - GIMP_PRESSURE -} GimpBrushApplicationMode; - - -GimpBucketFillMode -typedef enum -{ - GIMP_FG_BUCKET_FILL, - GIMP_BG_BUCKET_FILL, - GIMP_PATTERN_BUCKET_FILL -} GimpBucketFillMode; - - -GimpChannelLutType -typedef enum -{ - GIMP_VALUE_LUT, - GIMP_RED_LUT, - GIMP_GREEN_LUT, - GIMP_BLUE_LUT, - GIMP_ALPHA_LUT -} GimpChannelLutType; - - -GimpChannelOps -typedef enum -{ - GIMP_ADD, - GIMP_SUB, - GIMP_REPLACE, - GIMP_INTERSECT -} GimpChannelOps; - - -GimpChannelType -typedef enum -{ - GIMP_RED_CHANNEL, - GIMP_GREEN_CHANNEL, - GIMP_BLUE_CHANNEL, - GIMP_GRAY_CHANNEL, - GIMP_INDEXED_CHANNEL, - GIMP_ALPHA_CHANNEL -} GimpChannelType; - - -GimpCloneType -typedef enum -{ - GIMP_IMAGE_CLONE, - GIMP_PATTERN_CLONE -} GimpCloneType; - - -GimpConvertDitherType -typedef enum -{ - GIMP_NO_DITHER, - GIMP_FS_DITHER, - GIMP_FSLOWBLEED_DITHER, - GIMP_FIXED_DITHER, - GIMP_NODESTRUCT_DITHER -} GimpConvertDitherType; - - -GimpConvertPaletteType -typedef enum -{ - GIMP_MAKE_PALETTE, - GIMP_REUSE_PALETTE, - GIMP_WEB_PALETTE, - GIMP_MONO_PALETTE, - GIMP_CUSTOM_PALETTE -} GimpConvertPaletteType; - - -GimpConvolutionType -typedef enum -{ - GIMP_NORMAL_CONVOL, - GIMP_ABSOLUTE_CONVOL, - GIMP_NEGATIVE_CONVOL -} GimpConvolutionType; - - -GimpConvolveType -typedef enum -{ - GIMP_BLUR_CONVOLVE, - GIMP_SHARPEN_CONVOLVE, - GIMP_CUSTOM_CONVOLVE -} GimpConvolveType; - - -GimpDodgeBurnMode -typedef enum -{ - GIMP_DODGEBURN_HIGHLIGHTS, - GIMP_DODGEBURN_MIDTONES, - GIMP_DODGEBURN_SHADOWS -} GimpDodgeBurnMode; - - -GimpDodgeBurnType -typedef enum -{ - GIMP_DODGE, - GIMP_BURN -} GimpDodgeBurnType; - - -GimpFillType -typedef enum -{ - GIMP_FG_IMAGE_FILL, - GIMP_BG_IMAGE_FILL, - GIMP_WHITE_IMAGE_FILL, - GIMP_TRANS_IMAGE_FILL, - GIMP_NO_IMAGE_FILL -} GimpFillType; - - -GimpImageBaseType -typedef enum -{ - GIMP_RGB, - GIMP_GRAY, - GIMP_INDEXED -} GimpImageBaseType; - - -GimpImageType -typedef enum -{ - GIMP_RGB_IMAGE, - GIMP_RGBA_IMAGE, - GIMP_GRAY_IMAGE, - GIMP_GRAYA_IMAGE, - GIMP_INDEXED_IMAGE, - GIMP_INDEXEDA_IMAGE -} GimpImageType; - - -GimpOffsetType -typedef enum -{ - GIMP_OFFSET_BACKGROUND, - GIMP_OFFSET_TRANSPARENT -} GimpOffsetType; - - -GimpGradientPaintMode -typedef enum -{ - GIMP_ONCE_FORWARD, - GIMP_ONCE_BACKWARDS, - GIMP_LOOP_SAWTOOTH, - GIMP_LOOP_TRIANGLE, - GIMP_ONCE_END_COLOR -} GimpGradientPaintMode; - - -GimpGradientType -typedef enum -{ - GIMP_LINEAR, - GIMP_BILINEAR, - GIMP_RADIAL, - GIMP_SQUARE, - GIMP_CONICAL_SYMMETRIC, - GIMP_CONICAL_ASYMMETRIC, - GIMP_SHAPEBURST_ANGULAR, - GIMP_SHAPEBURST_SPHERICAL, - GIMP_SHAPEBURST_DIMPLED, - GIMP_SPIRAL_CLOCKWISE, - GIMP_SPIRAL_ANTICLOCKWISE -} GimpGradientType; - - -GimpHueRange -typedef enum -{ - GIMP_ALL_HUES, - GIMP_RED_HUES, - GIMP_YELLOW_HUES, - GIMP_GREEN_HUES, - GIMP_CYAN_HUES, - GIMP_BLUE_HUES, - GIMP_MAGENTA_HUES -} GimpHueRange; - - -GimpInterpolationType -typedef enum -{ - GIMP_LINEAR_INTERPOLATION, - GIMP_CUBIC_INTERPOLATION, - GIMP_NEAREST_NEIGHBOR_INTERPOLATION -} GimpInterpolationType; - - -GimpLayerModeEffects -typedef enum -{ - GIMP_NORMAL_MODE, - GIMP_DISSOLVE_MODE, - GIMP_BEHIND_MODE, - GIMP_MULTIPLY_MODE, - GIMP_SCREEN_MODE, - GIMP_OVERLAY_MODE, - GIMP_DIFFERENCE_MODE, - GIMP_ADDITION_MODE, - GIMP_SUBTRACT_MODE, - GIMP_DARKEN_ONLY_MODE, - GIMP_LIGHTEN_ONLY_MODE, - GIMP_HUE_MODE, - GIMP_SATURATION_MODE, - GIMP_COLOR_MODE, - GIMP_VALUE_MODE, - GIMP_DIVIDE_MODE, - GIMP_DODGE_MODE, - GIMP_BURN_MODE, - GIMP_HARDLIGHT_MODE -} GimpLayerModeEffects; - - -GimpMaskApplyMode -typedef enum -{ - GIMP_APPLY, - GIMP_DISCARD -} GimpMaskApplyMode; - - -GimpMergeType -typedef enum -{ - GIMP_EXPAND_AS_NECESSARY, - GIMP_CLIP_TO_IMAGE, - GIMP_CLIP_TO_BOTTOM_LAYER, - GIMP_FLATTEN_IMAGE -} GimpMergeType; - - -GimpMessageHandlerType -typedef enum -{ - GIMP_MESSAGE_BOX, - GIMP_CONSOLE, - GIMP_ERROR_CONSOLE -} GimpMessageHandlerType; - - -GimpOrientationType -typedef enum -{ - GIMP_HORIZONTAL, - GIMP_VERTICAL, - GIMP_UNKNOWN -} GimpOrientationType; - - -GimpPaintApplicationMode -typedef enum -{ - GIMP_CONTINUOUS, - GIMP_INCREMENTAL -} GimpPaintApplicationMode; - - -GimpRepeatMode -typedef enum -{ - GIMP_REPEAT_NONE, - GIMP_REPEAT_SAWTOOTH, - GIMP_REPEAT_TRIANGULAR -} GimpRepeatMode; - - -GimpRunModeType -typedef enum -{ - GIMP_RUN_INTERACTIVE, - GIMP_RUN_NONINTERACTIVE, - GIMP_RUN_WITH_LAST_VALS -} GimpRunModeType; - - -GimpSizeType -typedef enum -{ - GIMP_PIXELS, - GIMP_POINTS -} GimpSizeType; - - -GimpStackTraceMode -typedef enum -{ - GIMP_STACK_TRACE_NEVER, - GIMP_STACK_TRACE_QUERY, - GIMP_STACK_TRACE_ALWAYS -} GimpStackTraceMode; - - -GimpTransferMode -typedef enum -{ - GIMP_SHADOWS, - GIMP_MIDTONES, - GIMP_HIGHLIGHTS -} GimpTransferMode; - - -GimpExportCapabilities -typedef enum -{ - GIMP_EXPORT_CAN_HANDLE_RGB = 1 << 0, - GIMP_EXPORT_CAN_HANDLE_GRAY = 1 << 1, - GIMP_EXPORT_CAN_HANDLE_INDEXED = 1 << 2, - GIMP_EXPORT_CAN_HANDLE_ALPHA = 1 << 3, - GIMP_EXPORT_CAN_HANDLE_LAYERS = 1 << 4, - GIMP_EXPORT_CAN_HANDLE_LAYERS_AS_ANIMATION = 1 << 5, - GIMP_EXPORT_NEEDS_ALPHA = 1 << 6 -} GimpExportCapabilities; - - -GimpExportReturnType -typedef enum -{ - GIMP_EXPORT_CANCEL, - GIMP_EXPORT_IGNORE, - GIMP_EXPORT_EXPORT -} GimpExportReturnType; - - -gimp_export_image -GimpExportReturnType -gint32 *image_ID,gint32 *drawable_ID,const gchar *format_name,GimpExportCapabilities capabilities - - -gimp_file_load -gint32 -GimpRunModeType run_mode,gchar *filename,gchar *raw_filename - - -gimp_file_save -gboolean -GimpRunModeType run_mode,gint32 image_ID,gint32 drawable_ID,gchar *filename,gchar *raw_filename - - -gimp_temp_name -gchar * -gchar *extension - - -gimp_register_magic_load_handler -gboolean -gchar *procedure_name,gchar *extensions,gchar *prefixes,gchar *magics - - -gimp_register_load_handler -gboolean -gchar *procedure_name,gchar *extensions,gchar *prefixes - - -gimp_register_save_handler -gboolean -gchar *procedure_name,gchar *extensions,gchar *prefixes - - -gimp_floating_sel_remove -gboolean -gint32 floating_sel_ID - - -gimp_floating_sel_anchor -gboolean -gint32 floating_sel_ID - - -gimp_floating_sel_to_layer -gboolean -gint32 floating_sel_ID - - -gimp_floating_sel_attach -gboolean -gint32 layer_ID,gint32 drawable_ID - - -gimp_floating_sel_rigor -gboolean -gint32 floating_sel_ID,gboolean undo - - -gimp_floating_sel_relax -gboolean -gint32 floating_sel_ID,gboolean undo - - -gimp_gimprc_query -gchar * -gchar *token - - -gimp_gimprc_set -gboolean -gchar *token,gchar *value - - -gimp_get_monitor_resolution -gboolean -gdouble *xres,gdouble *yres - - -gimp_gradients_get_list -gchar ** -gint *num_gradients - - -gimp_gradients_get_active -gchar * -void - - -gimp_gradients_set_active -gboolean -gchar *name - - -gimp_gradients_sample_uniform -gdouble * -gint num_samples - - -gimp_gradients_sample_custom -gdouble * -gint num_samples,gdouble *positions - - -gimp_gradients_get_gradient_data -gchar * -gchar *name,gint *width,gint sample_size,gdouble **grad_data - - -gimp_gradients_popup -gboolean -gchar *gradients_callback,gchar *popup_title,gchar *initial_gradient,gint sample_size - - -gimp_gradients_close_popup -gboolean -gchar *gradients_callback - - -gimp_gradients_set_popup -gboolean -gchar *gradients_callback,gchar *gradient_name - - -gimp_image_add_hguide -gint32 -gint32 image_ID,gint yposition - - -gimp_image_add_vguide -gint32 -gint32 image_ID,gint xposition - - -gimp_image_delete_guide -gboolean -gint32 image_ID,gint32 guide_ID - - -gimp_image_find_next_guide -gint32 -gint32 image_ID,gint32 guide_ID - - -gimp_image_get_guide_orientation -GimpOrientationType -gint32 image_ID,gint32 guide_ID - - -gimp_image_get_guide_position -gint -gint32 image_ID,gint32 guide_ID - - -gimp_help -gboolean -gchar *prog_name,gchar *help_page - - -gimp_image_convert_rgb -#define gimp_image_convert_rgb gimp_convert_rgb - - -gimp_image_convert_grayscale -#define gimp_image_convert_grayscale gimp_convert_grayscale - - -gimp_image_convert_indexed -#define gimp_image_convert_indexed gimp_convert_indexed - - -gimp_image_get_cmap -guchar * -gint32 image_ID,gint *num_colors - - -gimp_image_set_cmap -gboolean -gint32 image_ID,guchar *cmap,gint num_colors - - -gimp_image_get_thumbnail_data -guchar * -gint32 image_ID,gint *width,gint *height,gint *bpp - - -gimp_image_attach_new_parasite -void -gint32 image_ID,const gchar *name,gint flags,gint size,const gpointer data - - -gimp_image_list -gint * -gint *num_images - - -gimp_image_new -gint32 -gint width,gint height,GimpImageBaseType type - - -gimp_image_resize -gboolean -gint32 image_ID,gint new_width,gint new_height,gint offx,gint offy - - -gimp_image_scale -gboolean -gint32 image_ID,gint new_width,gint new_height - - -gimp_image_delete -gboolean -gint32 image_ID - - -gimp_image_free_shadow -gboolean -gint32 image_ID - - -gimp_image_get_layers -gint * -gint32 image_ID,gint *num_layers - - -gimp_image_get_channels -gint * -gint32 image_ID,gint *num_channels - - -gimp_image_unset_active_channel -gboolean -gint32 image_ID - - -gimp_image_pick_correlate_layer -gint32 -gint32 image_ID,gint x,gint y - - -gimp_image_raise_layer -gboolean -gint32 image_ID,gint32 layer_ID - - -gimp_image_lower_layer -gboolean -gint32 image_ID,gint32 layer_ID - - -gimp_image_raise_layer_to_top -gboolean -gint32 image_ID,gint32 layer_ID - - -gimp_image_lower_layer_to_bottom -gboolean -gint32 image_ID,gint32 layer_ID - - -gimp_image_merge_visible_layers -gint32 -gint32 image_ID,GimpMergeType merge_type - - -gimp_image_merge_down -gint32 -gint32 image_ID,gint32 merge_layer_ID,GimpMergeType merge_type - - -gimp_image_flatten -gint32 -gint32 image_ID - - -gimp_image_add_layer -gboolean -gint32 image_ID,gint32 layer_ID,gint position - - -gimp_image_remove_layer -gboolean -gint32 image_ID,gint32 layer_ID - - -gimp_image_add_layer_mask -gboolean -gint32 image_ID,gint32 layer_ID,gint32 mask_ID - - -gimp_image_remove_layer_mask -gboolean -gint32 image_ID,gint32 layer_ID,GimpMaskApplyMode mode - - -gimp_image_raise_channel -gboolean -gint32 image_ID,gint32 channel_ID - - -gimp_image_lower_channel -gboolean -gint32 image_ID,gint32 layer_ID - - -gimp_image_add_channel -gboolean -gint32 image_ID,gint32 channel_ID,gint position - - -gimp_image_remove_channel -gboolean -gint32 image_ID,gint32 channel_ID - - -gimp_image_active_drawable -gint32 -gint32 image_ID - - -gimp_image_base_type -GimpImageBaseType -gint32 image_ID - - -gimp_image_undo_is_enabled -gboolean -gint32 image_ID - - -gimp_image_undo_enable -gboolean -gint32 image_ID - - -gimp_image_undo_disable -gboolean -gint32 image_ID - - -gimp_image_undo_freeze -gboolean -gint32 image_ID - - -gimp_image_undo_thaw -gboolean -gint32 image_ID - - -gimp_image_clean_all -gboolean -gint32 image_ID - - -gimp_image_floating_selection -gint32 -gint32 image_ID - - -gimp_image_floating_sel_attached_to -gint32 -gint32 image_ID - - -gimp_image_set_tattoo_state -gboolean -gint32 image_ID,gint tattoo - - -gimp_image_get_tattoo_state -gint -gint32 image_ID - - -gimp_image_duplicate -gint32 -gint32 image_ID - - -gimp_image_width -gint -gint32 image_ID - - -gimp_image_height -gint -gint32 image_ID - - -gimp_image_get_active_layer -gint32 -gint32 image_ID - - -gimp_image_set_active_layer -gboolean -gint32 image_ID,gint32 active_layer_ID - - -gimp_image_get_active_channel -gint32 -gint32 image_ID - - -gimp_image_set_active_channel -gboolean -gint32 image_ID,gint32 active_channel_ID - - -gimp_image_get_selection -gint32 -gint32 image_ID - - -gimp_image_get_component_active -gboolean -gint32 image_ID,GimpChannelType component - - -gimp_image_set_component_active -gboolean -gint32 image_ID,GimpChannelType component,gboolean active - - -gimp_image_get_component_visible -gboolean -gint32 image_ID,GimpChannelType component - - -gimp_image_set_component_visible -gboolean -gint32 image_ID,GimpChannelType component,gboolean visible - - -gimp_image_get_filename -gchar * -gint32 image_ID - - -gimp_image_set_filename -gboolean -gint32 image_ID,gchar *filename - - -gimp_image_get_resolution -gboolean -gint32 image_ID,gdouble *xresolution,gdouble *yresolution - - -gimp_image_set_resolution -gboolean -gint32 image_ID,gdouble xresolution,gdouble yresolution - - -gimp_image_get_unit -GimpUnit -gint32 image_ID - - -gimp_image_set_unit -gboolean -gint32 image_ID,GimpUnit unit - - -gimp_image_get_layer_by_tattoo -gint32 -gint32 image_ID,gint tattoo - - -gimp_image_get_channel_by_tattoo -gint32 -gint32 image_ID,gint tattoo - - -gimp_layer_get_mask_id -#define gimp_layer_get_mask_id gimp_layer_mask - - -gimp_layer_get_image_id -#define gimp_layer_get_image_id gimp_drawable_image - - -gimp_layer_is_floating_selection -#define gimp_layer_is_floating_selection gimp_layer_is_floating_sel - - -gimp_layer_get_preserve_transparency -#define gimp_layer_get_preserve_transparency gimp_layer_get_preserve_trans - - -gimp_layer_set_preserve_transparency -#define gimp_layer_set_preserve_transparency gimp_layer_set_preserve_trans - - -gimp_layer_new -gint32 -gint32 image_ID,gchar *name,gint width,gint height,GimpImageType type,gdouble opacity,GimpLayerModeEffects mode - - -gimp_layer_copy -gint32 -gint32 layer_ID - - -gimp_layer_create_mask -gint32 -gint32 layer_ID,GimpAddMaskType mask_type - - -gimp_layer_scale -gboolean -gint32 layer_ID,gint new_width,gint new_height,gboolean local_origin - - -gimp_layer_resize -gboolean -gint32 layer_ID,gint new_width,gint new_height,gint offx,gint offy - - -gimp_layer_delete -gboolean -gint32 layer_ID - - -gimp_layer_translate -gboolean -gint32 layer_ID,gint offx,gint offy - - -gimp_layer_add_alpha -gboolean -gint32 layer_ID - - -gimp_layer_set_offsets -gboolean -gint32 layer_ID,gint offx,gint offy - - -gimp_layer_mask -gint32 -gint32 layer_ID - - -gimp_layer_is_floating_sel -gboolean -gint32 layer_ID - - -gimp_layer_get_name -gchar * -gint32 layer_ID - - -gimp_layer_set_name -gboolean -gint32 layer_ID,gchar *name - - -gimp_layer_get_visible -gboolean -gint32 layer_ID - - -gimp_layer_set_visible -gboolean -gint32 layer_ID,gboolean visible - - -gimp_layer_get_preserve_trans -gboolean -gint32 layer_ID - - -gimp_layer_set_preserve_trans -gboolean -gint32 layer_ID,gboolean preserve_trans - - -gimp_layer_get_apply_mask -gboolean -gint32 layer_ID - - -gimp_layer_set_apply_mask -gboolean -gint32 layer_ID,gboolean apply_mask - - -gimp_layer_get_show_mask -gboolean -gint32 layer_ID - - -gimp_layer_set_show_mask -gboolean -gint32 layer_ID,gboolean show_mask - - -gimp_layer_get_edit_mask -gboolean -gint32 layer_ID - - -gimp_layer_set_edit_mask -gboolean -gint32 layer_ID,gboolean edit_mask - - -gimp_layer_get_opacity -gdouble -gint32 layer_ID - - -gimp_layer_set_opacity -gboolean -gint32 layer_ID,gdouble opacity - - -gimp_layer_get_mode -GimpLayerModeEffects -gint32 layer_ID - - -gimp_layer_set_mode -gboolean -gint32 layer_ID,GimpLayerModeEffects mode - - -gimp_layer_get_linked -gboolean -gint32 layer_ID - - -gimp_layer_set_linked -gboolean -gint32 layer_ID,gboolean linked - - -gimp_layer_get_tattoo -gint -gint32 layer_ID - - -gimp_layer_set_tattoo -gboolean -gint32 layer_ID,gint tattoo - - -GimpConstraintFunc -gint -gint32 image_id, - gint32 drawable_id, - gpointer data - - -GimpMenuCallback -void -gint32 id, - gpointer data - - -GimpRunBrushCallback -void -gchar *name, - gdouble opacity, - gint spacing, - gint paint_mode, - gint width, - gint height, - gchar *mask_data, - gboolean dialog_closing, - gpointer user_data - - -GimpRunPatternCallback -void -gchar *name, - gint width, - gint height, - gint bpp, - gchar *mask_data, - gboolean dialog_closing, - gpointer user_data - - -GimpRunGradientCallback -void -gchar *name, - gint width, - gdouble *grad_data, - gboolean dialog_closing, - gpointer user_data - - -gimp_image_menu_new -GtkWidget * -GimpConstraintFunc constraint,GimpMenuCallback callback,gpointer data,gint32 active_image - - -gimp_layer_menu_new -GtkWidget * -GimpConstraintFunc constraint,GimpMenuCallback callback,gpointer data,gint32 active_layer - - -gimp_channel_menu_new -GtkWidget * -GimpConstraintFunc constraint,GimpMenuCallback callback,gpointer data,gint32 active_channel - - -gimp_drawable_menu_new -GtkWidget * -GimpConstraintFunc constraint,GimpMenuCallback callback,gpointer data,gint32 active_drawable - - -gimp_interactive_selection_brush -gchar * -gchar *dialogname,gchar *brush_name,gdouble opacity,gint spacing,gint paint_mode,GimpRunBrushCallback callback,gpointer data - - -gimp_brush_select_widget -GtkWidget * -gchar *dname,gchar *ibrush,gdouble opacity,gint spacing,gint paint_mode,GimpRunBrushCallback cback,gpointer data - - -gimp_brush_select_widget_set_popup -void -GtkWidget *widget,gchar *pname,gdouble opacity,gint spacing,gint paint_mode - - -gimp_brush_select_widget_close_popup -void -GtkWidget *widget - - -gimp_interactive_selection_pattern -gchar * -gchar *dialogtitle,gchar *pattern_name,GimpRunPatternCallback callback,gpointer data - - -gimp_pattern_select_widget -GtkWidget * -gchar *dname,gchar *ipattern,GimpRunPatternCallback cback,gpointer data - - -gimp_pattern_select_widget_close_popup -void -GtkWidget *widget - - -gimp_pattern_select_widget_set_popup -void -GtkWidget *widget,gchar *pname - - -gimp_interactive_selection_gradient -gchar * -gchar *dialogtitle,gchar *gradient_name,gint sample_sz,GimpRunGradientCallback callback,gpointer data - - -gimp_gradient_select_widget -GtkWidget * -gchar *gname,gchar *igradient,GimpRunGradientCallback cback,gpointer data - - -gimp_gradient_select_widget_close_popup -void -GtkWidget *widget - - -gimp_gradient_select_widget_set_popup -void -GtkWidget *widget,gchar *gname - - -gimp_message -gboolean -gchar *message - - -gimp_message_get_handler -GimpMessageHandlerType -void - - -gimp_message_set_handler -gboolean -GimpMessageHandlerType handler - - -gimp_version -gchar * -void - - -GimpModuleStatus -typedef enum -{ - GIMP_MODULE_OK, - GIMP_MODULE_UNLOAD -} GimpModuleStatus; - - -GimpModuleInfo - - -GimpModuleInfo -struct GimpModuleInfo -{ - gpointer shutdown_data; - - const gchar *purpose; - const gchar *author; - const gchar *version; - const gchar *copyright; - const gchar *date; -}; - - -GimpModuleInitFunc -GimpModuleStatus -GimpModuleInfo **module_info - - -GimpModuleCompletedCB -void -gpointer completed_data - - -GimpModuleUnloadFunc -void -gpointer shutdown_data, - GimpModuleCompletedCB completed_cb, - gpointer completed_data - - -gimp_palette_get_foreground -gboolean -GimpRGB *foreground - - -gimp_palette_get_background -gboolean -GimpRGB *background - - -gimp_palette_set_foreground -gboolean -GimpRGB *foreground - - -gimp_palette_set_background -gboolean -GimpRGB *background - - -gimp_palette_set_default_colors -gboolean -void - - -gimp_palette_swap_colors -gboolean -void - - -gimp_palette_refresh -gboolean -void - - -gimp_parasite_find -GimpParasite * -gchar *name - - -gimp_parasite_attach -gboolean -GimpParasite *parasite - - -gimp_parasite_detach -gboolean -gchar *name - - -gimp_parasite_list -gboolean -gint *num_parasites,gchar ***parasites - - -gimp_drawable_parasite_find -GimpParasite * -gint32 drawable_ID,gchar *name - - -gimp_drawable_parasite_attach -gboolean -gint32 drawable_ID,GimpParasite *parasite - - -gimp_drawable_parasite_detach -gboolean -gint32 drawable_ID,gchar *name - - -gimp_drawable_parasite_list -gboolean -gint32 drawable_ID,gint *num_parasites,gchar ***parasites - - -gimp_image_parasite_find -GimpParasite * -gint32 image_ID,gchar *name - - -gimp_image_parasite_attach -gboolean -gint32 image_ID,GimpParasite *parasite - - -gimp_image_parasite_detach -gboolean -gint32 image_ID,gchar *name - - -gimp_image_parasite_list -gboolean -gint32 image_ID,gint *num_parasites,gchar ***parasites - - -gimp_path_list -gchar ** -gint32 image_ID,gint *num_paths - - -gimp_path_get_points -gint -gint32 image_ID,gchar *pathname,gint *path_closed,gint *num_path_point_details,gdouble **points_pairs - - -gimp_path_get_current -gchar * -gint32 image_ID - - -gimp_path_set_current -gboolean -gint32 image_ID,gchar *set_current_path_name - - -gimp_path_set_points -gboolean -gint32 image_ID,gchar *pathname,gint ptype,gint num_path_points,gdouble *points_pairs - - -gimp_path_stroke_current -gboolean -gint32 image_ID - - -gimp_path_get_point_at_dist -gint -gint32 image_ID,gdouble distance,gint *y_point,gdouble *gradient - - -gimp_path_get_tattoo -gint -gint32 image_ID,gchar *pathname - - -gimp_get_path_by_tattoo -gchar * -gint32 image_ID,gint tattoo - - -gimp_path_delete -gboolean -gint32 image_ID,gchar *path_name_to_del - - -gimp_path_get_locked -gint -gint32 image_ID,gchar *pathname - - -gimp_path_set_locked -gboolean -gint32 image_ID,gchar *pathname,gint lockstatus - - -gimp_path_set_tattoo -gboolean -gint32 image_ID,gchar *pathname,gint tattovalue - - -gimp_patterns_get_pattern_data -gchar * -gchar *name,gint *width,gint *height,gint *mask_bpp,gint *length,guint8 **mask_data - - -gimp_patterns_popup -gboolean -gchar *pattern_callback,gchar *popup_title,gchar *initial_pattern - - -gimp_patterns_close_popup -gboolean -gchar *pattern_callback - - -gimp_patterns_set_popup -gboolean -gchar *pattern_callback,gchar *pattern_name - - -GimpPixelRgn -struct GimpPixelRgn -{ - guchar *data; /* pointer to region data */ - GimpDrawable *drawable; /* pointer to drawable */ - guint bpp; /* bytes per pixel */ - guint rowstride; /* bytes per pixel row */ - guint x, y; /* origin */ - guint w, h; /* width and height of region */ - guint dirty : 1; /* will this region be dirtied? */ - guint shadow : 1; /* will this region use the shadow or normal tiles */ - guint process_count; /* used internally */ -}; - - -gimp_pixel_rgn_init -void -GimpPixelRgn *pr,GimpDrawable *drawable,gint x,gint y,gint width,gint height,gint dirty,gint shadow - - -gimp_pixel_rgn_resize -void -GimpPixelRgn *pr,gint x,gint y,gint width,gint height - - -gimp_pixel_rgn_get_pixel -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y - - -gimp_pixel_rgn_get_row -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y,gint width - - -gimp_pixel_rgn_get_col -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y,gint height - - -gimp_pixel_rgn_get_rect -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y,gint width,gint height - - -gimp_pixel_rgn_set_pixel -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y - - -gimp_pixel_rgn_set_row -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y,gint width - - -gimp_pixel_rgn_set_col -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y,gint height - - -gimp_pixel_rgn_set_rect -void -GimpPixelRgn *pr,guchar *buf,gint x,gint y,gint width,gint height - - -gimp_pixel_rgns_register -gpointer -gint nrgns,... - - -gimp_pixel_rgns_register2 -gpointer -gint nrgns,GimpPixelRgn **prs - - -gimp_pixel_rgns_process -gpointer -gpointer pri_ptr - - -gimp_progress_init -gboolean -gchar *message - - -gimp_progress_update -gboolean -gdouble percentage - - -gimp_temp_PDB_name -gchar * -void - - -gimp_plugin_domain_register -gboolean -gchar *domain_name,gchar *domain_path - - -gimp_plugin_help_register -gboolean -gchar *help_path - - -gimp_procedural_db_proc_info -gboolean -gchar *procedure,gchar **blurb,gchar **help,gchar **author,gchar **copyright,gchar **date,GimpPDBProcType *proc_type,gint *num_args,gint *num_values,GimpParamDef **args,GimpParamDef **return_vals - - -gimp_procedural_db_get_data -gboolean -gchar *identifier,gpointer data - - -gimp_procedural_db_set_data -gboolean -gchar *identifier,gpointer data,guint32 bytes - - -gimp_procedural_db_dump -gboolean -gchar *filename - - -gimp_procedural_db_query -gboolean -gchar *name,gchar *blurb,gchar *help,gchar *author,gchar *copyright,gchar *date,gchar *proc_type,gint *num_matches,gchar ***procedure_names - - -gimp_procedural_db_proc_arg -gboolean -gchar *procedure,gint arg_num,GimpPDBArgType *arg_type,gchar **arg_name,gchar **arg_desc - - -gimp_procedural_db_proc_val -gboolean -gchar *procedure,gint val_num,GimpPDBArgType *val_type,gchar **val_name,gchar **val_desc - - -gimp_procedural_db_get_data_size -gint -gchar *identifier - - -gimp_selection_float -gint32 -gint32 image_ID,gint32 drawable_ID,gint offx,gint offy - - -gimp_selection_bounds -gboolean -gint32 image_ID,gboolean *non_empty,gint *x1,gint *y1,gint *x2,gint *y2 - - -gimp_selection_value -gint -gint32 image_ID,gint x,gint y - - -gimp_selection_is_empty -gboolean -gint32 image_ID - - -gimp_selection_translate -gboolean -gint32 image_ID,gint offx,gint offy - - -gimp_selection_clear -gboolean -gint32 image_ID - - -gimp_selection_invert -gboolean -gint32 image_ID - - -gimp_selection_sharpen -gboolean -gint32 image_ID - - -gimp_selection_all -gboolean -gint32 image_ID - - -gimp_selection_none -gboolean -gint32 image_ID - - -gimp_selection_feather -gboolean -gint32 image_ID,gdouble radius - - -gimp_selection_border -gboolean -gint32 image_ID,gint radius - - -gimp_selection_grow -gboolean -gint32 image_ID,gint steps - - -gimp_selection_shrink -gboolean -gint32 image_ID,gint radius - - -gimp_selection_layer_alpha -gboolean -gint32 layer_ID - - -gimp_selection_load -gboolean -gint32 channel_ID - - -gimp_selection_save -gint32 -gint32 image_ID - - -gimp_selection_combine -gboolean -gint32 channel_ID,GimpChannelOps operation - - -gimp_text_fontname -gint32 -gint32 image_ID,gint32 drawable_ID,gdouble x,gdouble y,gchar *text,gint border,gboolean antialias,gdouble size,GimpSizeType size_type,gchar *fontname - - -gimp_text_get_extents_fontname -gboolean -gchar *text,gdouble size,GimpSizeType size_type,gchar *fontname,gint *width,gint *height,gint *ascent,gint *descent - - -gimp_text -gint32 -gint32 image_ID,gint32 drawable_ID,gdouble x,gdouble y,gchar *text,gint border,gboolean antialias,gdouble size,GimpSizeType size_type,gchar *foundry,gchar *family,gchar *weight,gchar *slant,gchar *set_width,gchar *spacing,gchar *registry,gchar *encoding - - -gimp_text_get_extents -gboolean -gchar *text,gdouble size,GimpSizeType size_type,gchar *foundry,gchar *family,gchar *weight,gchar *slant,gchar *set_width,gchar *spacing,gchar *registry,gchar *encoding,gint *width,gint *height,gint *ascent,gint *descent - - -GimpTile -struct GimpTile -{ - guint ewidth; /* the effective width of the tile */ - guint eheight; /* the effective height of the tile */ - guint bpp; /* the bytes per pixel (1, 2, 3 or 4 ) */ - guint tile_num; /* the number of this tile within the drawable */ - guint16 ref_count; /* reference count for the tile */ - guint dirty : 1; /* is the tile dirty? has it been modified? */ - guint shadow: 1; /* is this a shadow tile */ - guchar *data; /* the pixel data for the tile */ - GimpDrawable *drawable; /* the drawable this tile came from */ -}; - - -gimp_tile_ref -void -GimpTile *tile - - -gimp_tile_ref_zero -void -GimpTile *tile - - -gimp_tile_unref -void -GimpTile *tile,gboolean dirty - - -gimp_tile_flush -void -GimpTile *tile - - -gimp_tile_cache_size -void -gulong kilobytes - - -gimp_tile_cache_ntiles -void -gulong ntiles - - -gimp_tile_width -guint -void - - -gimp_tile_height -guint -void - - -gimp_airbrush -gboolean -gint32 drawable_ID,gdouble pressure,gint num_strokes,gdouble *strokes - - -gimp_airbrush_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_blend -gboolean -gint32 drawable_ID,GimpBlendMode blend_mode,GimpLayerModeEffects paint_mode,GimpGradientType gradient_type,gdouble opacity,gdouble offset,GimpRepeatMode repeat,gboolean supersample,gint max_depth,gdouble threshold,gdouble x1,gdouble y1,gdouble x2,gdouble y2 - - -gimp_bucket_fill -gboolean -gint32 drawable_ID,GimpBucketFillMode fill_mode,GimpLayerModeEffects paint_mode,gdouble opacity,gdouble threshold,gboolean sample_merged,gdouble x,gdouble y - - -gimp_by_color_select -gboolean -gint32 drawable_ID,GimpRGB *color,gint threshold,GimpChannelOps operation,gboolean antialias,gboolean feather,gdouble feather_radius,gboolean sample_merged - - -gimp_clone -gboolean -gint32 drawable_ID,gint32 src_drawable_ID,GimpCloneType clone_type,gdouble src_x,gdouble src_y,gint num_strokes,gdouble *strokes - - -gimp_clone_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_color_picker -gboolean -gint32 image_ID,gint32 drawable_ID,gdouble x,gdouble y,gboolean sample_merged,gboolean sample_average,gdouble average_radius,gboolean save_color,GimpRGB *color - - -gimp_convolve -gboolean -gint32 drawable_ID,gdouble pressure,GimpConvolveType convolve_type,gint num_strokes,gdouble *strokes - - -gimp_convolve_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_crop -gboolean -gint32 image_ID,gint new_width,gint new_height,gint offx,gint offy - - -gimp_dodgeburn -gboolean -gint32 drawable_ID,gdouble exposure,GimpDodgeBurnType dodgeburn_type,GimpDodgeBurnMode dodgeburn_mode,gint num_strokes,gdouble *strokes - - -gimp_dodgeburn_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_ellipse_select -gboolean -gint32 image_ID,gdouble x,gdouble y,gdouble width,gdouble height,GimpChannelOps operation,gboolean antialias,gboolean feather,gdouble feather_radius - - -gimp_eraser -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes,GimpBrushApplicationMode hardness,GimpPaintApplicationMode method - - -gimp_eraser_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_flip -gint32 -gint32 drawable_ID,GimpOrientationType flip_type - - -gimp_free_select -gboolean -gint32 image_ID,gint num_segs,gdouble *segs,GimpChannelOps operation,gboolean antialias,gboolean feather,gdouble feather_radius - - -gimp_fuzzy_select -gboolean -gint32 drawable_ID,gdouble x,gdouble y,gint threshold,GimpChannelOps operation,gboolean antialias,gboolean feather,gdouble feather_radius,gboolean sample_merged - - -gimp_paintbrush -gboolean -gint32 drawable_ID,gdouble fade_out,gint num_strokes,gdouble *strokes,GimpPaintApplicationMode method,gdouble gradient_length - - -gimp_paintbrush_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_pencil -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_perspective -gint32 -gint32 drawable_ID,gboolean interpolation,gdouble x0,gdouble y0,gdouble x1,gdouble y1,gdouble x2,gdouble y2,gdouble x3,gdouble y3 - - -gimp_rect_select -gboolean -gint32 image_ID,gdouble x,gdouble y,gdouble width,gdouble height,GimpChannelOps operation,gboolean feather,gdouble feather_radius - - -gimp_rotate -gint32 -gint32 drawable_ID,gboolean interpolation,gdouble angle - - -gimp_scale -gint32 -gint32 drawable_ID,gboolean interpolation,gdouble x0,gdouble y0,gdouble x1,gdouble y1 - - -gimp_shear -gint32 -gint32 drawable_ID,gboolean interpolation,GimpOrientationType shear_type,gdouble magnitude - - -gimp_smudge -gboolean -gint32 drawable_ID,gdouble pressure,gint num_strokes,gdouble *strokes - - -gimp_smudge_default -gboolean -gint32 drawable_ID,gint num_strokes,gdouble *strokes - - -gimp_transform_2d -gint32 -gint32 drawable_ID,gboolean interpolation,gdouble source_x,gdouble source_y,gdouble scale_x,gdouble scale_y,gdouble angle,gdouble dest_x,gdouble dest_y - - -GimpPlugInInfo - - -GimpTile - - -GimpDrawable - - -GimpPixelRgn - - -GimpParamDef - - -GimpParamColor - - -GimpParamRegion - - -GimpParam - - -gimp_ui_init -void -const gchar *prog_name,gboolean preview - - -gimp_undo_push_group_start -gboolean -gint32 image_ID - - -gimp_undo_push_group_end -gboolean -gint32 image_ID - diff --git a/devel-docs/libgimp/libgimp.args b/devel-docs/libgimp/libgimp.args deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimp/libgimp.hierarchy b/devel-docs/libgimp/libgimp.hierarchy deleted file mode 100644 index 45f5911bb6..0000000000 --- a/devel-docs/libgimp/libgimp.hierarchy +++ /dev/null @@ -1,21 +0,0 @@ -GtkObject - GtkWidget - GtkRange - GtkScrollbar - GtkVScrollbar - GtkHScrollbar - GtkScale - GtkHScale - GtkVScale - GtkContainer - GtkBin - GtkButton - GtkToggleButton - GtkCheckButton - GtkRadioButton - GtkScrolledWindow - GtkPaned - GtkVPaned - GtkHPaned - GtkData - GtkAdjustment diff --git a/devel-docs/libgimp/libgimp.signals b/devel-docs/libgimp/libgimp.signals deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimp/libgimp.types b/devel-docs/libgimp/libgimp.types index 27497e4d4a..e69de29bb2 100644 --- a/devel-docs/libgimp/libgimp.types +++ b/devel-docs/libgimp/libgimp.types @@ -1,5 +0,0 @@ -#include -#include -#include - -#include "libgimp-include.c" diff --git a/devel-docs/libgimp/tmpl/gimp.sgml b/devel-docs/libgimp/tmpl/gimp.sgml index d7b28c4341..38a02cfa7c 100644 --- a/devel-docs/libgimp/tmpl/gimp.sgml +++ b/devel-docs/libgimp/tmpl/gimp.sgml @@ -286,22 +286,6 @@ all other GIMP Library headers. @Returns: - - - - - -@Returns: - - - - - - - -@Returns: - - diff --git a/devel-docs/libgimp/tmpl/gimpcolorselector.sgml b/devel-docs/libgimp/tmpl/gimpcolorselector.sgml index 9f59f6e887..3ee15c3ffb 100644 --- a/devel-docs/libgimp/tmpl/gimpcolorselector.sgml +++ b/devel-docs/libgimp/tmpl/gimpcolorselector.sgml @@ -133,9 +133,11 @@ instances have finished. The callback could be used to unload dynamiclly loaded code, for example. -@id: The @id as returned by gimp_color_selector_register(). +@selector_id: @finished_cb: Optional callback which will be called once all instances have finished. @finished_data: The @finished_data which will be passed to @finished_cb. @Returns: #TRUE on success, #FALSE if @id was not found. + +@id: The @id as returned by gimp_color_selector_register(). diff --git a/devel-docs/libgimp/tmpl/gimpdrawable.sgml b/devel-docs/libgimp/tmpl/gimpdrawable.sgml index e4b8cca727..a5d72d8162 100644 --- a/devel-docs/libgimp/tmpl/gimpdrawable.sgml +++ b/devel-docs/libgimp/tmpl/gimpdrawable.sgml @@ -19,7 +19,7 @@ gimpdrawable -@id: +@drawable_id: @width: @height: @bpp: diff --git a/devel-docs/libgimp/tmpl/gimpenums.sgml b/devel-docs/libgimp/tmpl/gimpenums.sgml index b74cba9504..ef9607c135 100644 --- a/devel-docs/libgimp/tmpl/gimpenums.sgml +++ b/devel-docs/libgimp/tmpl/gimpenums.sgml @@ -25,6 +25,8 @@ Enums and definitions. @GIMP_ALPHA_MASK: @GIMP_SELECTION_MASK: @GIMP_INV_SELECTION_MASK: +@GIMP_COPY_MASK: +@GIMP_INV_COPY_MASK: @@ -135,15 +137,6 @@ Enums and definitions. @GIMP_SHARPEN_CONVOLVE: @GIMP_CUSTOM_CONVOLVE: - - - - - -@GIMP_DODGEBURN_HIGHLIGHTS: -@GIMP_DODGEBURN_MIDTONES: -@GIMP_DODGEBURN_SHADOWS: - @@ -233,15 +226,6 @@ Enums and definitions. @GIMP_BLUE_HUES: @GIMP_MAGENTA_HUES: - - - - - -@GIMP_LINEAR_INTERPOLATION: -@GIMP_CUBIC_INTERPOLATION: -@GIMP_NEAREST_NEIGHBOR_INTERPOLATION: - @@ -266,6 +250,7 @@ Enums and definitions. @GIMP_DODGE_MODE: @GIMP_BURN_MODE: @GIMP_HARDLIGHT_MODE: +@GIMP_COLOR_ERASE_MODE: @@ -285,15 +270,6 @@ Enums and definitions. @GIMP_CLIP_TO_BOTTOM_LAYER: @GIMP_FLATTEN_IMAGE: - - - - - -@GIMP_MESSAGE_BOX: -@GIMP_CONSOLE: -@GIMP_ERROR_CONSOLE: - @@ -320,15 +296,17 @@ Enums and definitions. @GIMP_REPEAT_SAWTOOTH: @GIMP_REPEAT_TRIANGULAR: - + + @GIMP_RUN_INTERACTIVE: @GIMP_RUN_NONINTERACTIVE: @GIMP_RUN_WITH_LAST_VALS: + @@ -337,15 +315,6 @@ Enums and definitions. @GIMP_PIXELS: @GIMP_POINTS: - - - - - -@GIMP_STACK_TRACE_NEVER: -@GIMP_STACK_TRACE_QUERY: -@GIMP_STACK_TRACE_ALWAYS: - diff --git a/devel-docs/libgimp/tmpl/gimpgradients.sgml b/devel-docs/libgimp/tmpl/gimpgradients.sgml index 26ce2bbc43..24f2ef75fb 100644 --- a/devel-docs/libgimp/tmpl/gimpgradients.sgml +++ b/devel-docs/libgimp/tmpl/gimpgradients.sgml @@ -65,8 +65,8 @@ gimpgradients @name: -@width: @sample_size: +@width: @grad_data: @Returns: diff --git a/devel-docs/libgimp/tmpl/gimpmenu.sgml b/devel-docs/libgimp/tmpl/gimpmenu.sgml index dbfd461296..576a345965 100644 --- a/devel-docs/libgimp/tmpl/gimpmenu.sgml +++ b/devel-docs/libgimp/tmpl/gimpmenu.sgml @@ -30,8 +30,10 @@ Widgets and functions for selecting images, layers, brushes, patterns etc. -@id: +@any_id: @data: + +@id: diff --git a/devel-docs/libgimp/tmpl/gimptools.sgml b/devel-docs/libgimp/tmpl/gimptools.sgml index e6cd7fb3fb..71b74989a5 100644 --- a/devel-docs/libgimp/tmpl/gimptools.sgml +++ b/devel-docs/libgimp/tmpl/gimptools.sgml @@ -133,10 +133,10 @@ gimptools @sample_merged: @sample_average: @average_radius: -@save_color: @color: @Returns: +@save_color: @red: @green: @blue: @@ -166,19 +166,6 @@ gimptools @Returns: - - - - - -@image_ID: -@new_width: -@new_height: -@offx: -@offy: -@Returns: - - diff --git a/devel-docs/libgimpbase/.cvsignore b/devel-docs/libgimpbase/.cvsignore index 6aa52a55ca..46a764243a 100644 --- a/devel-docs/libgimpbase/.cvsignore +++ b/devel-docs/libgimpbase/.cvsignore @@ -1,7 +1,12 @@ Makefile Makefile.in -libgimpbase.html +libgimpbase.args +libgimpbase.hierarchy +libgimpbase.signals +libgimpbase-decl.txt libgimpbase-decl-list.txt libgimpbase-unused.txt +libgimpbase-undocumented.txt html sgml +*.stamp diff --git a/devel-docs/libgimpbase/Makefile.am b/devel-docs/libgimpbase/Makefile.am index 3d54e1c777..519969e34c 100644 --- a/devel-docs/libgimpbase/Makefile.am +++ b/devel-docs/libgimpbase/Makefile.am @@ -1,72 +1,148 @@ ## Process this file with automake to produce Makefile.in # The name of the module. -DOC_MODULE=libgimpbase +DOC_MODULE = libgimpbase # The top-level SGML file. -DOC_MAIN_SGML_FILE=libgimpbase-docs.sgml +DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml -# The directory containing the source code (if it contains documentation). -DOC_SOURCE_DIR=$(top_srcdir)/libgimpbase +# The directory containing the source code. +DOC_SOURCE_DIR = $(top_srcdir)/$(DOC_MODULE) -CFLAGS=`gimptool-1.4 --cflags` -LDFLAGS=`gimptool-1.4 --libs` +# Extra options to pass to gtkdoc-scangobj +SCANGOBJ_OPTIONS = + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS = + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS = + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS = + +# Used for dependencies +HFILE_GLOB = $(DOC_SOURCE_DIR)/*.h +CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c + +# Header files to ignore when scanning +IGNORE_HFILES = + +# Images to copy into HTML directory +HTML_IMAGES= + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE) +content_files = + +# Other files to distribute +extra_files = + +# CFLAGS and LDFLAGS for compiling scan program. Only needed +# if $(DOC_MODULE).types is non-empty. +GTKDOC_CFLAGS = +GTKDOC_LIBS = + +GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) +GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) + + +#################################### +# Everything below here is generic # +#################################### + +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) -libgimpbase_docdir = $(HTML_DIR) - -EXTRA_DIST = \ - $(DOC_MAIN_SGML_FILE) \ - $(DOC_MODULE).hierarchy \ - $(DOC_MODULE).signals \ +EXTRA_DIST = \ + $(content_files) \ + $(extra_files) \ + $(HTML_IMAGES) \ + $(DOC_MAIN_SGML_FILE) \ $(DOC_MODULE).types \ - $(DOC_MODULE)-include.c \ - $(DOC_MODULE)-decl.txt \ $(DOC_MODULE)-sections.txt +DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \ + $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).signals + if ENABLE_GTK_DOC -html/index.html: sgml/libgimpbase-doc.bottom - $(MAKE) html -else -html/index.html: +all-local: html-build.stamp + +#### scan #### + +scan-build.stamp: $(HFILE_GLOB) + @echo '*** Scanning header files ***' + if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ + else \ + cd $(srcdir) ; \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + cd $(srcdir) && \ + gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES) + touch scan-build.stamp + +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp + @true + +#### templates #### + +tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt + @echo '*** Rebuilding template files ***' + cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) + touch tmpl-build.stamp + +tmpl.stamp: tmpl-build.stamp + @true + +#### sgml #### + +sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml + @echo '*** Building SGML ***' + cd $(srcdir) && \ + gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS) + touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo '*** Building HTML ***' + rm -rf $(srcdir)/html + mkdir $(srcdir)/html + cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) + @echo '-- Fixing Crossreferences' + cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + touch html-build.stamp endif -sgml/libgimpbase-doc.bottom: $(tmpl_sources) - $(MAKE) sgml - -scan: - -(cd $(srcdir) \ - && env \ - CFLAGS="$(CFLAGS)" \ - CPPFLAGS="$(CPPFLAGS)" \ - LDFLAGS="$(LDFLAGS)" \ - gtkdoc-scanobj --module=$(DOC_MODULE) \ - && gtkdoc-scan \ - --module=$(DOC_MODULE) \ - --source-dir=$(DOC_SOURCE_DIR)) - -templates: scan - cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) - -sgml: - cd $(srcdir) \ - && gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) - -html: - test -d $(srcdir)/html || mkdir $(srcdir)/html - -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) +############## clean-local: - rm -f *~ *.bak *-unused.txt + rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) maintainer-clean-local: clean - cd $(srcdir) && 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-data-local: $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - (installfiles=`echo $(srcdir)/html/*.html`; \ - if test "$$installfiles" = '$(srcdir)/html/*.html'; \ + (installfiles=`echo $(srcdir)/html/*`; \ + if test "$$installfiles" = '$(srcdir)/html/*'; \ then echo '-- Nothing to install' ; \ else \ for i in $$installfiles; do \ @@ -75,17 +151,25 @@ 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: - mkdir $(distdir)/html - mkdir $(distdir)/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-check-gtkdoc dist-hook-local mkdir $(distdir)/tmpl - -cp $(srcdir)/html/*.html $(srcdir)/html/index.sgml $(distdir)/html + mkdir $(distdir)/sgml + mkdir $(distdir)/html -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml - -cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml + -cp $(srcdir)/html/* $(distdir)/html -.PHONY : html sgml templates scan +.PHONY : dist-hook-local diff --git a/devel-docs/libgimpbase/libgimpbase-decl.txt b/devel-docs/libgimpbase/libgimpbase-decl.txt deleted file mode 100644 index 54ad8717c1..0000000000 --- a/devel-docs/libgimpbase/libgimpbase-decl.txt +++ /dev/null @@ -1,773 +0,0 @@ - -GimpParasite - - -GimpUnit -typedef enum /*< chop=GIMP_ >*/ -{ - GIMP_UNIT_PIXEL = 0, - - GIMP_UNIT_INCH = 1, - GIMP_UNIT_MM = 2, - GIMP_UNIT_POINT = 3, - GIMP_UNIT_PICA = 4, - - GIMP_UNIT_END = 5, - - GIMP_UNIT_PERCENT = 65536 /*< skip >*/ -} GimpUnit; - - -GimpPDBArgType -typedef enum /*< chop=GIMP_ >*/ -{ - GIMP_PDB_INT32, - GIMP_PDB_INT16, - GIMP_PDB_INT8, - GIMP_PDB_FLOAT, - GIMP_PDB_STRING, - GIMP_PDB_INT32ARRAY, - GIMP_PDB_INT16ARRAY, - GIMP_PDB_INT8ARRAY, - GIMP_PDB_FLOATARRAY, - GIMP_PDB_STRINGARRAY, - GIMP_PDB_COLOR, - GIMP_PDB_REGION, - GIMP_PDB_DISPLAY, - GIMP_PDB_IMAGE, - GIMP_PDB_LAYER, - GIMP_PDB_CHANNEL, - GIMP_PDB_DRAWABLE, - GIMP_PDB_SELECTION, - GIMP_PDB_BOUNDARY, - GIMP_PDB_PATH, - GIMP_PDB_PARASITE, - GIMP_PDB_STATUS, - GIMP_PDB_END -} GimpPDBArgType; - - -GimpPDBProcType -typedef enum /*< chop=GIMP_ >*/ -{ - GIMP_INTERNAL, - GIMP_PLUGIN, - GIMP_EXTENSION, - GIMP_TEMPORARY -} GimpPDBProcType; - - -GimpPDBStatusType -typedef enum /*< chop=GIMP_ >*/ -{ - GIMP_PDB_EXECUTION_ERROR, - GIMP_PDB_CALLING_ERROR, - GIMP_PDB_PASS_THROUGH, - GIMP_PDB_SUCCESS, - GIMP_PDB_CANCEL -} GimpPDBStatusType; - - -gimp_directory -const gchar * -void - - -gimp_personal_rc_file -gchar * -const gchar *basename - - -gimp_data_directory -const gchar * -void - - -gimp_sysconf_directory -const gchar * -void - - -gimp_gtkrc -const gchar * -void - - -gimp_path_parse -GList * -const gchar *path,gint max_paths,gboolean check,GList **check_failed - - -gimp_path_to_str -gchar * -GList *path - - -gimp_path_free -void -GList *path - - -gimp_path_get_user_writable_dir -gchar * -GList *path - - -GIMP_MIN_IMAGE_SIZE -#define GIMP_MIN_IMAGE_SIZE 1 - - -GIMP_MAX_IMAGE_SIZE -#define GIMP_MAX_IMAGE_SIZE 16777216 /* 2^24 */ - - -GIMP_MIN_RESOLUTION -#define GIMP_MIN_RESOLUTION 5e-3 /* shouldn't display as 0.000 */ - - -GIMP_MAX_RESOLUTION -#define GIMP_MAX_RESOLUTION 65536.0 - - -GIMP_CHECK_SIZE -#define GIMP_CHECK_SIZE 8 - - -GIMP_CHECK_SIZE_SM -#define GIMP_CHECK_SIZE_SM 4 - - -GIMP_CHECK_DARK -#define GIMP_CHECK_DARK 0.4 /* corresponds to GRAY_CHECKS as */ - - -GIMP_CHECK_LIGHT -#define GIMP_CHECK_LIGHT 0.6 /* defined in app/image_render.c */ - - -GIMP_PARASITE_PERSISTENT -#define GIMP_PARASITE_PERSISTENT 1 - - -GIMP_PARASITE_UNDOABLE -#define GIMP_PARASITE_UNDOABLE 2 - - -GIMP_PARASITE_ATTACH_PARENT -#define GIMP_PARASITE_ATTACH_PARENT (0x80 << 8) - - -GIMP_PARASITE_PARENT_PERSISTENT -#define GIMP_PARASITE_PARENT_PERSISTENT (GIMP_PARASITE_PERSISTENT << 8) - - -GIMP_PARASITE_PARENT_UNDOABLE -#define GIMP_PARASITE_PARENT_UNDOABLE (GIMP_PARASITE_UNDOABLE << 8) - - -GIMP_PARASITE_ATTACH_GRANDPARENT -#define GIMP_PARASITE_ATTACH_GRANDPARENT (0x80 << 16) - - -GIMP_PARASITE_GRANDPARENT_PERSISTENT -#define GIMP_PARASITE_GRANDPARENT_PERSISTENT (GIMP_PARASITE_PERSISTENT << 16) - - -GIMP_PARASITE_GRANDPARENT_UNDOABLE -#define GIMP_PARASITE_GRANDPARENT_UNDOABLE (GIMP_PARASITE_UNDOABLE << 16) - - -GimpParasite -struct GimpParasite -{ - gchar *name; /* The name of the parasite. USE A UNIQUE PREFIX! */ - guint32 flags; /* save Parasite in XCF file, etc. */ - guint32 size; /* amount of data */ - gpointer data; /* a pointer to the data. plugin is * - * responsible for tracking byte order */ -}; - - -gimp_parasite_new -GimpParasite * -const gchar *name,guint32 flags,guint32 size,const gpointer data - - -gimp_parasite_free -void -GimpParasite *parasite - - -gimp_parasite_copy -GimpParasite * -const GimpParasite *parasite - - -gimp_parasite_compare -gboolean -const GimpParasite *a,const GimpParasite *b - - -gimp_parasite_is_type -gboolean -const GimpParasite *parasite,const gchar *name - - -gimp_parasite_is_persistent -gboolean -const GimpParasite *parasite - - -gimp_parasite_is_undoable -gboolean -const GimpParasite *parasite - - -gimp_parasite_has_flag -gboolean -const GimpParasite *parasite,gulong flag - - -gimp_parasite_flags -gulong -const GimpParasite *parasite - - -gimp_parasite_name -const gchar * -const GimpParasite *parasite - - -gimp_parasite_data -gpointer -const GimpParasite *parasite - - -gimp_parasite_data_size -glong -const GimpParasite *parasite - - -GIMP_PIXPIPE_MAXDIM -#define GIMP_PIXPIPE_MAXDIM 4 - - -gimp_pixpipe_params_init -void -GimpPixPipeParams *params - - -gimp_pixpipe_params_parse -void -gchar *parameters,GimpPixPipeParams *params - - -gimp_pixpipe_params_build -gchar * -GimpPixPipeParams *params - - -GP_VERSION -#define GP_VERSION 0x0008 - - -GPConfig - - -GPTileReq - - -GPTileAck - - -GPTileData - - -GPParam - - -GPParamDef - - -GPProcRun - - -GPProcReturn - - -GPProcInstall - - -GPProcUninstall - - -GPConfig -struct GPConfig -{ - guint32 version; - guint32 tile_width; - guint32 tile_height; - gint32 shm_ID; - gdouble gamma; - gint8 install_cmap; - gint8 use_xshm; - gint32 min_colors; - gint32 gdisp_ID; -}; - - -GPTileReq -struct GPTileReq -{ - gint32 drawable_ID; - guint32 tile_num; - guint32 shadow; -}; - - -GPTileData -struct GPTileData -{ - gint32 drawable_ID; - guint32 tile_num; - guint32 shadow; - guint32 bpp; - guint32 width; - guint32 height; - guint32 use_shm; - guchar *data; -}; - - -GPParam -struct GPParam -{ - guint32 type; - - union - { - gint32 d_int32; - gint16 d_int16; - gint8 d_int8; - gdouble d_float; - gchar *d_string; - gint32 *d_int32array; - gint16 *d_int16array; - gint8 *d_int8array; - gdouble *d_floatarray; - gchar **d_stringarray; - GimpRGB d_color; - struct - { - gint32 x; - gint32 y; - gint32 width; - gint32 height; - } d_region; - gint32 d_display; - gint32 d_image; - gint32 d_layer; - gint32 d_channel; - gint32 d_drawable; - gint32 d_selection; - gint32 d_boundary; - gint32 d_path; - struct - { - gchar *name; - guint32 flags; - guint32 size; - gpointer data; - } d_parasite; - gint32 d_status; - } data; -}; - - -GPParamDef -struct GPParamDef -{ - guint32 type; - gchar *name; - gchar *description; -}; - - -GPProcRun -struct GPProcRun -{ - gchar *name; - guint32 nparams; - GPParam *params; -}; - - -GPProcReturn -struct GPProcReturn -{ - gchar *name; - guint32 nparams; - GPParam *params; -}; - - -GPProcInstall -struct GPProcInstall -{ - gchar *name; - gchar *blurb; - gchar *help; - gchar *author; - gchar *copyright; - gchar *date; - gchar *menu_path; - gchar *image_types; - guint32 type; - guint32 nparams; - guint32 nreturn_vals; - GPParamDef *params; - GPParamDef *return_vals; -}; - - -GPProcUninstall -struct GPProcUninstall -{ - gchar *name; -}; - - -gp_init -void -void - - -gp_quit_write -gboolean -GIOChannel *channel - - -gp_config_write -gboolean -GIOChannel *channel,GPConfig *config - - -gp_tile_req_write -gboolean -GIOChannel *channel,GPTileReq *tile_req - - -gp_tile_ack_write -gboolean -GIOChannel *channel - - -gp_tile_data_write -gboolean -GIOChannel *channel,GPTileData *tile_data - - -gp_proc_run_write -gboolean -GIOChannel *channel,GPProcRun *proc_run - - -gp_proc_return_write -gboolean -GIOChannel *channel,GPProcReturn *proc_return - - -gp_temp_proc_run_write -gboolean -GIOChannel *channel,GPProcRun *proc_run - - -gp_temp_proc_return_write -gboolean -GIOChannel *channel,GPProcReturn *proc_return - - -gp_proc_install_write -gboolean -GIOChannel *channel,GPProcInstall *proc_install - - -gp_proc_uninstall_write -gboolean -GIOChannel *channel,GPProcUninstall *proc_uninstall - - -gp_extension_ack_write -gboolean -GIOChannel *channel - - -SA_RESTART -#define SA_RESTART SA_SYSV - - -GimpSignalHandlerFunc -void -gint signum - - -gimp_signal_private -GimpSignalHandlerFunc -gint signum,GimpSignalHandlerFunc handler,gint flags - - -gimp_signal_syscallrestart -#define gimp_signal_syscallrestart(signum,handler) gimp_signal_private ((signum), (handler), SA_RESTART) - - -gimp_unit_get_number_of_units -gint -void - - -gimp_unit_get_number_of_built_in_units -gint -void - - -gimp_unit_new -GimpUnit -gchar *identifier,gdouble factor,gint digits,gchar *symbol,gchar *abbreviation,gchar *singular,gchar *plural - - -gimp_unit_get_deletion_flag -gboolean -GimpUnit unit - - -gimp_unit_set_deletion_flag -void -GimpUnit unit,gboolean deletion_flag - - -gimp_unit_get_factor -gdouble -GimpUnit unit - - -gimp_unit_get_digits -gint -GimpUnit unit - - -gimp_unit_get_identifier -gchar * -GimpUnit unit - - -gimp_unit_get_symbol -gchar * -GimpUnit unit - - -gimp_unit_get_abbreviation -gchar * -GimpUnit unit - - -gimp_unit_get_singular -gchar * -GimpUnit unit - - -gimp_unit_get_plural -gchar * -GimpUnit unit - - -gimp_strescape -#define gimp_strescape(string, exceptions) g_strescape (string, exceptions) - - -gimp_strcompress -#define gimp_strcompress(string) g_strcompress (string) - - -gimp_strescape -gchar * -const gchar *source,const gchar *exceptions - - -gimp_strcompress -gchar * -const gchar *source - - -WireMessage - - -WireReadFunc -void -GIOChannel *channel, - WireMessage *msg - - -WireWriteFunc -void -GIOChannel *channel, - WireMessage *msg - - -WireDestroyFunc -void -WireMessage *msg - - -WireIOFunc -gboolean -GIOChannel *channel, - guint8 *buf, - gulong count - - -WireFlushFunc -gboolean -GIOChannel *channel - - -WireMessage -struct WireMessage -{ - guint32 type; - gpointer data; -}; - - -wire_register -void -guint32 type,WireReadFunc read_func,WireWriteFunc write_func,WireDestroyFunc destroy_func - - -wire_set_reader -void -WireIOFunc read_func - - -wire_set_writer -void -WireIOFunc write_func - - -wire_set_flusher -void -WireFlushFunc flush_func - - -wire_read -gboolean -GIOChannel *channel,guint8 *buf,gulong count - - -wire_write -gboolean -GIOChannel *channel,guint8 *buf,gulong count - - -wire_flush -gboolean -GIOChannel *channel - - -wire_error -gboolean -void - - -wire_clear_error -void -void - - -wire_read_msg -gboolean -GIOChannel *channel,WireMessage *msg - - -wire_write_msg -gboolean -GIOChannel *channel,WireMessage *msg - - -wire_destroy -void -WireMessage *msg - - -wire_read_int32 -gboolean -GIOChannel *channel,guint32 *data,gint count - - -wire_read_int16 -gboolean -GIOChannel *channel,guint16 *data,gint count - - -wire_read_int8 -gboolean -GIOChannel *channel,guint8 *data,gint count - - -wire_read_double -gboolean -GIOChannel *channel,gdouble *data,gint count - - -wire_read_string -gboolean -GIOChannel *channel,gchar **data,gint count - - -wire_write_int32 -gboolean -GIOChannel *channel,guint32 *data,gint count - - -wire_write_int16 -gboolean -GIOChannel *channel,guint16 *data,gint count - - -wire_write_int8 -gboolean -GIOChannel *channel,guint8 *data,gint count - - -wire_write_double -gboolean -GIOChannel *channel,gdouble *data,gint count - - -wire_write_string -gboolean -GIOChannel *channel,gchar **data,gint count - - -GIMP_MAJOR_VERSION -#define GIMP_MAJOR_VERSION (1) - - -GIMP_MINOR_VERSION -#define GIMP_MINOR_VERSION (3) - - -GIMP_MICRO_VERSION -#define GIMP_MICRO_VERSION (0) - - -GIMP_VERSION -#define GIMP_VERSION "1.3.0" - - -GIMP_CHECK_VERSION -#define GIMP_CHECK_VERSION(major, minor, micro) \ - (GIMP_MAJOR_VERSION > (major) || \ - (GIMP_MAJOR_VERSION == (major) && GIMP_MINOR_VERSION > (minor)) || \ - (GIMP_MAJOR_VERSION == (major) && GIMP_MINOR_VERSION == (minor) && \ - GIMP_MICRO_VERSION >= (micro))) - diff --git a/devel-docs/libgimpbase/libgimpbase-include.c b/devel-docs/libgimpbase/libgimpbase-include.c deleted file mode 100644 index cb369e86c0..0000000000 --- a/devel-docs/libgimpbase/libgimpbase-include.c +++ /dev/null @@ -1,15 +0,0 @@ -/* - * gtk-doc can't build libgimpbase-scan.c without PLUG_IN_INFO being defined - * so we include this file as a workaround - */ - -#include -#include - -GimpPlugInInfo PLUG_IN_INFO = -{ - NULL, - NULL, - NULL, - NULL, -}; diff --git a/devel-docs/libgimpbase/libgimpbase.args b/devel-docs/libgimpbase/libgimpbase.args deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpbase/libgimpbase.hierarchy b/devel-docs/libgimpbase/libgimpbase.hierarchy deleted file mode 100644 index 45f5911bb6..0000000000 --- a/devel-docs/libgimpbase/libgimpbase.hierarchy +++ /dev/null @@ -1,21 +0,0 @@ -GtkObject - GtkWidget - GtkRange - GtkScrollbar - GtkVScrollbar - GtkHScrollbar - GtkScale - GtkHScale - GtkVScale - GtkContainer - GtkBin - GtkButton - GtkToggleButton - GtkCheckButton - GtkRadioButton - GtkScrolledWindow - GtkPaned - GtkVPaned - GtkHPaned - GtkData - GtkAdjustment diff --git a/devel-docs/libgimpbase/libgimpbase.signals b/devel-docs/libgimpbase/libgimpbase.signals deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpbase/libgimpbase.types b/devel-docs/libgimpbase/libgimpbase.types index 7d226f6fa6..e69de29bb2 100644 --- a/devel-docs/libgimpbase/libgimpbase.types +++ b/devel-docs/libgimpbase/libgimpbase.types @@ -1,3 +0,0 @@ -#include - -#include "libgimpbase-include.c" diff --git a/devel-docs/libgimpbase/tmpl/gimpprotocol.sgml b/devel-docs/libgimpbase/tmpl/gimpprotocol.sgml index 04b4404ed1..23e4944625 100644 --- a/devel-docs/libgimpbase/tmpl/gimpprotocol.sgml +++ b/devel-docs/libgimpbase/tmpl/gimpprotocol.sgml @@ -33,7 +33,7 @@ The communication protocol between GIMP and it's plug-ins. @shm_ID: @gamma: @install_cmap: -@use_xshm: +@unused: @min_colors: @gdisp_ID: diff --git a/devel-docs/libgimpbase/tmpl/gimputils.sgml b/devel-docs/libgimpbase/tmpl/gimputils.sgml index 8688e1f1b6..b8494a7d68 100644 --- a/devel-docs/libgimpbase/tmpl/gimputils.sgml +++ b/devel-docs/libgimpbase/tmpl/gimputils.sgml @@ -16,22 +16,3 @@ provide it here. g_strescape() - - - - - -@source: -@exceptions: -@Returns: - - - - - - - -@source: -@Returns: - - diff --git a/devel-docs/libgimpcolor/.cvsignore b/devel-docs/libgimpcolor/.cvsignore index 70690fb9ca..dd5cbc76c6 100644 --- a/devel-docs/libgimpcolor/.cvsignore +++ b/devel-docs/libgimpcolor/.cvsignore @@ -1,7 +1,12 @@ Makefile Makefile.in -libgimpcolor.html +libgimpcolor.args +libgimpcolor.hierarchy +libgimpcolor.signals +libgimpcolor-decl.txt libgimpcolor-decl-list.txt libgimpcolor-unused.txt +libgimpcolor-undocumented.txt html sgml +*.stamp diff --git a/devel-docs/libgimpcolor/Makefile.am b/devel-docs/libgimpcolor/Makefile.am index 0fd76d3632..e02f53454c 100644 --- a/devel-docs/libgimpcolor/Makefile.am +++ b/devel-docs/libgimpcolor/Makefile.am @@ -1,72 +1,148 @@ ## Process this file with automake to produce Makefile.in # The name of the module. -DOC_MODULE=libgimpcolor +DOC_MODULE = libgimpcolor # The top-level SGML file. -DOC_MAIN_SGML_FILE=libgimpcolor-docs.sgml +DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml -# The directory containing the source code (if it contains documentation). -DOC_SOURCE_DIR=$(top_srcdir)/libgimpcolor +# The directory containing the source code. +DOC_SOURCE_DIR = $(top_srcdir)/$(DOC_MODULE) -CFLAGS=`gimptool-1.4 --cflags` -LDFLAGS=`gimptool-1.4 --libs` +# Extra options to pass to gtkdoc-scangobj +SCANGOBJ_OPTIONS = + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS = + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS = + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS = + +# Used for dependencies +HFILE_GLOB = $(DOC_SOURCE_DIR)/*.h +CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c + +# Header files to ignore when scanning +IGNORE_HFILES = + +# Images to copy into HTML directory +HTML_IMAGES= + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE) +content_files = + +# Other files to distribute +extra_files = + +# CFLAGS and LDFLAGS for compiling scan program. Only needed +# if $(DOC_MODULE).types is non-empty. +GTKDOC_CFLAGS = +GTKDOC_LIBS = + +GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) +GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) + + +#################################### +# Everything below here is generic # +#################################### + +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) -libgimpcolor_docdir = $(HTML_DIR) - -EXTRA_DIST = \ - $(DOC_MAIN_SGML_FILE) \ - $(DOC_MODULE).hierarchy \ - $(DOC_MODULE).signals \ +EXTRA_DIST = \ + $(content_files) \ + $(extra_files) \ + $(HTML_IMAGES) \ + $(DOC_MAIN_SGML_FILE) \ $(DOC_MODULE).types \ - $(DOC_MODULE)-include.c \ - $(DOC_MODULE)-decl.txt \ $(DOC_MODULE)-sections.txt +DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \ + $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).signals + if ENABLE_GTK_DOC -html/index.html: sgml/libgimpcolor-doc.bottom - $(MAKE) html -else -html/index.html: +all-local: html-build.stamp + +#### scan #### + +scan-build.stamp: $(HFILE_GLOB) + @echo '*** Scanning header files ***' + if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ + else \ + cd $(srcdir) ; \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + cd $(srcdir) && \ + gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES) + touch scan-build.stamp + +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp + @true + +#### templates #### + +tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt + @echo '*** Rebuilding template files ***' + cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) + touch tmpl-build.stamp + +tmpl.stamp: tmpl-build.stamp + @true + +#### sgml #### + +sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml + @echo '*** Building SGML ***' + cd $(srcdir) && \ + gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS) + touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo '*** Building HTML ***' + rm -rf $(srcdir)/html + mkdir $(srcdir)/html + cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) + @echo '-- Fixing Crossreferences' + cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + touch html-build.stamp endif -sgml/libgimpcolor-doc.bottom: $(tmpl_sources) - $(MAKE) sgml - -scan: - -(cd $(srcdir) \ - && env \ - CFLAGS="$(CFLAGS)" \ - CPPFLAGS="$(CPPFLAGS)" \ - LDFLAGS="$(LDFLAGS)" \ - gtkdoc-scanobj --module=$(DOC_MODULE) \ - && gtkdoc-scan \ - --module=$(DOC_MODULE) \ - --source-dir=$(DOC_SOURCE_DIR)) - -templates: scan - cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) - -sgml: - cd $(srcdir) \ - && gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) - -html: - test -d $(srcdir)/html || mkdir $(srcdir)/html - -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) +############## clean-local: - rm -f *~ *.bak *-unused.txt + rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) maintainer-clean-local: clean - cd $(srcdir) && 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-data-local: $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - (installfiles=`echo $(srcdir)/html/*.html`; \ - if test "$$installfiles" = '$(srcdir)/html/*.html'; \ + (installfiles=`echo $(srcdir)/html/*`; \ + if test "$$installfiles" = '$(srcdir)/html/*'; \ then echo '-- Nothing to install' ; \ else \ for i in $$installfiles; do \ @@ -75,17 +151,25 @@ 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: - mkdir $(distdir)/html - mkdir $(distdir)/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-check-gtkdoc dist-hook-local mkdir $(distdir)/tmpl - -cp $(srcdir)/html/*.html $(srcdir)/html/index.sgml $(distdir)/html + mkdir $(distdir)/sgml + mkdir $(distdir)/html -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml - -cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml + -cp $(srcdir)/html/* $(distdir)/html -.PHONY : html sgml templates scan +.PHONY : dist-hook-local diff --git a/devel-docs/libgimpcolor/libgimpcolor-decl.txt b/devel-docs/libgimpcolor/libgimpcolor-decl.txt deleted file mode 100644 index 97bdba19a3..0000000000 --- a/devel-docs/libgimpcolor/libgimpcolor-decl.txt +++ /dev/null @@ -1,306 +0,0 @@ - -GimpRGBCompositeMode -typedef enum -{ - GIMP_RGB_COMPOSITE_NONE = 0, - GIMP_RGB_COMPOSITE_NORMAL, - GIMP_RGB_COMPOSITE_BEHIND -} GimpRGBCompositeMode; - - -gimp_rgb_set -void -GimpRGB *rgb,gdouble r,gdouble g,gdouble b - - -gimp_rgb_set_alpha -void -GimpRGB *rgb,gdouble a - - -gimp_rgb_set_uchar -void -GimpRGB *rgb,guchar r,guchar g,guchar b - - -gimp_rgb_get_uchar -void -const GimpRGB *rgb,guchar *r,guchar *g,guchar *b - - -gimp_rgb_add -void -GimpRGB *rgb1,const GimpRGB *rgb2 - - -gimp_rgb_subtract -void -GimpRGB *rgb1,const GimpRGB *rgb2 - - -gimp_rgb_multiply -void -GimpRGB *rgb1,gdouble factor - - -gimp_rgb_distance -gdouble -const GimpRGB *rgb1,const GimpRGB *rgb2 - - -gimp_rgb_max -gdouble -const GimpRGB *rgb - - -gimp_rgb_min -gdouble -const GimpRGB *rgb - - -gimp_rgb_clamp -void -GimpRGB *rgb - - -gimp_rgb_gamma -void -GimpRGB *rgb,gdouble gamma - - -gimp_rgb_intensity -gdouble -const GimpRGB *rgb - - -gimp_rgb_intensity_uchar -guchar -const GimpRGB *rgb - - -gimp_rgb_composite -void -GimpRGB *color1,const GimpRGB *color2,GimpRGBCompositeMode mode - - -gimp_rgba_set -void -GimpRGB *rgba,gdouble r,gdouble g,gdouble b,gdouble a - - -gimp_rgba_set_uchar -void -GimpRGB *rgba,guchar r,guchar g,guchar b,guchar a - - -gimp_rgba_get_uchar -void -const GimpRGB *rgba,guchar *r,guchar *g,guchar *b,guchar *a - - -gimp_rgba_add -void -GimpRGB *rgba1,const GimpRGB *rgba2 - - -gimp_rgba_subtract -void -GimpRGB *rgba1,const GimpRGB *rgba2 - - -gimp_rgba_multiply -void -GimpRGB *rgba,gdouble factor - - -gimp_rgba_distance -gdouble -const GimpRGB *rgba1,const GimpRGB *rgba2 - - -INTENSITY_RED -#define INTENSITY_RED 0.30 - - -INTENSITY_GREEN -#define INTENSITY_GREEN 0.59 - - -INTENSITY_BLUE -#define INTENSITY_BLUE 0.11 - - -INTENSITY -#define INTENSITY(r,g,b) ((r) * INTENSITY_RED + \ - (g) * INTENSITY_GREEN + \ - (b) * INTENSITY_BLUE + 0.001) - - -gimp_hsv_set -void -GimpHSV *hsv,gdouble h,gdouble s,gdouble v - - -gimp_hsv_clamp -void -GimpHSV *hsv - - -gimp_hsva_set -void -GimpHSV *hsva,gdouble h,gdouble s,gdouble v,gdouble a - - -GimpRGB - - -GimpRGB -struct GimpRGB -{ - gdouble r, g, b, a; -}; - - -GimpHSV - - -GimpHSV -struct GimpHSV -{ - gdouble h, s, v, a; -}; - - -GimpRenderFunc -void -gdouble x, - gdouble y, - GimpRGB *color, - gpointer data - - -GimpPutPixelFunc -void -gint x, - gint y, - GimpRGB *color, - gpointer data - - -GimpProgressFunc -void -gint min, - gint max, - gint current, - gpointer data - - -gimp_rgb_to_hsv -void -const GimpRGB *rgb,GimpHSV *hsv - - -gimp_rgb_to_hsl -void -const GimpRGB *rgb,gdouble *hue,gdouble *saturation,gdouble *lightness - - -gimp_hsv_to_rgb -void -const GimpHSV *hsv,GimpRGB *rgb - - -gimp_hsl_to_rgb -void -gdouble hue,gdouble saturation,gdouble lightness,GimpRGB *rgb - - -gimp_rgb_to_hwb -void -const GimpRGB *rgb,gdouble *hue,gdouble *whiteness,gdouble *blackness - - -gimp_hwb_to_rgb -void -gdouble hue,gdouble whiteness,gdouble blackness,GimpRGB *rgb - - -gimp_rgb_to_hsv_int -void -gint *red ,gint *green ,gint *blue - - -gimp_hsv_to_rgb_int -void -gint *hue ,gint *saturation ,gint *value - - -gimp_rgb_to_hls_int -void -gint *red ,gint *green ,gint *blue - - -gimp_rgb_to_l_int -gint -gint red,gint green,gint blue - - -gimp_hls_to_rgb_int -void -gint *hue ,gint *lightness ,gint *saturation - - -gimp_rgb_to_hsv_double -void -gdouble *red ,gdouble *green ,gdouble *blue - - -gimp_hsv_to_rgb_double -void -gdouble *hue ,gdouble *saturation,gdouble *value - - -gimp_rgb_to_hsv4 -void -guchar *hsv,gdouble *red,gdouble *green,gdouble *blue - - -gimp_hsv_to_rgb4 -void -guchar *rgb,gdouble hue,gdouble saturation,gdouble value - - -gimp_adaptive_supersample_area -gulong -gint x1,gint y1,gint x2,gint y2,gint max_depth,gdouble threshold,GimpRenderFunc render_func,gpointer render_data,GimpPutPixelFunc put_pixel_func,gpointer put_pixel_data,GimpProgressFunc progress_func,gpointer progress_data - - -gimp_bilinear -gdouble -gdouble x,gdouble y,gdouble *values - - -gimp_bilinear_8 -guchar -gdouble x,gdouble y,guchar *values - - -gimp_bilinear_16 -guint16 -gdouble x,gdouble y,guint16 *values - - -gimp_bilinear_32 -guint32 -gdouble x,gdouble y,guint32 *values - - -gimp_bilinear_rgb -GimpRGB -gdouble x,gdouble y,GimpRGB *values - - -gimp_bilinear_rgba -GimpRGB -gdouble x,gdouble y,GimpRGB *values - diff --git a/devel-docs/libgimpcolor/libgimpcolor-include.c b/devel-docs/libgimpcolor/libgimpcolor-include.c deleted file mode 100644 index 05dafe0346..0000000000 --- a/devel-docs/libgimpcolor/libgimpcolor-include.c +++ /dev/null @@ -1,15 +0,0 @@ -/* - * gtk-doc can't build libgimpcolor-scan.c without PLUG_IN_INFO being defined - * so we include this file as a workaround - */ - -#include -#include - -GimpPlugInInfo PLUG_IN_INFO = -{ - NULL, - NULL, - NULL, - NULL, -}; diff --git a/devel-docs/libgimpcolor/libgimpcolor.args b/devel-docs/libgimpcolor/libgimpcolor.args deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpcolor/libgimpcolor.hierarchy b/devel-docs/libgimpcolor/libgimpcolor.hierarchy deleted file mode 100644 index 45f5911bb6..0000000000 --- a/devel-docs/libgimpcolor/libgimpcolor.hierarchy +++ /dev/null @@ -1,21 +0,0 @@ -GtkObject - GtkWidget - GtkRange - GtkScrollbar - GtkVScrollbar - GtkHScrollbar - GtkScale - GtkHScale - GtkVScale - GtkContainer - GtkBin - GtkButton - GtkToggleButton - GtkCheckButton - GtkRadioButton - GtkScrolledWindow - GtkPaned - GtkVPaned - GtkHPaned - GtkData - GtkAdjustment diff --git a/devel-docs/libgimpcolor/libgimpcolor.signals b/devel-docs/libgimpcolor/libgimpcolor.signals deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpcolor/libgimpcolor.types b/devel-docs/libgimpcolor/libgimpcolor.types index 253a1eee9a..e69de29bb2 100644 --- a/devel-docs/libgimpcolor/libgimpcolor.types +++ b/devel-docs/libgimpcolor/libgimpcolor.types @@ -1,3 +0,0 @@ -#include - -#include "libgimpcolor-include.c" diff --git a/devel-docs/libgimpmath/.cvsignore b/devel-docs/libgimpmath/.cvsignore index dc03628c3e..8a1477c5ee 100644 --- a/devel-docs/libgimpmath/.cvsignore +++ b/devel-docs/libgimpmath/.cvsignore @@ -1,7 +1,12 @@ Makefile Makefile.in -libgimpmath.html +libgimpmath.args +libgimpmath.hierarchy +libgimpmath.signals +libgimpmath-decl.txt libgimpmath-decl-list.txt libgimpmath-unused.txt +libgimpmath-undocumented.txt html sgml +*.stamp diff --git a/devel-docs/libgimpmath/Makefile.am b/devel-docs/libgimpmath/Makefile.am index af3b713999..59fb167c5b 100644 --- a/devel-docs/libgimpmath/Makefile.am +++ b/devel-docs/libgimpmath/Makefile.am @@ -1,72 +1,148 @@ ## Process this file with automake to produce Makefile.in # The name of the module. -DOC_MODULE=libgimpmath +DOC_MODULE = libgimpmath # The top-level SGML file. -DOC_MAIN_SGML_FILE=libgimpmath-docs.sgml +DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml -# The directory containing the source code (if it contains documentation). -DOC_SOURCE_DIR=$(top_srcdir)/libgimpmath +# The directory containing the source code. +DOC_SOURCE_DIR = $(top_srcdir)/$(DOC_MODULE) -CFLAGS=`gimptool-1.4 --cflags` -LDFLAGS=`gimptool-1.4 --libs` +# Extra options to pass to gtkdoc-scangobj +SCANGOBJ_OPTIONS = + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS = + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS = + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS = + +# Used for dependencies +HFILE_GLOB = $(DOC_SOURCE_DIR)/*.h +CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c + +# Header files to ignore when scanning +IGNORE_HFILES = + +# Images to copy into HTML directory +HTML_IMAGES= + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE) +content_files = + +# Other files to distribute +extra_files = + +# CFLAGS and LDFLAGS for compiling scan program. Only needed +# if $(DOC_MODULE).types is non-empty. +GTKDOC_CFLAGS = +GTKDOC_LIBS = + +GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) +GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) + + +#################################### +# Everything below here is generic # +#################################### + +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) -libgimpmath_docdir = $(HTML_DIR) - -EXTRA_DIST = \ - $(DOC_MAIN_SGML_FILE) \ - $(DOC_MODULE).hierarchy \ - $(DOC_MODULE).signals \ +EXTRA_DIST = \ + $(content_files) \ + $(extra_files) \ + $(HTML_IMAGES) \ + $(DOC_MAIN_SGML_FILE) \ $(DOC_MODULE).types \ - $(DOC_MODULE)-include.c \ - $(DOC_MODULE)-decl.txt \ $(DOC_MODULE)-sections.txt +DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \ + $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).signals + if ENABLE_GTK_DOC -html/index.html: sgml/libgimpmath-doc.bottom - $(MAKE) html -else -html/index.html: +all-local: html-build.stamp + +#### scan #### + +scan-build.stamp: $(HFILE_GLOB) + @echo '*** Scanning header files ***' + if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ + else \ + cd $(srcdir) ; \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + cd $(srcdir) && \ + gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES) + touch scan-build.stamp + +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp + @true + +#### templates #### + +tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt + @echo '*** Rebuilding template files ***' + cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) + touch tmpl-build.stamp + +tmpl.stamp: tmpl-build.stamp + @true + +#### sgml #### + +sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml + @echo '*** Building SGML ***' + cd $(srcdir) && \ + gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS) + touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo '*** Building HTML ***' + rm -rf $(srcdir)/html + mkdir $(srcdir)/html + cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) + @echo '-- Fixing Crossreferences' + cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + touch html-build.stamp endif -sgml/libgimpmath-doc.bottom: $(tmpl_sources) - $(MAKE) sgml - -scan: - -(cd $(srcdir) \ - && env \ - CFLAGS="$(CFLAGS)" \ - CPPFLAGS="$(CPPFLAGS)" \ - LDFLAGS="$(LDFLAGS)" \ - gtkdoc-scanobj --module=$(DOC_MODULE) \ - && gtkdoc-scan \ - --module=$(DOC_MODULE) \ - --source-dir=$(DOC_SOURCE_DIR)) - -templates: scan - cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) - -sgml: - cd $(srcdir) \ - && gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) - -html: - test -d $(srcdir)/html || mkdir $(srcdir)/html - -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) +############## clean-local: - rm -f *~ *.bak *-unused.txt + rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) maintainer-clean-local: clean - cd $(srcdir) && 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-data-local: $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - (installfiles=`echo $(srcdir)/html/*.html`; \ - if test "$$installfiles" = '$(srcdir)/html/*.html'; \ + (installfiles=`echo $(srcdir)/html/*`; \ + if test "$$installfiles" = '$(srcdir)/html/*'; \ then echo '-- Nothing to install' ; \ else \ for i in $$installfiles; do \ @@ -75,17 +151,25 @@ 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: - mkdir $(distdir)/html - mkdir $(distdir)/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-check-gtkdoc dist-hook-local mkdir $(distdir)/tmpl - -cp $(srcdir)/html/*.html $(srcdir)/html/index.sgml $(distdir)/html + mkdir $(distdir)/sgml + mkdir $(distdir)/html -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml - -cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml + -cp $(srcdir)/html/* $(distdir)/html -.PHONY : html sgml templates scan +.PHONY : dist-hook-local diff --git a/devel-docs/libgimpmath/libgimpmath-decl.txt b/devel-docs/libgimpmath/libgimpmath-decl.txt deleted file mode 100644 index fec23576b0..0000000000 --- a/devel-docs/libgimpmath/libgimpmath-decl.txt +++ /dev/null @@ -1,396 +0,0 @@ - -gimp_vector2_inner_product -gdouble -GimpVector2 *vector1,GimpVector2 *vector2 - - -gimp_vector2_inner_product_val -gdouble -GimpVector2 vector1,GimpVector2 vector2 - - -gimp_vector2_cross_product -GimpVector2 -GimpVector2 *vector1,GimpVector2 *vector2 - - -gimp_vector2_cross_product_val -GimpVector2 -GimpVector2 vector1,GimpVector2 vector2 - - -gimp_vector2_length -gdouble -GimpVector2 *vector - - -gimp_vector2_length_val -gdouble -GimpVector2 vector - - -gimp_vector2_normalize -void -GimpVector2 *vector - - -gimp_vector2_normalize_val -GimpVector2 -GimpVector2 vector - - -gimp_vector2_mul -void -GimpVector2 *vector,gdouble factor - - -gimp_vector2_mul_val -GimpVector2 -GimpVector2 vector,gdouble factor - - -gimp_vector2_sub -void -GimpVector2 *result,GimpVector2 *vector1,GimpVector2 *vector2 - - -gimp_vector2_sub_val -GimpVector2 -GimpVector2 vector1,GimpVector2 vector2 - - -gimp_vector2_set -void -GimpVector2 *vector,gdouble x,gdouble y - - -gimp_vector2_new_val -GimpVector2 -gdouble x,gdouble y - - -gimp_vector2_add -void -GimpVector2 *result,GimpVector2 *vector1,GimpVector2 *vector2 - - -gimp_vector2_add_val -GimpVector2 -GimpVector2 vector1,GimpVector2 vector2 - - -gimp_vector2_neg -void -GimpVector2 *vector - - -gimp_vector2_neg_val -GimpVector2 -GimpVector2 vector - - -gimp_vector2_rotate -void -GimpVector2 *vector,gdouble alpha - - -gimp_vector2_rotate_val -GimpVector2 -GimpVector2 vector,gdouble alpha - - -gimp_vector3_inner_product -gdouble -GimpVector3 *vector1,GimpVector3 *vector2 - - -gimp_vector3_inner_product_val -gdouble -GimpVector3 vector1,GimpVector3 vector2 - - -gimp_vector3_cross_product -GimpVector3 -GimpVector3 *vector1,GimpVector3 *vector2 - - -gimp_vector3_cross_product_val -GimpVector3 -GimpVector3 vector1,GimpVector3 vector2 - - -gimp_vector3_length -gdouble -GimpVector3 *vector - - -gimp_vector3_length_val -gdouble -GimpVector3 vector - - -gimp_vector3_normalize -void -GimpVector3 *vector - - -gimp_vector3_normalize_val -GimpVector3 -GimpVector3 vector - - -gimp_vector3_mul -void -GimpVector3 *vector,gdouble factor - - -gimp_vector3_mul_val -GimpVector3 -GimpVector3 vector,gdouble factor - - -gimp_vector3_sub -void -GimpVector3 *result,GimpVector3 *vector1,GimpVector3 *vector2 - - -gimp_vector3_sub_val -GimpVector3 -GimpVector3 vector1,GimpVector3 vector2 - - -gimp_vector3_set -void -GimpVector3 *vector,gdouble x,gdouble y,gdouble z - - -gimp_vector3_new -GimpVector3 -gdouble x,gdouble y,gdouble z - - -gimp_vector3_add -void -GimpVector3 *result,GimpVector3 *vector1,GimpVector3 *vector2 - - -gimp_vector3_add_val -GimpVector3 -GimpVector3 vector1,GimpVector3 vector2 - - -gimp_vector3_neg -void -GimpVector3 *vector - - -gimp_vector3_neg_val -GimpVector3 -GimpVector3 vector - - -gimp_vector3_rotate -void -GimpVector3 *vector,gdouble alpha,gdouble beta,gdouble gamma - - -gimp_vector3_rotate_val -GimpVector3 -GimpVector3 vector,gdouble alpha,gdouble beta,gdouble gamma - - -gimp_vector_2d_to_3d -void -gint sx,gint sy,gint w,gint h,gint x,gint y,GimpVector3 *vp,GimpVector3 *p - - -gimp_vector_2d_to_3d_val -GimpVector3 -gint sx,gint sy,gint w,gint h,gint x,gint y,GimpVector3 vp,GimpVector3 p - - -gimp_vector_3d_to_2d -void -gint sx,gint sy,gint w,gint h,gdouble *x,gdouble *y,GimpVector3 *vp,GimpVector3 *p - - -gimp_matrix3_transform_point -void -GimpMatrix3 matrix,gdouble x,gdouble y,gdouble *newx,gdouble *newy - - -gimp_matrix3_mult -void -GimpMatrix3 matrix1,GimpMatrix3 matrix2 - - -gimp_matrix3_identity -void -GimpMatrix3 matrix - - -gimp_matrix3_translate -void -GimpMatrix3 matrix,gdouble x,gdouble y - - -gimp_matrix3_scale -void -GimpMatrix3 matrix,gdouble x,gdouble y - - -gimp_matrix3_rotate -void -GimpMatrix3 matrix,gdouble theta - - -gimp_matrix3_xshear -void -GimpMatrix3 matrix,gdouble amount - - -gimp_matrix3_yshear -void -GimpMatrix3 matrix,gdouble amount - - -gimp_matrix3_determinant -gdouble -GimpMatrix3 matrix - - -gimp_matrix3_invert -void -GimpMatrix3 matrix,GimpMatrix3 matrix_inv - - -gimp_matrix3_duplicate -void -GimpMatrix3 src,GimpMatrix3 target - - -gimp_matrix3_is_diagonal -gboolean -GimpMatrix3 matrix - - -gimp_matrix3_is_identity -gboolean -GimpMatrix3 matrix - - -gimp_matrix3_is_simple -gboolean -GimpMatrix3 matrix - - -gimp_matrix4_to_deg -void -GimpMatrix4 matrix,gdouble *a,gdouble *b,gdouble *c - - -G_PI -#define G_PI 3.14159265358979323846 - - -G_PI_2 -#define G_PI_2 1.57079632679489661923 - - -G_PI_4 -#define G_PI_4 0.78539816339744830962 - - -G_SQRT2 -#define G_SQRT2 1.4142135623730951 - - -G_MAXRAND -#define G_MAXRAND G_MAXINT - - -G_MAXRAND -#define G_MAXRAND RAND_MAX - - -RINT -#define RINT(x) rint(x) - - -RINT -#define RINT(x) floor ((x) + 0.5) - - -ROUND -#define ROUND(x) ((int) ((x) + 0.5)) - - -SQR -#define SQR(x) ((x) * (x)) - - -MAX255 -#define MAX255(a) ((a) | (((a) & 256) - (((a) & 256) >> 8))) - - -CLAMP0255 -#define CLAMP0255(a) CLAMP(a,0,255) - - -gimp_deg_to_rad -#define gimp_deg_to_rad(angle) ((angle) * (2.0 * G_PI) / 360.0) - - -gimp_rad_to_deg -#define gimp_rad_to_deg(angle) ((angle) * 360.0 / (2.0 * G_PI)) - - -FINITE -#define FINITE(x) _finite(x) - - -FINITE -#define FINITE(x) isfinite(x) - - -FINITE -#define FINITE(x) finite(x) - - -GimpMatrix3[3][3] -typedef gdouble GimpMatrix3[3][3]; - - -GimpMatrix4[4][4] -typedef gdouble GimpMatrix4[4][4]; - - -GimpVector2 - - -GimpVector3 - - -GimpVector4 - - -GimpVector2 -struct GimpVector2 -{ - gdouble x, y; -}; - - -GimpVector3 -struct GimpVector3 -{ - gdouble x, y, z; -}; - - -GimpVector4 -struct GimpVector4 -{ - gdouble x, y, z, w; -}; - diff --git a/devel-docs/libgimpmath/libgimpmath-include.c b/devel-docs/libgimpmath/libgimpmath-include.c deleted file mode 100644 index 6bab458560..0000000000 --- a/devel-docs/libgimpmath/libgimpmath-include.c +++ /dev/null @@ -1,15 +0,0 @@ -/* - * gtk-doc can't build libgimpmath-scan.c without PLUG_IN_INFO being defined - * so we include this file as a workaround - */ - -#include -#include - -GimpPlugInInfo PLUG_IN_INFO = -{ - NULL, - NULL, - NULL, - NULL, -}; diff --git a/devel-docs/libgimpmath/libgimpmath.args b/devel-docs/libgimpmath/libgimpmath.args deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpmath/libgimpmath.hierarchy b/devel-docs/libgimpmath/libgimpmath.hierarchy deleted file mode 100644 index 45f5911bb6..0000000000 --- a/devel-docs/libgimpmath/libgimpmath.hierarchy +++ /dev/null @@ -1,21 +0,0 @@ -GtkObject - GtkWidget - GtkRange - GtkScrollbar - GtkVScrollbar - GtkHScrollbar - GtkScale - GtkHScale - GtkVScale - GtkContainer - GtkBin - GtkButton - GtkToggleButton - GtkCheckButton - GtkRadioButton - GtkScrolledWindow - GtkPaned - GtkVPaned - GtkHPaned - GtkData - GtkAdjustment diff --git a/devel-docs/libgimpmath/libgimpmath.signals b/devel-docs/libgimpmath/libgimpmath.signals deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpmath/libgimpmath.types b/devel-docs/libgimpmath/libgimpmath.types index a3bfd054a0..e69de29bb2 100644 --- a/devel-docs/libgimpmath/libgimpmath.types +++ b/devel-docs/libgimpmath/libgimpmath.types @@ -1,3 +0,0 @@ -#include - -#include "libgimpmath-include.c" diff --git a/devel-docs/libgimpmath/tmpl/gimpmath.sgml b/devel-docs/libgimpmath/tmpl/gimpmath.sgml index 75d3a3ecc4..4ee282d58f 100644 --- a/devel-docs/libgimpmath/tmpl/gimpmath.sgml +++ b/devel-docs/libgimpmath/tmpl/gimpmath.sgml @@ -14,34 +14,6 @@ Mathematical definitions and macros. - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/devel-docs/libgimpwidgets/.cvsignore b/devel-docs/libgimpwidgets/.cvsignore index 9b05e5452b..03986d70d3 100644 --- a/devel-docs/libgimpwidgets/.cvsignore +++ b/devel-docs/libgimpwidgets/.cvsignore @@ -1,7 +1,12 @@ Makefile Makefile.in -libgimpwidgets.html +libgimpwidgets.args +libgimpwidgets.hierarchy +libgimpwidgets.signals +libgimpwidgets-decl.txt libgimpwidgets-decl-list.txt libgimpwidgets-unused.txt +libgimpwidgets-undocumented.txt html sgml +*.stamp diff --git a/devel-docs/libgimpwidgets/Makefile.am b/devel-docs/libgimpwidgets/Makefile.am index e4ba3c4578..baef9ddec1 100644 --- a/devel-docs/libgimpwidgets/Makefile.am +++ b/devel-docs/libgimpwidgets/Makefile.am @@ -1,72 +1,162 @@ ## Process this file with automake to produce Makefile.in # The name of the module. -DOC_MODULE=libgimpwidgets +DOC_MODULE = libgimpwidgets # The top-level SGML file. -DOC_MAIN_SGML_FILE=libgimpwidgets-docs.sgml +DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml -# The directory containing the source code (if it contains documentation). -DOC_SOURCE_DIR=$(top_srcdir)/libgimpwidgets +# The directory containing the source code. +DOC_SOURCE_DIR = $(top_srcdir)/$(DOC_MODULE) -CFLAGS=`gimptool-1.4 --cflags` -LDFLAGS=`gimptool-1.4 --libs` +# Extra options to pass to gtkdoc-scangobj +SCANGOBJ_OPTIONS = + +# Extra options to supply to gtkdoc-scan +SCAN_OPTIONS = + +# Extra options to supply to gtkdoc-mkdb +MKDB_OPTIONS = + +# Extra options to supply to gtkdoc-fixref +FIXXREF_OPTIONS = + +# Used for dependencies +HFILE_GLOB = $(DOC_SOURCE_DIR)/*.h +CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c + +# Header files to ignore when scanning +IGNORE_HFILES = + +# Images to copy into HTML directory +HTML_IMAGES= + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE) +content_files = + +# Other files to distribute +extra_files = libgimp-include.c + +# CFLAGS and LDFLAGS for compiling scan program. Only needed +# if $(DOC_MODULE).types is non-empty. +GTKDOC_CFLAGS = @STRIP_BEGIN@ \ + @CFLAGS@ \ + -I$(top_srcdir) \ + -I$(top_builddir) \ + @GTK_CFLAGS@ \ +@STRIP_END@ + +GTKDOC_LIBS = @STRIP_BEGIN@ \ + $(top_builddir)/libgimpbase/libgimpbase-$(LT_RELEASE).la \ + $(top_builddir)/libgimpcolor/libgimpcolor-$(LT_RELEASE).la \ + $(top_builddir)/libgimpmath/libgimpmath-$(LT_RELEASE).la \ + $(top_builddir)/libgimpwidgets/libgimpwidgets-$(LT_RELEASE).la \ + $(top_builddir)/libgimp/libgimp-$(LT_RELEASE).la \ + $(top_builddir)/libgimp/libgimpui-$(LT_RELEASE).la \ + @GTK_LIBS@ \ +@STRIP_END@ + +GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) +GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) + + +#################################### +# Everything below here is generic # +#################################### + +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE) -libgimpwidgets_docdir = $(HTML_DIR) - -EXTRA_DIST = \ - $(DOC_MAIN_SGML_FILE) \ - $(DOC_MODULE).hierarchy \ - $(DOC_MODULE).signals \ +EXTRA_DIST = \ + $(content_files) \ + $(extra_files) \ + $(HTML_IMAGES) \ + $(DOC_MAIN_SGML_FILE) \ $(DOC_MODULE).types \ - $(DOC_MODULE)-include.c \ - $(DOC_MODULE)-decl.txt \ $(DOC_MODULE)-sections.txt +DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \ + $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).signals + if ENABLE_GTK_DOC -html/index.html: sgml/libgimpwidgets-doc.bottom - $(MAKE) html -else -html/index.html: +all-local: html-build.stamp + +#### scan #### + +scan-build.stamp: $(HFILE_GLOB) + @echo '*** Scanning header files ***' + if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ + else \ + cd $(srcdir) ; \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + cd $(srcdir) && \ + gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES) + touch scan-build.stamp + +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp + @true + +#### templates #### + +tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt + @echo '*** Rebuilding template files ***' + cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) + touch tmpl-build.stamp + +tmpl.stamp: tmpl-build.stamp + @true + +#### sgml #### + +sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml + @echo '*** Building SGML ***' + cd $(srcdir) && \ + gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) $(MKDB_OPTIONS) + touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo '*** Building HTML ***' + rm -rf $(srcdir)/html + mkdir $(srcdir)/html + cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) + @echo '-- Fixing Crossreferences' + cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + touch html-build.stamp endif -sgml/libgimpwidgets-doc.bottom: $(tmpl_sources) - $(MAKE) sgml - -scan: - -(cd $(srcdir) \ - && env \ - CFLAGS="$(CFLAGS)" \ - CPPFLAGS="$(CPPFLAGS)" \ - LDFLAGS="$(LDFLAGS)" \ - gtkdoc-scanobj --module=$(DOC_MODULE) \ - && gtkdoc-scan \ - --module=$(DOC_MODULE) \ - --source-dir=$(DOC_SOURCE_DIR)) - -templates: scan - cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) - -sgml: - cd $(srcdir) \ - && gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) - -html: - test -d $(srcdir)/html || mkdir $(srcdir)/html - -cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) +############## clean-local: - rm -f *~ *.bak *-unused.txt + rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) maintainer-clean-local: clean - cd $(srcdir) && 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-data-local: $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - (installfiles=`echo $(srcdir)/html/*.html`; \ - if test "$$installfiles" = '$(srcdir)/html/*.html'; \ + (installfiles=`echo $(srcdir)/html/*`; \ + if test "$$installfiles" = '$(srcdir)/html/*'; \ then echo '-- Nothing to install' ; \ else \ for i in $$installfiles; do \ @@ -75,17 +165,25 @@ 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: - mkdir $(distdir)/html - mkdir $(distdir)/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-check-gtkdoc dist-hook-local mkdir $(distdir)/tmpl - -cp $(srcdir)/html/*.html $(srcdir)/html/index.sgml $(distdir)/html + mkdir $(distdir)/sgml + mkdir $(distdir)/html -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml - -cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml + -cp $(srcdir)/html/* $(distdir)/html -.PHONY : html sgml templates scan +.PHONY : dist-hook-local diff --git a/devel-docs/libgimpwidgets/libgimpwidgets-decl.txt b/devel-docs/libgimpwidgets/libgimpwidgets-decl.txt deleted file mode 100644 index eb453eb136..0000000000 --- a/devel-docs/libgimpwidgets/libgimpwidgets-decl.txt +++ /dev/null @@ -1,1001 +0,0 @@ - -GIMP_TYPE_CHAIN_BUTTON -#define GIMP_TYPE_CHAIN_BUTTON (gimp_chain_button_get_type ()) - - -GIMP_CHAIN_BUTTON -#define GIMP_CHAIN_BUTTON(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_CHAIN_BUTTON, GimpChainButton)) - - -GIMP_CHAIN_BUTTON_CLASS -#define GIMP_CHAIN_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_CHAIN_BUTTON, GimpChainButtonClass)) - - -GIMP_IS_CHAIN_BUTTON -#define GIMP_IS_CHAIN_BUTTON(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_CHAIN_BUTTON)) - - -GIMP_IS_CHAIN_BUTTON_CLASS -#define GIMP_IS_CHAIN_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_CHAIN_BUTTON)) - - -GimpChainButtonClass - - -GimpChainPosition -typedef enum -{ - GIMP_CHAIN_TOP, - GIMP_CHAIN_LEFT, - GIMP_CHAIN_BOTTOM, - GIMP_CHAIN_RIGHT -} GimpChainPosition; - - -GimpChainButton -struct GimpChainButton -{ - GtkTable table; - - GimpChainPosition position; - GtkWidget *button; - GtkWidget *line1; - GtkWidget *line2; - GtkWidget *pixmap; - GdkPixmap *broken; - GdkBitmap *broken_mask; - GdkPixmap *chain; - GdkBitmap *chain_mask; - gboolean active; -}; - - -gimp_chain_button_get_type -GtkType -void - - -gimp_chain_button_new -GtkWidget * -GimpChainPosition position - - -gimp_chain_button_set_active -void -GimpChainButton *gcb,gboolean is_active - - -gimp_chain_button_get_active -gboolean -GimpChainButton *gcb - - -GIMP_TYPE_COLOR_AREA -#define GIMP_TYPE_COLOR_AREA (gimp_color_area_get_type ()) - - -GIMP_COLOR_AREA -#define GIMP_COLOR_AREA(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_COLOR_AREA, GimpColorArea)) - - -GIMP_COLOR_AREA_CLASS -#define GIMP_COLOR_AREA_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_COLOR_AREA, GimpColorAreaClass)) - - -GIMP_IS_COLOR_AREA -#define GIMP_IS_COLOR_AREA(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_COLOR_AREA)) - - -GIMP_IS_COLOR_AREA_CLASS -#define GIMP_IS_COLOR_AREA_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_COLOR_AREA)) - - -GimpColorAreaType -typedef enum -{ - GIMP_COLOR_AREA_FLAT = 0, - GIMP_COLOR_AREA_SMALL_CHECKS, - GIMP_COLOR_AREA_LARGE_CHECKS -} GimpColorAreaType; - - -GimpColorAreaClass - - -gimp_color_area_get_type -GtkType -void - - -gimp_color_area_new -GtkWidget * -const GimpRGB *color,GimpColorAreaType type,GdkModifierType drag_mask - - -gimp_color_area_set_color -void -GimpColorArea *gca,const GimpRGB *color - - -gimp_color_area_get_color -void -GimpColorArea *gca,GimpRGB *color - - -gimp_color_area_has_alpha -gboolean -GimpColorArea *gca - - -gimp_color_area_set_type -void -GimpColorArea *gca,GimpColorAreaType type - - -GIMP_TYPE_COLOR_BUTTON -#define GIMP_TYPE_COLOR_BUTTON (gimp_color_button_get_type ()) - - -GIMP_COLOR_BUTTON -#define GIMP_COLOR_BUTTON(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_COLOR_BUTTON, GimpColorButton)) - - -GIMP_COLOR_BUTTON_CLASS -#define GIMP_COLOR_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_COLOR_BUTTON, GimpColorButtonClass)) - - -GIMP_IS_COLOR_BUTTON -#define GIMP_IS_COLOR_BUTTON(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_COLOR_BUTTON)) - - -GIMP_IS_COLOR_BUTTON_CLASS -#define GIMP_IS_COLOR_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_COLOR_BUTTON)) - - -GimpColorButtonClass - - -GimpColorButton -struct GimpColorButton -{ - GtkButton button; - - gchar *title; - - GtkWidget *color_area; - GtkWidget *dialog; - GtkItemFactory *item_factory; -}; - - -gimp_color_button_get_type -GtkType -void - - -gimp_color_button_new -GtkWidget * -const gchar *title,gint width,gint height,const GimpRGB *color,GimpColorAreaType type - - -gimp_color_button_set_color -void -GimpColorButton *gcb,const GimpRGB *color - - -gimp_color_button_get_color -void -GimpColorButton *gcb,GimpRGB *color - - -gimp_color_button_has_alpha -gboolean -GimpColorButton *gcb - - -gimp_color_button_set_type -void -GimpColorButton *gcb,GimpColorAreaType alpha - - -gimp_dialog_new -GtkWidget * -const gchar *title,const gchar *wmclass_name,GimpHelpFunc help_func,const gchar *help_data,GtkWindowPosition position,gint allow_shrink,gint allow_grow,gint auto_shrink,... - - -gimp_dialog_newv -GtkWidget * -const gchar *title,const gchar *wmclass_name,GimpHelpFunc help_func,const gchar *help_data,GtkWindowPosition position,gint allow_shrink,gint allow_grow,gint auto_shrink,va_list args - - -gimp_dialog_set_icon -void -GtkWindow *dialog - - -gimp_dialog_create_action_area -void -GtkDialog *dialog,... - - -gimp_dialog_create_action_areav -void -GtkDialog *dialog,va_list args - - -GIMP_TYPE_FILE_SELECTION -#define GIMP_TYPE_FILE_SELECTION (gimp_file_selection_get_type ()) - - -GIMP_FILE_SELECTION -#define GIMP_FILE_SELECTION(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_FILE_SELECTION, GimpFileSelection)) - - -GIMP_FILE_SELECTION_CLASS -#define GIMP_FILE_SELECTION_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_FILE_SELECTION, GimpFileSelectionClass)) - - -GIMP_IS_FILE_SELECTION -#define GIMP_IS_FILE_SELECTION(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_FILE_SELECTION)) - - -GIMP_IS_FILE_SELECTION_CLASS -#define GIMP_IS_FILE_SELECTION_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_FILE_SELECTION)) - - -GimpFileSelectionClass - - -GimpFileSelection -struct GimpFileSelection -{ - GtkHBox hbox; - - GtkWidget *file_exists; - GtkWidget *entry; - GtkWidget *browse_button; - - GtkWidget *file_selection; - - GdkPixmap *yes_pixmap; - GdkBitmap *yes_mask; - GdkPixmap *no_pixmap; - GdkBitmap *no_mask; - - gchar *title; - gboolean dir_only; - gboolean check_valid; -}; - - -gimp_file_selection_get_type -GtkType -void - - -gimp_file_selection_new -GtkWidget * -const gchar *title,const gchar *filename,gboolean dir_only,gboolean check_valid - - -gimp_file_selection_get_filename -gchar * -GimpFileSelection *gfs - - -gimp_file_selection_set_filename -void -GimpFileSelection *gfs,const gchar *filename - - -gimp_help_init -void -void - - -gimp_help_free -void -void - - -gimp_help_enable_tooltips -void -void - - -gimp_help_disable_tooltips -void -void - - -gimp_standard_help_func -void -const gchar *help_data - - -gimp_help_connect_help_accel -void -GtkWidget *widget,GimpHelpFunc help_func,const gchar *help_data - - -gimp_help_set_help_data -void -GtkWidget *widget,const gchar *tooltip,const gchar *help_data - - -gimp_context_help -void -void - - -GIMP_TYPE_PATH_EDITOR -#define GIMP_TYPE_PATH_EDITOR (gimp_path_editor_get_type ()) - - -GIMP_PATH_EDITOR -#define GIMP_PATH_EDITOR(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_PATH_EDITOR, GimpPathEditor)) - - -GIMP_PATH_EDITOR_CLASS -#define GIMP_PATH_EDITOR_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_PATH_EDITOR, GimpPathEditorClass)) - - -GIMP_IS_PATH_EDITOR -#define GIMP_IS_PATH_EDITOR(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_PATH_EDITOR)) - - -GIMP_IS_PATH_EDITOR_CLASS -#define GIMP_IS_PATH_EDITOR_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_PATH_EDITOR)) - - -GimpPathEditorClass - - -GimpPathEditor -struct GimpPathEditor -{ - GtkVBox vbox; - - GtkWidget *upper_hbox; - - GtkWidget *new_button; - GtkWidget *up_button; - GtkWidget *down_button; - GtkWidget *delete_button; - - GtkWidget *file_selection; - - GtkWidget *dir_list; - - GtkWidget *selected_item; - gint number_of_items; -}; - - -gimp_path_editor_get_type -GtkType -void - - -gimp_path_editor_new -GtkWidget * -const gchar *filesel_title,const gchar *path - - -gimp_path_editor_get_path -gchar * -GimpPathEditor *gpe - - -GIMP_TYPE_PIXMAP -#define GIMP_TYPE_PIXMAP (gimp_pixmap_get_type ()) - - -GIMP_PIXMAP -#define GIMP_PIXMAP(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_PIXMAP, GimpPixmap)) - - -GIMP_PIXMAP_CLASS -#define GIMP_PIXMAP_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_PIXMAP, GimpPixmapClass)) - - -GIMP_IS_PIXMAP -#define GIMP_IS_PIXMAP(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_PIXMAP)) - - -GIMP_IS_PIXMAP_CLASS -#define GIMP_IS_PIXMAP_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_PIXMAP)) - - -GimpPixmapClass - - -GimpPixmap -struct GimpPixmap -{ - GtkPixmap pixmap; - - gchar **xpm_data; -}; - - -gimp_pixmap_get_type -GtkType -void - - -gimp_pixmap_new -GtkWidget * -gchar **xpm_data - - -gimp_pixmap_set -void -GimpPixmap *pixmap,gchar **xpm_data - - -GimpQueryStringCallback -void -GtkWidget *query_box, - gchar *string, - gpointer data - - -GimpQueryIntCallback -void -GtkWidget *query_box, - gint value, - gpointer data - - -GimpQueryDoubleCallback -void -GtkWidget *query_box, - gdouble value, - gpointer data - - -GimpQuerySizeCallback -void -GtkWidget *query_box, - gdouble size, - GimpUnit unit, - gpointer data - - -GimpQueryBooleanCallback -void -GtkWidget *query_box, - gboolean value, - gpointer data - - -gimp_query_string_box -GtkWidget * -const gchar *title,GimpHelpFunc help_func,const gchar *help_data,const gchar *message,const gchar *initial,GtkObject *object,const gchar *signal,GimpQueryStringCallback callback,gpointer data - - -gimp_query_int_box -GtkWidget * -const gchar *title,GimpHelpFunc help_func,const gchar *help_data,const gchar *message,gint initial,gint lower,gint upper,GtkObject *object,const gchar *signal,GimpQueryIntCallback callback,gpointer data - - -gimp_query_double_box -GtkWidget * -const gchar *title,GimpHelpFunc help_func,const gchar *help_data,const gchar *message,gdouble initial,gdouble lower,gdouble upper,gint digits,GtkObject *object,const gchar *signal,GimpQueryDoubleCallback callback,gpointer data - - -gimp_query_size_box -GtkWidget * -const gchar *title,GimpHelpFunc help_func,const gchar *help_data,const gchar *message,gdouble initial,gdouble lower,gdouble upper,gint digits,GimpUnit unit,gdouble resolution,gboolean dot_for_dot,GtkObject *object,const gchar *signal,GimpQuerySizeCallback callback,gpointer data - - -gimp_query_boolean_box -GtkWidget * -const gchar *title,GimpHelpFunc help_func,const gchar *help_data,gboolean eek,const gchar *message,const gchar *true_button,const gchar *false_button,GtkObject *object,const gchar *signal,GimpQueryBooleanCallback callback,gpointer data - - -GIMP_TYPE_SIZE_ENTRY -#define GIMP_TYPE_SIZE_ENTRY (gimp_size_entry_get_type ()) - - -GIMP_SIZE_ENTRY -#define GIMP_SIZE_ENTRY(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_SIZE_ENTRY, GimpSizeEntry)) - - -GIMP_SIZE_ENTRY_CLASS -#define GIMP_SIZE_ENTRY_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_SIZE_ENTRY, GimpSizeEntryClass)) - - -GIMP_IS_SIZE_ENTRY -#define GIMP_IS_SIZE_ENTRY(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_SIZE_ENTRY)) - - -GIMP_IS_SIZE_ENTRY_CLASS -#define GIMP_IS_SIZE_ENTRY_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_SIZE_ENTRY)) - - -GimpSizeEntryClass - - -GimpSizeEntryField - - -GimpSizeEntry -struct GimpSizeEntry -{ - GtkTable table; - - GSList *fields; - gint number_of_fields; - - GtkWidget *unitmenu; - GimpUnit unit; - gboolean menu_show_pixels; - gboolean menu_show_percent; - - gboolean show_refval; - GimpSizeEntryUpdatePolicy update_policy; -}; - - -gimp_size_entry_get_type -GtkType -void - - -gimp_size_entry_new -GtkWidget * -gint number_of_fields,GimpUnit unit,const gchar *unit_format,gboolean menu_show_pixels,gboolean menu_show_percent,gboolean show_refval,gint spinbutton_usize,GimpSizeEntryUpdatePolicy update_policy - - -gimp_size_entry_add_field -void -GimpSizeEntry *gse,GtkSpinButton *value_spinbutton,GtkSpinButton *refval_spinbutton - - -gimp_size_entry_attach_label -void -GimpSizeEntry *gse,const gchar *text,gint row,gint column,gfloat alignment - - -gimp_size_entry_set_resolution -void -GimpSizeEntry *gse,gint field,gdouble resolution,gboolean keep_size - - -gimp_size_entry_set_size -void -GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper - - -gimp_size_entry_set_value_boundaries -void -GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper - - -gimp_size_entry_get_value -gdouble -GimpSizeEntry *gse,gint field - - -gimp_size_entry_set_value -void -GimpSizeEntry *gse,gint field,gdouble value - - -gimp_size_entry_set_refval_boundaries -void -GimpSizeEntry *gse,gint field,gdouble lower,gdouble upper - - -gimp_size_entry_set_refval_digits -void -GimpSizeEntry *gse,gint field,gint digits - - -gimp_size_entry_get_refval -gdouble -GimpSizeEntry *gse,gint field - - -gimp_size_entry_set_refval -void -GimpSizeEntry *gse,gint field,gdouble refval - - -gimp_size_entry_get_unit -GimpUnit -GimpSizeEntry *gse - - -gimp_size_entry_set_unit -void -GimpSizeEntry *gse,GimpUnit unit - - -gimp_size_entry_grab_focus -void -GimpSizeEntry *gse - - -GIMP_TYPE_UNIT_MENU -#define GIMP_TYPE_UNIT_MENU (gimp_unit_menu_get_type ()) - - -GIMP_UNIT_MENU -#define GIMP_UNIT_MENU(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_UNIT_MENU, GimpUnitMenu)) - - -GIMP_UNIT_MENU_CLASS -#define GIMP_UNIT_MENU_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_UNIT_MENU, GimpUnitMenuClass)) - - -GIMP_IS_UNIT_MENU -#define GIMP_IS_UNIT_MENU(obj) (GTK_CHECK_TYPE (obj, GIMP_TYPE_UNIT_MENU)) - - -GIMP_IS_UNIT_MENU_CLASS -#define GIMP_IS_UNIT_MENU_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_UNIT_MENU)) - - -GimpUnitMenuClass - - -GimpUnitMenu -struct GimpUnitMenu -{ - GtkOptionMenu optionmenu; - - /* public (read only) */ - gchar *format; - GimpUnit unit; - - gboolean show_pixels; - gboolean show_percent; - - /* private */ - GtkWidget *selection; - GtkWidget *clist; -}; - - -gimp_unit_menu_get_type -GtkType -void - - -gimp_unit_menu_new -GtkWidget * -const gchar *format,GimpUnit unit,gboolean show_pixels,gboolean show_percent,gboolean show_custom - - -gimp_unit_menu_set_unit -void -GimpUnitMenu *gum,GimpUnit unit - - -gimp_unit_menu_get_unit -GimpUnit -GimpUnitMenu *gum - - -gimp_option_menu_new -GtkWidget * -gboolean menu_only,... - - -gimp_option_menu_new2 -GtkWidget * -gboolean menu_only,GtkSignalFunc menu_item_callback,gpointer data,gpointer initial,... - - -gimp_option_menu_set_history -void -GtkOptionMenu *option_menu,gpointer user_data - - -gimp_radio_group_new -GtkWidget * -gboolean in_frame,const gchar *frame_title,... - - -gimp_radio_group_new2 -GtkWidget * -gboolean in_frame,const gchar *frame_title,GtkSignalFunc radio_button_callback,gpointer data,gpointer initial,... - - -gimp_spin_button_new -GtkWidget * -GtkObject **adjustment,gfloat value,gfloat lower,gfloat upper,gfloat step_increment,gfloat page_increment,gfloat page_size,gfloat climb_rate,guint digits - - -GIMP_SCALE_ENTRY_LABEL -#define GIMP_SCALE_ENTRY_LABEL(adj) \ - GTK_LABEL (gtk_object_get_data (GTK_OBJECT(adj), "label")) - - -GIMP_SCALE_ENTRY_SCALE -#define GIMP_SCALE_ENTRY_SCALE(adj) \ - GTK_HSCALE (gtk_object_get_data (GTK_OBJECT(adj), "scale")) - - -GIMP_SCALE_ENTRY_SCALE_ADJ -#define GIMP_SCALE_ENTRY_SCALE_ADJ(adj) \ - gtk_range_get_adjustment \ - (GTK_RANGE (gtk_object_get_data (GTK_OBJECT (adj), "scale"))) - - -GIMP_SCALE_ENTRY_SPINBUTTON -#define GIMP_SCALE_ENTRY_SPINBUTTON(adj) \ - GTK_SPIN_BUTTON (gtk_object_get_data (GTK_OBJECT (adj), "spinbutton")) - - -GIMP_SCALE_ENTRY_SPINBUTTON_ADJ -#define GIMP_SCALE_ENTRY_SPINBUTTON_ADJ(adj) \ - gtk_spin_button_get_adjustment \ - (GTK_SPIN_BUTTON (gtk_object_get_data (GTK_OBJECT (adj), "spinbutton"))) - - -gimp_scale_entry_new -GtkObject * -GtkTable *table,gint column,gint row,const gchar *text,gint scale_usize,gint spinbutton_usize,gfloat value,gfloat lower,gfloat upper,gfloat step_increment,gfloat page_increment,guint digits,gboolean constrain,gfloat unconstrained_lower,gfloat unconstrained_upper,const gchar *tooltip,const gchar *help_data - - -GIMP_RANDOM_SEED_SPINBUTTON -#define GIMP_RANDOM_SEED_SPINBUTTON(hbox) \ - GTK_SPIN_BUTTON (gtk_object_get_data (GTK_OBJECT( hbox), "spinbutton")) - - -GIMP_RANDOM_SEED_SPINBUTTON_ADJ -#define GIMP_RANDOM_SEED_SPINBUTTON_ADJ(hbox) \ - gtk_spin_button_get_adjustment \ - (GTK_SPIN_BUTTON (gtk_object_get_data (GTK_OBJECT (hbox), "spinbutton"))) - - -GIMP_RANDOM_SEED_TOGGLEBUTTON -#define GIMP_RANDOM_SEED_TOGGLEBUTTON(hbox) \ - GTK_TOGGLE_BUTTON (gtk_object_get_data (GTK_OBJECT (hbox), \ - "togglebutton")) - - -gimp_random_seed_new -GtkWidget * -gint *seed,gint *use_time,gint time_true,gint time_false - - -GIMP_COORDINATES_CHAINBUTTON -#define GIMP_COORDINATES_CHAINBUTTON(sizeentry) \ - GIMP_CHAIN_BUTTON (gtk_object_get_data (GTK_OBJECT (sizeentry), \ - "chainbutton")) - - -gimp_coordinates_new -GtkWidget * -GimpUnit unit,const gchar *unit_format,gboolean menu_show_pixels,gboolean menu_show_percent,gint spinbutton_usize,GimpSizeEntryUpdatePolicy update_policy,gboolean chainbutton_active,gboolean chain_constrains_ratio,const gchar *xlabel,gdouble x,gdouble xres,gdouble lower_boundary_x,gdouble upper_boundary_x,gdouble xsize_0,gdouble xsize_100,const gchar *ylabel,gdouble y,gdouble yres,gdouble lower_boundary_y,gdouble upper_boundary_y,gdouble ysize_0,gdouble ysize_100 - - -GIMP_MEM_SIZE_ENTRY_SPINBUTTON -#define GIMP_MEM_SIZE_ENTRY_SPINBUTTON(memsize) \ - GTK_SPIN_BUTTON (gtk_object_get_data (GTK_OBJECT (memsize), \ - "spinbutton")) - - -GIMP_MEM_SIZE_ENTRY_SPINBUTTON_ADJ -#define GIMP_MEM_SIZE_ENTRY_SPINBUTTON_ADJ(memsize) \ - gtk_spin_button_get_adjustment \ - (GTK_SPIN_BUTTON (gtk_object_get_data (GTK_OBJECT (memsize), \ - "spinbutton"))) - - -GIMP_MEM_SIZE_ENTRY_OPTIONMENU -#define GIMP_MEM_SIZE_ENTRY_OPTIONMENU(memsize) \ - GTK_OPTION_MENU (gtk_object_get_data (GTK_OBJECT (memsize), \ - "optionmenu")) - - -gimp_mem_size_entry_new -GtkWidget * -GtkAdjustment *adjustment - - -gimp_pixmap_button_new -GtkWidget * -gchar **xpm_data,const gchar *text - - -gimp_toggle_button_sensitive_update -void -GtkToggleButton *toggle_button - - -gimp_toggle_button_update -void -GtkWidget *widget,gpointer data - - -gimp_radio_button_update -void -GtkWidget *widget,gpointer data - - -gimp_menu_item_update -void -GtkWidget *widget,gpointer data - - -gimp_int_adjustment_update -void -GtkAdjustment *adjustment,gpointer data - - -gimp_uint_adjustment_update -void -GtkAdjustment *adjustment,gpointer data - - -gimp_float_adjustment_update -void -GtkAdjustment *adjustment,gpointer data - - -gimp_double_adjustment_update -void -GtkAdjustment *adjustment,gpointer data - - -gimp_unit_menu_update -void -GtkWidget *widget,gpointer data - - -gimp_table_attach_aligned -void -GtkTable *table,gint column,gint row,const gchar *label_text,gfloat xalign,gfloat yalign,GtkWidget *widget,gint colspan,gboolean left_align - - -GimpSizeEntryUpdatePolicy -typedef enum -{ - GIMP_SIZE_ENTRY_UPDATE_NONE = 0, - GIMP_SIZE_ENTRY_UPDATE_SIZE = 1, - GIMP_SIZE_ENTRY_UPDATE_RESOLUTION = 2 -} GimpSizeEntryUpdatePolicy; - - -GimpButton - - -GimpChainButton - - -GimpColorArea - - -GimpColorButton - - -GimpFileSelection - - -GimpOffsetArea - - -GimpPathEditor - - -GimpPixmap - - -GimpSizeEntry - - -GimpUnitMenu - - -GimpHelpFunc -void -const gchar *help_data - - -GIMP_TYPE_BUTTON -#define GIMP_TYPE_BUTTON (gimp_button_get_type ()) - - -GIMP_BUTTON -#define GIMP_BUTTON(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_BUTTON, GimpButton)) - - -GIMP_BUTTON_CLASS -#define GIMP_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_BUTTON, GimpButtonClass)) - - -GIMP_IS_BUTTON -#define GIMP_IS_BUTTON(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_BUTTON)) - - -GIMP_IS_BUTTON_CLASS -#define GIMP_IS_BUTTON_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_BUTTON)) - - -GimpButtonClass - - -GimpButton -struct GimpButton -{ - GtkButton parent_instance; - - /*< private >*/ - guint press_state; -}; - - -gimp_button_get_type -GtkType -void - - -gimp_button_new -GtkWidget * -void - - -GIMP_TYPE_OFFSET_AREA -#define GIMP_TYPE_OFFSET_AREA (gimp_offset_area_get_type ()) - - -GIMP_OFFSET_AREA -#define GIMP_OFFSET_AREA(obj) (GTK_CHECK_CAST ((obj), GIMP_TYPE_OFFSET_AREA, GimpOffsetArea)) - - -GIMP_OFFSET_AREA_CLASS -#define GIMP_OFFSET_AREA_CLASS(klass) (GTK_CHECK_CLASS_CAST ((klass), GIMP_TYPE_OFFSET_AREA, GimpOffsetAreaClass)) - - -GIMP_IS_OFFSET_AREA -#define GIMP_IS_OFFSET_AREA(obj) (GTK_CHECK_TYPE ((obj), GIMP_TYPE_OFFSET_AREA)) - - -GIMP_IS_OFFSET_AREA_CLASS -#define GIMP_IS_OFFSET_AREA_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GIMP_TYPE_OFFSET_AREA)) - - -GimpOffsetAreaClass - - -GimpOffsetArea -struct GimpOffsetArea -{ - GtkDrawingArea parent_instance; - - gint orig_width; - gint orig_height; - gint width; - gint height; - gint offset_x; - gint offset_y; - gdouble display_ratio_x; - gdouble display_ratio_y; -}; - - -gimp_offset_area_get_type -GtkType -void - - -gimp_offset_area_new -GtkWidget * -gint orig_width,gint orig_height - - -gimp_offset_area_set_size -void -GimpOffsetArea *offset_area,gint width,gint height - - -gimp_offset_area_set_offsets -void -GimpOffsetArea *offset_area,gint offset_x,gint offset_y - diff --git a/devel-docs/libgimpwidgets/libgimpwidgets.args b/devel-docs/libgimpwidgets/libgimpwidgets.args deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/devel-docs/libgimpwidgets/libgimpwidgets.hierarchy b/devel-docs/libgimpwidgets/libgimpwidgets.hierarchy deleted file mode 100644 index e4c2d28bd3..0000000000 --- a/devel-docs/libgimpwidgets/libgimpwidgets.hierarchy +++ /dev/null @@ -1,35 +0,0 @@ -GtkObject - GtkWidget - GtkRange - GtkScrollbar - GtkVScrollbar - GtkHScrollbar - GtkScale - GtkHScale - GtkVScale - GtkContainer - GtkBin - GtkButton - GtkToggleButton - GtkCheckButton - GtkRadioButton - GimpColorButton - GtkOptionMenu - GimpUnitMenu - GtkScrolledWindow - GtkPaned - GtkVPaned - GtkHPaned - GtkTable - GimpChainButton - GimpSizeEntry - GtkBox - GtkHBox - GimpFileSelection - GtkVBox - GimpPathEditor - GtkMisc - GtkPixmap - GimpPixmap - GtkData - GtkAdjustment diff --git a/devel-docs/libgimpwidgets/libgimpwidgets.signals b/devel-docs/libgimpwidgets/libgimpwidgets.signals deleted file mode 100644 index 74f234910c..0000000000 --- a/devel-docs/libgimpwidgets/libgimpwidgets.signals +++ /dev/null @@ -1,48 +0,0 @@ - -GimpChainButton::toggled -void -GimpChainButton *gimpchainbutton - - - -GimpColorButton::color-changed -void -GimpColorButton *gimpcolorbutton - - - -GimpFileSelection::filename-changed -void -GimpFileSelection *gimpfileselection - - - -GimpPathEditor::path-changed -void -GimpPathEditor *gimppatheditor - - - -GimpSizeEntry::value-changed -void -GimpSizeEntry *gimpsizeentry - - - -GimpSizeEntry::refval-changed -void -GimpSizeEntry *gimpsizeentry - - - -GimpSizeEntry::unit-changed -void -GimpSizeEntry *gimpsizeentry - - - -GimpUnitMenu::unit-changed -void -GimpUnitMenu *gimpunitmenu - - diff --git a/devel-docs/libgimpwidgets/libgimpwidgets.types b/devel-docs/libgimpwidgets/libgimpwidgets.types index 357fa934e6..c82d9f4092 100644 --- a/devel-docs/libgimpwidgets/libgimpwidgets.types +++ b/devel-docs/libgimpwidgets/libgimpwidgets.types @@ -1,5 +1,6 @@ #include #include +#include #include "libgimpwidgets-include.c" diff --git a/devel-docs/libgimpwidgets/tmpl/gimpchainbutton.sgml b/devel-docs/libgimpwidgets/tmpl/gimpchainbutton.sgml index 2571a60b67..55b90b168b 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpchainbutton.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpchainbutton.sgml @@ -51,6 +51,8 @@ up two GimpSizeEntries (see #GimpSizeEntry) linked with a #GimpChainButton. @gcb: +@active: + @is_active: diff --git a/devel-docs/libgimpwidgets/tmpl/gimpcolorbutton.sgml b/devel-docs/libgimpwidgets/tmpl/gimpcolorbutton.sgml index 2e9d87eccc..7506f98be6 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpcolorbutton.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpcolorbutton.sgml @@ -69,6 +69,8 @@ color, the "color_changed" signal is emitted. @gcb: +@type: + @alpha: diff --git a/devel-docs/libgimpwidgets/tmpl/gimpdialog.sgml b/devel-docs/libgimpwidgets/tmpl/gimpdialog.sgml index d643c2bfc1..85e71123eb 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpdialog.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpdialog.sgml @@ -49,14 +49,6 @@ dialog-related stuff. @Returns: - - - - - -@dialog: - - diff --git a/devel-docs/libgimpwidgets/tmpl/gimphelpui.sgml b/devel-docs/libgimpwidgets/tmpl/gimphelpui.sgml index d14b792edc..58a5097880 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimphelpui.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimphelpui.sgml @@ -63,16 +63,6 @@ See #GimpHelpFunc for the naming conventions of HTML help files. @help_data: A string containing the path to a HTML page. - - - - - -@widget: -@help_func: -@help_data: - - diff --git a/devel-docs/libgimpwidgets/tmpl/gimpquerybox.sgml b/devel-docs/libgimpwidgets/tmpl/gimpquerybox.sgml index ceb0f4a2e2..03ac06cf6a 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpquerybox.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpquerybox.sgml @@ -166,7 +166,7 @@ Note that you have to g_free() the returned string. @title: @help_func: @help_data: -@eek: +@stock_id: @message: @true_button: @false_button: @@ -175,5 +175,7 @@ Note that you have to g_free() the returned string. @callback: @data: @Returns: + +@eek: diff --git a/devel-docs/libgimpwidgets/tmpl/gimpsizeentry.sgml b/devel-docs/libgimpwidgets/tmpl/gimpsizeentry.sgml index ffa247e2cc..74a46d7550 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpsizeentry.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpsizeentry.sgml @@ -59,9 +59,11 @@ gimp_coordinates_new() @menu_show_pixels: @menu_show_percent: @show_refval: -@spinbutton_usize: +@spinbutton_width: @update_policy: @Returns: + +@spinbutton_usize: @@ -206,13 +208,6 @@ gimp_coordinates_new() @gse: - - - - - -@gimpsizeentry: the object which received the signal. - @@ -227,3 +222,10 @@ gimp_coordinates_new() @gimpsizeentry: the object which received the signal. + + + + + +@gimpsizeentry: the object which received the signal. + diff --git a/devel-docs/libgimpwidgets/tmpl/gimpwidgets.sgml b/devel-docs/libgimpwidgets/tmpl/gimpwidgets.sgml index e5d34ed632..a0107041ad 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpwidgets.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpwidgets.sgml @@ -96,10 +96,12 @@ gtk_object_set_user_data(). @menu_only: @menu_item_callback: -@data: +@menu_item_callback_data: @initial: @Varargs: @Returns: + +@data: @@ -108,6 +110,8 @@ gtk_object_set_user_data(). @option_menu: +@item_data: + @user_data: @@ -194,10 +198,12 @@ gtk_object_set_user_data(). @in_frame: @frame_title: @radio_button_callback: -@data: +@radio_button_callback_data: @initial: @Varargs: @Returns: + +@data: @@ -266,8 +272,8 @@ Returns the #GtkAdjustment of the scale_entry's #GtkSpinButton. @column: @row: @text: -@scale_usize: -@spinbutton_usize: +@scale_width: +@spinbutton_width: @value: @lower: @upper: @@ -280,6 +286,9 @@ Returns the #GtkAdjustment of the scale_entry's #GtkSpinButton. @tooltip: @help_data: @Returns: + +@scale_usize: +@spinbutton_usize: @@ -335,7 +344,7 @@ Returns the #GimpChainButton which is attached to the #GimpSizeEntry. @unit_format: @menu_show_pixels: @menu_show_percent: -@spinbutton_usize: +@spinbutton_width: @update_policy: @chainbutton_active: @chain_constrains_ratio: @@ -354,6 +363,8 @@ Returns the #GimpChainButton which is attached to the #GimpSizeEntry. @ysize_0: @ysize_100: @Returns: + +@spinbutton_usize: diff --git a/devel-docs/libgimpwidgets/tmpl/gimpwidgetstypes.sgml b/devel-docs/libgimpwidgets/tmpl/gimpwidgetstypes.sgml index a53855ef45..82f7b48ca9 100644 --- a/devel-docs/libgimpwidgets/tmpl/gimpwidgetstypes.sgml +++ b/devel-docs/libgimpwidgets/tmpl/gimpwidgetstypes.sgml @@ -28,7 +28,6 @@ gimpwidgetstypes -@parent_instance: @@ -41,6 +40,7 @@ gimpwidgetstypes +@parent_instance: diff --git a/po/ChangeLog b/po/ChangeLog index 57a7482031..d8b8af307a 100644 --- a/po/ChangeLog +++ b/po/ChangeLog @@ -1,3 +1,7 @@ +2002-03-08 Sven Neumann + + * POTFILES.in: Mitch missed one new file. + 2002-03-08 Michael Natterer * POTFILES.in: updated. diff --git a/po/POTFILES.in b/po/POTFILES.in index 7cbc1a2aaf..9bc4ed661d 100644 --- a/po/POTFILES.in +++ b/po/POTFILES.in @@ -164,6 +164,7 @@ app/widgets/gimpbufferview.c app/widgets/gimpchannellistview.c app/widgets/gimpcomponentlistitem.c app/widgets/gimpcontainergridview.c +app/widgets/gimpdataeditor.c app/widgets/gimpdatafactoryview.c app/widgets/gimpdocumentview.c app/widgets/gimpdrawablelistview.c diff --git a/tips/ChangeLog b/tips/ChangeLog index e2839f410b..4de3648caa 100644 --- a/tips/ChangeLog +++ b/tips/ChangeLog @@ -2,6 +2,7 @@ * Makefile.am: fixes for srcdir != builddir. + * gimp_tips.txt * gimp_tips.pt.txt: removed. * pt.po: fixed markup. diff --git a/tips/Makefile.am b/tips/Makefile.am index 4213abb424..a15dac8cfe 100644 --- a/tips/Makefile.am +++ b/tips/Makefile.am @@ -14,7 +14,6 @@ $(GETTEXT_PACKAGE)-tips.pot: $(srcdir)/gimp-tips.xml.in $(INTLTOOL_UPDATE) --gettext-package $(GETTEXT_PACKAGE)-tips --pot oldtips = \ - gimp_tips.txt \ gimp_tips.cs.txt \ gimp_tips.es.txt \ gimp_tips.fr.txt \ diff --git a/tips/gimp_tips.txt b/tips/gimp_tips.txt deleted file mode 100644 index 02c3932fbd..0000000000 --- a/tips/gimp_tips.txt +++ /dev/null @@ -1,181 +0,0 @@ -# This is a list of tips for the GIMP. Every time the GIMP is -# started, one tip will be selected from this file and will be -# displayed in the "Tip of the day" dialog. -# -# - Lines starting with '#' are comments. -# - Blank lines or comments separate two tips (they are not ignored). -# Multiple blank lines are treated as one. If you want to have a -# blank line in a tip, put a space or tab in it. -# - Text will appear in the dialog as it is in this file. This is -# done on purpose in order to have more freedom in the layout of the -# tips than with automatic word-wrapping, but this also means that -# you have to avoid excessively long lines in this file. -# - Tips should be concise: 3 lines or less. -# - Advice for translators to other languages: keep the original tips -# as comments before the translated tips. It will be easier for -# other people to check for changes or additions. -# -# Tips in this file have been contributed by Zachary Beane, Mo Oishi, -# Raphael Quinet, Sven Neumann, Carey Bunks and other people on the -# gimp mailing lists and newsgroup (comp.graphics.apps.gimp). -# -------------------------------------------------------------------- - -# The first tip should be a welcome message, because this is the -# first thing that a new user will see. -# - Welcome to the GIMP ! - -Nearly all image operations are performed by right-clicking -on the image. And don't worry, you can undo most mistakes... - -# Tips for beginners start here -# (for people who are not familiar yet with layers and image formats) -# - -You can get context-sensitive help for most of the GIMP's features by -pressing the F1 key at any time. This also works inside the menus. - -The GIMP uses layers to let you organize your image. Think of them -as a stack of slides or filters, such that looking through them you -see a composite of their contents. - -You can perform many layer operations by right-clicking on the text -label of a layer in the "Layers, Channels and Paths" dialog - -When you save an image to work on it again later, try using XCF, -the GIMP's native file format (use the file extension ".xcf"). -This preserves the layers and every aspect of your work-in-progress. -Once a project is completed, you can save it as JPEG, PNG, GIF, ... - -The layer named "Background" it special because it lacks transparency. -This prevents you from adding a layer mask or moving the layer up in -the stack. You may add transparency to it by right-clicking in the -"Layers, Channels and Paths" dialog and selecting "Add Alpha Channel". - -Most plug-ins work on the current layer of the current image. In -some cases, you will have to merge all layers (Layers->Flatten Image) -if you want the plug-in to work on the whole image. - -Not all effects can be applied to all kinds of images. This is -indicated by a grayed-out menu-entry. You may need to change -the image mode to RGB (Image->Mode->RGB), add an alpha-channel -(Layers->Add Alpha Channel) or flatten it (Layers->Flatten Image). - -# Tips for intermediate users start here -# - -You can drag and drop many things in the GIMP. For example, dragging -a color from the toolbox or from a color palette and dropping it into -an image will fill the current image or selection with that color. - -When using a drawing tool (Paintbrush, Airbrush, or Pencil), -Shift-click will draw a straight line from your last drawing -point to your current cursor position. If you also press Ctrl, -the line will be constrained to 15 degree angles. - -The file selection dialog box has command-line completion with -Tab, just like the shell. Type part of a filename, hit tab, and voila! -It's completed. - -You can reassign shortcut keys on any menu by bringing up the menu, -selecting a menu item, and pressing the new shortcut key combination. -This is dynamic and is saved when you exit GIMP. - -You can use the middle mouse button to pan around -the image, if it's larger than its display window. - -Click and drag on a ruler to place a Guide on an image. All -dragged selections will snap to the guides. You can remove -guides by dragging them off the image with the Move tool. - -You can drag a layer from the "Layers, Channels and Paths" dialog -and drop it onto the toolbox. This will create a new image -containing only that layer. - -A Floating Selection must be anchored to a new layer or to the last -active layer before doing other operations on the image. Click on the -New Layer or Anchor Layer buttons in the "Layers, Channels and Paths" -dialog, or use the menus to do the same. - -The GIMP supports gzip compression on the fly. Just add -".gz" (or ".bz2", if you have bzip2 installed) to the filename -and your image will be saved compressed. Of course loading -compressed images works too. - -Pressing and holding the Shift key before making a selection allows -you to add to the current selection instead of replacing it. Using -Ctrl before making a selection subtracts from the current one. - -You can press or release the Shift and Ctrl keys while you are -making a selection in order to constrain it to a perfect square -or circle, or to have it centered on its starting point. - -Using Edit->Stroke allows you to draw simple squares or circles by -painting the edge of your current selection with the active brush. -More complex shapes can be drawn with Filters->Render->Gfig. - -If you stroke a path (Edit->Stroke), the current drawing tool and its -settings are used. You can use the Paintbrush in gradient mode, the -Clone tool with a pattern or even the Eraser or the Smudge tool. - -You can create and edit complex selections using the Bezier tool. -The "Paths" tab in the "Layers, Channels and Paths" dialog allows -you to work on multiple paths and to convert them to selections. - -You can use the paint tools to change the selection. Click on the -Quick Mask button at the bottom left of an image window. Change your -selection by painting in the image and click on the button again to -convert it back to a normal selection. - -You can save a selection to a channel (Select->Save to Channel) and -then modify this channel with any paint tools. Using the buttons in -the "Channels" tab of the "Layers, Channels and Paths" dialog, you can -toggle the visibility of this new channel or convert it to a selection. - -# Tips for advanced users start here -# (this is mostly for learning shortcut keys) -# - -If your screen is too cluttered, you can press Tab multiple times -in an image window to hide or show the toolbox and other dialogs. - -You can adjust the selection range for fuzzy select -by clicking and dragging left and right. - -Shift-click on the eye icon in the Layers dialog to hide all -layers but that one. Shift-click again to show all layers. - -Ctrl-click on the layer mask's preview in the Layers dialog -toggles the effect of the layer mask. - -Alt-click on the layer mask's preview in the Layers dialog -toggles viewing the mask directly. - -You can use Alt-Tab to cycle through all layers in an image -(if your window manager doesn't trap those keys...). - -Shift-click with the Bucket Fill tool to have it use -the background color instead of the foreground color. - -Control-drag with the Transform tool in rotation mode -will constrain the rotation to 15 degree angles. - -You can adjust and re-place a selection by using Alt-drag. - -If your fonts turn out blocky, that's because they're not scalable -fonts. Most X servers support scalable Type 1 Postscript fonts. -Download and install them. Some font servers allow you to use -TrueType (.ttf) fonts, which are also scalable. - -To create a perfect circle, hold Shift while doing an ellipse select. To -place a circle precisely, drag horizontal and vertical guides tangent to -the circle you want to select, place your cursor at the intersection -of the guides, and the resulting selection will just touch the guides. - -If some of your scanned photos do not look colorful enough, you can -easily improve their tonal range with the "Auto" button in the Levels -tool (Image->Colors->Levels). If there are any color casts, you can -correct them with the Curves tool (Image->Colors->Curves). - -# (end of tips) -