Handle gtk-doc just like GTK+ does it now:

2002-03-08  Sven Neumann  <sven@gimp.org>

	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.
This commit is contained in:
Sven Neumann 2002-03-08 12:36:40 +00:00 committed by Sven Neumann
parent 2d1b904752
commit 906a8784ba
67 changed files with 936 additions and 6066 deletions

View File

@ -1,3 +1,17 @@
2002-03-08 Sven Neumann <sven@gimp.org>
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 <mitch@gimp.org>
* app/core/core-types.h: added GimpPaletteEntry typedef.

View File

@ -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"

2
NEWS
View File

@ -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)

View File

@ -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."

View File

@ -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
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=":"

View File

@ -1,3 +1,66 @@
2002-03-08 Sven Neumann <sven@gimp.org>
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 <mitch@gimp.org>
* Makefile.am

View File

@ -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

View File

@ -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 = \
$(content_files) \
$(extra_files) \
$(HTML_IMAGES) \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE).hierarchy \
$(DOC_MODULE).signals \
$(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
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

File diff suppressed because it is too large Load Diff

View File

@ -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

View File

@ -1,5 +0,0 @@
#include <gtk/gtk.h>
#include <libgimp/gimp.h>
#include <libgimp/gimpui.h>
#include "libgimp-include.c"

View File

@ -286,22 +286,6 @@ all other GIMP Library headers.
@Returns:
<!-- ##### FUNCTION gimp_use_xshm ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gimp_color_cube ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gimp_min_colors ##### -->
<para>

View File

@ -133,9 +133,11 @@ instances have finished. The callback could be used to unload
dynamiclly loaded code, for example.
</para>
@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.
<!-- # Unused Parameters # -->
@id: The @id as returned by gimp_color_selector_register().

View File

@ -19,7 +19,7 @@ gimpdrawable
</para>
@id:
@drawable_id:
@width:
@height:
@bpp:

View File

@ -25,6 +25,8 @@ Enums and definitions.
@GIMP_ALPHA_MASK:
@GIMP_SELECTION_MASK:
@GIMP_INV_SELECTION_MASK:
@GIMP_COPY_MASK:
@GIMP_INV_COPY_MASK:
<!-- ##### ENUM GimpBlendMode ##### -->
<para>
@ -135,15 +137,6 @@ Enums and definitions.
@GIMP_SHARPEN_CONVOLVE:
@GIMP_CUSTOM_CONVOLVE:
<!-- ##### ENUM GimpDodgeBurnMode ##### -->
<para>
</para>
@GIMP_DODGEBURN_HIGHLIGHTS:
@GIMP_DODGEBURN_MIDTONES:
@GIMP_DODGEBURN_SHADOWS:
<!-- ##### ENUM GimpDodgeBurnType ##### -->
<para>
@ -233,15 +226,6 @@ Enums and definitions.
@GIMP_BLUE_HUES:
@GIMP_MAGENTA_HUES:
<!-- ##### ENUM GimpInterpolationType ##### -->
<para>
</para>
@GIMP_LINEAR_INTERPOLATION:
@GIMP_CUBIC_INTERPOLATION:
@GIMP_NEAREST_NEIGHBOR_INTERPOLATION:
<!-- ##### ENUM GimpLayerModeEffects ##### -->
<para>
@ -266,6 +250,7 @@ Enums and definitions.
@GIMP_DODGE_MODE:
@GIMP_BURN_MODE:
@GIMP_HARDLIGHT_MODE:
@GIMP_COLOR_ERASE_MODE:
<!-- ##### ENUM GimpMaskApplyMode ##### -->
<para>
@ -285,15 +270,6 @@ Enums and definitions.
@GIMP_CLIP_TO_BOTTOM_LAYER:
@GIMP_FLATTEN_IMAGE:
<!-- ##### ENUM GimpMessageHandlerType ##### -->
<para>
</para>
@GIMP_MESSAGE_BOX:
@GIMP_CONSOLE:
@GIMP_ERROR_CONSOLE:
<!-- ##### ENUM GimpOrientationType ##### -->
<para>
@ -320,15 +296,17 @@ Enums and definitions.
@GIMP_REPEAT_SAWTOOTH:
@GIMP_REPEAT_TRIANGULAR:
<!-- ##### ENUM GimpRunModeType ##### -->
<!-- ##### MACRO GimpRunModeType ##### -->
<para>
</para>
<!-- # Unused Parameters # -->
@GIMP_RUN_INTERACTIVE:
@GIMP_RUN_NONINTERACTIVE:
@GIMP_RUN_WITH_LAST_VALS:
<!-- ##### ENUM GimpSizeType ##### -->
<para>
@ -337,15 +315,6 @@ Enums and definitions.
@GIMP_PIXELS:
@GIMP_POINTS:
<!-- ##### ENUM GimpStackTraceMode ##### -->
<para>
</para>
@GIMP_STACK_TRACE_NEVER:
@GIMP_STACK_TRACE_QUERY:
@GIMP_STACK_TRACE_ALWAYS:
<!-- ##### ENUM GimpTransferMode ##### -->
<para>

View File

@ -65,8 +65,8 @@ gimpgradients
</para>
@name:
@width:
@sample_size:
@width:
@grad_data:
@Returns:

View File

@ -30,8 +30,10 @@ Widgets and functions for selecting images, layers, brushes, patterns etc.
</para>
@id:
@any_id:
@data:
<!-- # Unused Parameters # -->
@id:
<!-- ##### USER_FUNCTION GimpRunBrushCallback ##### -->

View File

@ -133,10 +133,10 @@ gimptools
@sample_merged:
@sample_average:
@average_radius:
@save_color:
@color:
@Returns:
<!-- # Unused Parameters # -->
@save_color:
@red:
@green:
@blue:
@ -166,19 +166,6 @@ gimptools
@Returns:
<!-- ##### FUNCTION gimp_crop ##### -->
<para>
</para>
@image_ID:
@new_width:
@new_height:
@offx:
@offy:
@Returns:
<!-- ##### FUNCTION gimp_dodgeburn ##### -->
<para>

View File

@ -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

View File

@ -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 = \
$(content_files) \
$(extra_files) \
$(HTML_IMAGES) \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE).hierarchy \
$(DOC_MODULE).signals \
$(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
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

View File

@ -1,773 +0,0 @@
<STRUCT>
<NAME>GimpParasite</NAME>
</STRUCT>
<ENUM>
<NAME>GimpUnit</NAME>
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;
</ENUM>
<ENUM>
<NAME>GimpPDBArgType</NAME>
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;
</ENUM>
<ENUM>
<NAME>GimpPDBProcType</NAME>
typedef enum /*< chop=GIMP_ >*/
{
GIMP_INTERNAL,
GIMP_PLUGIN,
GIMP_EXTENSION,
GIMP_TEMPORARY
} GimpPDBProcType;
</ENUM>
<ENUM>
<NAME>GimpPDBStatusType</NAME>
typedef enum /*< chop=GIMP_ >*/
{
GIMP_PDB_EXECUTION_ERROR,
GIMP_PDB_CALLING_ERROR,
GIMP_PDB_PASS_THROUGH,
GIMP_PDB_SUCCESS,
GIMP_PDB_CANCEL
} GimpPDBStatusType;
</ENUM>
<FUNCTION>
<NAME>gimp_directory</NAME>
<RETURNS>const gchar *</RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gimp_personal_rc_file</NAME>
<RETURNS>gchar *</RETURNS>
const gchar *basename
</FUNCTION>
<FUNCTION>
<NAME>gimp_data_directory</NAME>
<RETURNS>const gchar *</RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gimp_sysconf_directory</NAME>
<RETURNS>const gchar *</RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gimp_gtkrc</NAME>
<RETURNS>const gchar *</RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gimp_path_parse</NAME>
<RETURNS>GList *</RETURNS>
const gchar *path,gint max_paths,gboolean check,GList **check_failed
</FUNCTION>
<FUNCTION>
<NAME>gimp_path_to_str</NAME>
<RETURNS>gchar *</RETURNS>
GList *path
</FUNCTION>
<FUNCTION>
<NAME>gimp_path_free</NAME>
<RETURNS>void </RETURNS>
GList *path
</FUNCTION>
<FUNCTION>
<NAME>gimp_path_get_user_writable_dir</NAME>
<RETURNS>gchar *</RETURNS>
GList *path
</FUNCTION>
<MACRO>
<NAME>GIMP_MIN_IMAGE_SIZE</NAME>
#define GIMP_MIN_IMAGE_SIZE 1
</MACRO>
<MACRO>
<NAME>GIMP_MAX_IMAGE_SIZE</NAME>
#define GIMP_MAX_IMAGE_SIZE 16777216 /* 2^24 */
</MACRO>
<MACRO>
<NAME>GIMP_MIN_RESOLUTION</NAME>
#define GIMP_MIN_RESOLUTION 5e-3 /* shouldn't display as 0.000 */
</MACRO>
<MACRO>
<NAME>GIMP_MAX_RESOLUTION</NAME>
#define GIMP_MAX_RESOLUTION 65536.0
</MACRO>
<MACRO>
<NAME>GIMP_CHECK_SIZE</NAME>
#define GIMP_CHECK_SIZE 8
</MACRO>
<MACRO>
<NAME>GIMP_CHECK_SIZE_SM</NAME>
#define GIMP_CHECK_SIZE_SM 4
</MACRO>
<MACRO>
<NAME>GIMP_CHECK_DARK</NAME>
#define GIMP_CHECK_DARK 0.4 /* corresponds to GRAY_CHECKS as */
</MACRO>
<MACRO>
<NAME>GIMP_CHECK_LIGHT</NAME>
#define GIMP_CHECK_LIGHT 0.6 /* defined in app/image_render.c */
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_PERSISTENT</NAME>
#define GIMP_PARASITE_PERSISTENT 1
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_UNDOABLE</NAME>
#define GIMP_PARASITE_UNDOABLE 2
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_ATTACH_PARENT</NAME>
#define GIMP_PARASITE_ATTACH_PARENT (0x80 << 8)
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_PARENT_PERSISTENT</NAME>
#define GIMP_PARASITE_PARENT_PERSISTENT (GIMP_PARASITE_PERSISTENT << 8)
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_PARENT_UNDOABLE</NAME>
#define GIMP_PARASITE_PARENT_UNDOABLE (GIMP_PARASITE_UNDOABLE << 8)
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_ATTACH_GRANDPARENT</NAME>
#define GIMP_PARASITE_ATTACH_GRANDPARENT (0x80 << 16)
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_GRANDPARENT_PERSISTENT</NAME>
#define GIMP_PARASITE_GRANDPARENT_PERSISTENT (GIMP_PARASITE_PERSISTENT << 16)
</MACRO>
<MACRO>
<NAME>GIMP_PARASITE_GRANDPARENT_UNDOABLE</NAME>
#define GIMP_PARASITE_GRANDPARENT_UNDOABLE (GIMP_PARASITE_UNDOABLE << 16)
</MACRO>
<STRUCT>
<NAME>GimpParasite</NAME>
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 */
};
</STRUCT>
<FUNCTION>
<NAME>gimp_parasite_new</NAME>
<RETURNS>GimpParasite *</RETURNS>
const gchar *name,guint32 flags,guint32 size,const gpointer data
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_free</NAME>
<RETURNS>void </RETURNS>
GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_copy</NAME>
<RETURNS>GimpParasite *</RETURNS>
const GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_compare</NAME>
<RETURNS>gboolean </RETURNS>
const GimpParasite *a,const GimpParasite *b
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_is_type</NAME>
<RETURNS>gboolean </RETURNS>
const GimpParasite *parasite,const gchar *name
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_is_persistent</NAME>
<RETURNS>gboolean </RETURNS>
const GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_is_undoable</NAME>
<RETURNS>gboolean </RETURNS>
const GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_has_flag</NAME>
<RETURNS>gboolean </RETURNS>
const GimpParasite *parasite,gulong flag
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_flags</NAME>
<RETURNS>gulong </RETURNS>
const GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_name</NAME>
<RETURNS>const gchar *</RETURNS>
const GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_data</NAME>
<RETURNS>gpointer </RETURNS>
const GimpParasite *parasite
</FUNCTION>
<FUNCTION>
<NAME>gimp_parasite_data_size</NAME>
<RETURNS>glong </RETURNS>
const GimpParasite *parasite
</FUNCTION>
<MACRO>
<NAME>GIMP_PIXPIPE_MAXDIM</NAME>
#define GIMP_PIXPIPE_MAXDIM 4
</MACRO>
<FUNCTION>
<NAME>gimp_pixpipe_params_init</NAME>
<RETURNS>void </RETURNS>
GimpPixPipeParams *params
</FUNCTION>
<FUNCTION>
<NAME>gimp_pixpipe_params_parse</NAME>
<RETURNS>void </RETURNS>
gchar *parameters,GimpPixPipeParams *params
</FUNCTION>
<FUNCTION>
<NAME>gimp_pixpipe_params_build</NAME>
<RETURNS>gchar *</RETURNS>
GimpPixPipeParams *params
</FUNCTION>
<MACRO>
<NAME>GP_VERSION</NAME>
#define GP_VERSION 0x0008
</MACRO>
<STRUCT>
<NAME>GPConfig</NAME>
</STRUCT>
<STRUCT>
<NAME>GPTileReq</NAME>
</STRUCT>
<STRUCT>
<NAME>GPTileAck</NAME>
</STRUCT>
<STRUCT>
<NAME>GPTileData</NAME>
</STRUCT>
<STRUCT>
<NAME>GPParam</NAME>
</STRUCT>
<STRUCT>
<NAME>GPParamDef</NAME>
</STRUCT>
<STRUCT>
<NAME>GPProcRun</NAME>
</STRUCT>
<STRUCT>
<NAME>GPProcReturn</NAME>
</STRUCT>
<STRUCT>
<NAME>GPProcInstall</NAME>
</STRUCT>
<STRUCT>
<NAME>GPProcUninstall</NAME>
</STRUCT>
<STRUCT>
<NAME>GPConfig</NAME>
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;
};
</STRUCT>
<STRUCT>
<NAME>GPTileReq</NAME>
struct GPTileReq
{
gint32 drawable_ID;
guint32 tile_num;
guint32 shadow;
};
</STRUCT>
<STRUCT>
<NAME>GPTileData</NAME>
struct GPTileData
{
gint32 drawable_ID;
guint32 tile_num;
guint32 shadow;
guint32 bpp;
guint32 width;
guint32 height;
guint32 use_shm;
guchar *data;
};
</STRUCT>
<STRUCT>
<NAME>GPParam</NAME>
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;
};
</STRUCT>
<STRUCT>
<NAME>GPParamDef</NAME>
struct GPParamDef
{
guint32 type;
gchar *name;
gchar *description;
};
</STRUCT>
<STRUCT>
<NAME>GPProcRun</NAME>
struct GPProcRun
{
gchar *name;
guint32 nparams;
GPParam *params;
};
</STRUCT>
<STRUCT>
<NAME>GPProcReturn</NAME>
struct GPProcReturn
{
gchar *name;
guint32 nparams;
GPParam *params;
};
</STRUCT>
<STRUCT>
<NAME>GPProcInstall</NAME>
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;
};
</STRUCT>
<STRUCT>
<NAME>GPProcUninstall</NAME>
struct GPProcUninstall
{
gchar *name;
};
</STRUCT>
<FUNCTION>
<NAME>gp_init</NAME>
<RETURNS>void </RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gp_quit_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel
</FUNCTION>
<FUNCTION>
<NAME>gp_config_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPConfig *config
</FUNCTION>
<FUNCTION>
<NAME>gp_tile_req_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPTileReq *tile_req
</FUNCTION>
<FUNCTION>
<NAME>gp_tile_ack_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel
</FUNCTION>
<FUNCTION>
<NAME>gp_tile_data_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPTileData *tile_data
</FUNCTION>
<FUNCTION>
<NAME>gp_proc_run_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPProcRun *proc_run
</FUNCTION>
<FUNCTION>
<NAME>gp_proc_return_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPProcReturn *proc_return
</FUNCTION>
<FUNCTION>
<NAME>gp_temp_proc_run_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPProcRun *proc_run
</FUNCTION>
<FUNCTION>
<NAME>gp_temp_proc_return_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPProcReturn *proc_return
</FUNCTION>
<FUNCTION>
<NAME>gp_proc_install_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPProcInstall *proc_install
</FUNCTION>
<FUNCTION>
<NAME>gp_proc_uninstall_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,GPProcUninstall *proc_uninstall
</FUNCTION>
<FUNCTION>
<NAME>gp_extension_ack_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel
</FUNCTION>
<MACRO>
<NAME>SA_RESTART</NAME>
#define SA_RESTART SA_SYSV
</MACRO>
<USER_FUNCTION>
<NAME>GimpSignalHandlerFunc</NAME>
<RETURNS>void </RETURNS>
gint signum
</USER_FUNCTION>
<FUNCTION>
<NAME>gimp_signal_private</NAME>
<RETURNS>GimpSignalHandlerFunc </RETURNS>
gint signum,GimpSignalHandlerFunc handler,gint flags
</FUNCTION>
<MACRO>
<NAME>gimp_signal_syscallrestart</NAME>
#define gimp_signal_syscallrestart(signum,handler) gimp_signal_private ((signum), (handler), SA_RESTART)
</MACRO>
<FUNCTION>
<NAME>gimp_unit_get_number_of_units</NAME>
<RETURNS>gint </RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_number_of_built_in_units</NAME>
<RETURNS>gint </RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_new</NAME>
<RETURNS>GimpUnit </RETURNS>
gchar *identifier,gdouble factor,gint digits,gchar *symbol,gchar *abbreviation,gchar *singular,gchar *plural
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_deletion_flag</NAME>
<RETURNS>gboolean </RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_set_deletion_flag</NAME>
<RETURNS>void </RETURNS>
GimpUnit unit,gboolean deletion_flag
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_factor</NAME>
<RETURNS>gdouble </RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_digits</NAME>
<RETURNS>gint </RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_identifier</NAME>
<RETURNS>gchar *</RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_symbol</NAME>
<RETURNS>gchar *</RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_abbreviation</NAME>
<RETURNS>gchar *</RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_singular</NAME>
<RETURNS>gchar *</RETURNS>
GimpUnit unit
</FUNCTION>
<FUNCTION>
<NAME>gimp_unit_get_plural</NAME>
<RETURNS>gchar *</RETURNS>
GimpUnit unit
</FUNCTION>
<MACRO>
<NAME>gimp_strescape</NAME>
#define gimp_strescape(string, exceptions) g_strescape (string, exceptions)
</MACRO>
<MACRO>
<NAME>gimp_strcompress</NAME>
#define gimp_strcompress(string) g_strcompress (string)
</MACRO>
<FUNCTION>
<NAME>gimp_strescape</NAME>
<RETURNS>gchar *</RETURNS>
const gchar *source,const gchar *exceptions
</FUNCTION>
<FUNCTION>
<NAME>gimp_strcompress</NAME>
<RETURNS>gchar *</RETURNS>
const gchar *source
</FUNCTION>
<STRUCT>
<NAME>WireMessage</NAME>
</STRUCT>
<USER_FUNCTION>
<NAME>WireReadFunc</NAME>
<RETURNS>void </RETURNS>
GIOChannel *channel,
WireMessage *msg
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>WireWriteFunc</NAME>
<RETURNS>void </RETURNS>
GIOChannel *channel,
WireMessage *msg
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>WireDestroyFunc</NAME>
<RETURNS>void </RETURNS>
WireMessage *msg
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>WireIOFunc</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,
guint8 *buf,
gulong count
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>WireFlushFunc</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel
</USER_FUNCTION>
<STRUCT>
<NAME>WireMessage</NAME>
struct WireMessage
{
guint32 type;
gpointer data;
};
</STRUCT>
<FUNCTION>
<NAME>wire_register</NAME>
<RETURNS>void </RETURNS>
guint32 type,WireReadFunc read_func,WireWriteFunc write_func,WireDestroyFunc destroy_func
</FUNCTION>
<FUNCTION>
<NAME>wire_set_reader</NAME>
<RETURNS>void </RETURNS>
WireIOFunc read_func
</FUNCTION>
<FUNCTION>
<NAME>wire_set_writer</NAME>
<RETURNS>void </RETURNS>
WireIOFunc write_func
</FUNCTION>
<FUNCTION>
<NAME>wire_set_flusher</NAME>
<RETURNS>void </RETURNS>
WireFlushFunc flush_func
</FUNCTION>
<FUNCTION>
<NAME>wire_read</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint8 *buf,gulong count
</FUNCTION>
<FUNCTION>
<NAME>wire_write</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint8 *buf,gulong count
</FUNCTION>
<FUNCTION>
<NAME>wire_flush</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel
</FUNCTION>
<FUNCTION>
<NAME>wire_error</NAME>
<RETURNS>gboolean </RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>wire_clear_error</NAME>
<RETURNS>void </RETURNS>
void
</FUNCTION>
<FUNCTION>
<NAME>wire_read_msg</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,WireMessage *msg
</FUNCTION>
<FUNCTION>
<NAME>wire_write_msg</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,WireMessage *msg
</FUNCTION>
<FUNCTION>
<NAME>wire_destroy</NAME>
<RETURNS>void </RETURNS>
WireMessage *msg
</FUNCTION>
<FUNCTION>
<NAME>wire_read_int32</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint32 *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_read_int16</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint16 *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_read_int8</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint8 *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_read_double</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,gdouble *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_read_string</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,gchar **data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_write_int32</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint32 *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_write_int16</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint16 *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_write_int8</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,guint8 *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_write_double</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,gdouble *data,gint count
</FUNCTION>
<FUNCTION>
<NAME>wire_write_string</NAME>
<RETURNS>gboolean </RETURNS>
GIOChannel *channel,gchar **data,gint count
</FUNCTION>
<MACRO>
<NAME>GIMP_MAJOR_VERSION</NAME>
#define GIMP_MAJOR_VERSION (1)
</MACRO>
<MACRO>
<NAME>GIMP_MINOR_VERSION</NAME>
#define GIMP_MINOR_VERSION (3)
</MACRO>
<MACRO>
<NAME>GIMP_MICRO_VERSION</NAME>
#define GIMP_MICRO_VERSION (0)
</MACRO>
<MACRO>
<NAME>GIMP_VERSION</NAME>
#define GIMP_VERSION "1.3.0"
</MACRO>
<MACRO>
<NAME>GIMP_CHECK_VERSION</NAME>
#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)))
</MACRO>

View File

@ -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 <gtk/gtk.h>
#include <libgimp/gimp.h>
GimpPlugInInfo PLUG_IN_INFO =
{
NULL,
NULL,
NULL,
NULL,
};

View File

@ -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

View File

@ -1,3 +0,0 @@
#include <gtk/gtk.h>
#include "libgimpbase-include.c"

View File

@ -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:

View File

@ -16,22 +16,3 @@ provide it here.
g_strescape()
</para>
<!-- ##### FUNCTION gimp_strescape ##### -->
<para>
</para>
@source:
@exceptions:
@Returns:
<!-- ##### FUNCTION gimp_strcompress ##### -->
<para>
</para>
@source:
@Returns:

View File

@ -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

View File

@ -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 = \
$(content_files) \
$(extra_files) \
$(HTML_IMAGES) \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE).hierarchy \
$(DOC_MODULE).signals \
$(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
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

View File

@ -1,306 +0,0 @@
<ENUM>
<NAME>GimpRGBCompositeMode</NAME>
typedef enum
{
GIMP_RGB_COMPOSITE_NONE = 0,
GIMP_RGB_COMPOSITE_NORMAL,
GIMP_RGB_COMPOSITE_BEHIND
} GimpRGBCompositeMode;
</ENUM>
<FUNCTION>
<NAME>gimp_rgb_set</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb,gdouble r,gdouble g,gdouble b
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_set_alpha</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb,gdouble a
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_set_uchar</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb,guchar r,guchar g,guchar b
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_get_uchar</NAME>
<RETURNS>void </RETURNS>
const GimpRGB *rgb,guchar *r,guchar *g,guchar *b
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_add</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb1,const GimpRGB *rgb2
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_subtract</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb1,const GimpRGB *rgb2
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_multiply</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb1,gdouble factor
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_distance</NAME>
<RETURNS>gdouble </RETURNS>
const GimpRGB *rgb1,const GimpRGB *rgb2
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_max</NAME>
<RETURNS>gdouble </RETURNS>
const GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_min</NAME>
<RETURNS>gdouble </RETURNS>
const GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_clamp</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_gamma</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgb,gdouble gamma
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_intensity</NAME>
<RETURNS>gdouble </RETURNS>
const GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_intensity_uchar</NAME>
<RETURNS>guchar </RETURNS>
const GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_composite</NAME>
<RETURNS>void </RETURNS>
GimpRGB *color1,const GimpRGB *color2,GimpRGBCompositeMode mode
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_set</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgba,gdouble r,gdouble g,gdouble b,gdouble a
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_set_uchar</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgba,guchar r,guchar g,guchar b,guchar a
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_get_uchar</NAME>
<RETURNS>void </RETURNS>
const GimpRGB *rgba,guchar *r,guchar *g,guchar *b,guchar *a
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_add</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgba1,const GimpRGB *rgba2
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_subtract</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgba1,const GimpRGB *rgba2
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_multiply</NAME>
<RETURNS>void </RETURNS>
GimpRGB *rgba,gdouble factor
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgba_distance</NAME>
<RETURNS>gdouble </RETURNS>
const GimpRGB *rgba1,const GimpRGB *rgba2
</FUNCTION>
<MACRO>
<NAME>INTENSITY_RED</NAME>
#define INTENSITY_RED 0.30
</MACRO>
<MACRO>
<NAME>INTENSITY_GREEN</NAME>
#define INTENSITY_GREEN 0.59
</MACRO>
<MACRO>
<NAME>INTENSITY_BLUE</NAME>
#define INTENSITY_BLUE 0.11
</MACRO>
<MACRO>
<NAME>INTENSITY</NAME>
#define INTENSITY(r,g,b) ((r) * INTENSITY_RED + \
(g) * INTENSITY_GREEN + \
(b) * INTENSITY_BLUE + 0.001)
</MACRO>
<FUNCTION>
<NAME>gimp_hsv_set</NAME>
<RETURNS>void </RETURNS>
GimpHSV *hsv,gdouble h,gdouble s,gdouble v
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsv_clamp</NAME>
<RETURNS>void </RETURNS>
GimpHSV *hsv
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsva_set</NAME>
<RETURNS>void </RETURNS>
GimpHSV *hsva,gdouble h,gdouble s,gdouble v,gdouble a
</FUNCTION>
<STRUCT>
<NAME>GimpRGB</NAME>
</STRUCT>
<STRUCT>
<NAME>GimpRGB</NAME>
struct GimpRGB
{
gdouble r, g, b, a;
};
</STRUCT>
<STRUCT>
<NAME>GimpHSV</NAME>
</STRUCT>
<STRUCT>
<NAME>GimpHSV</NAME>
struct GimpHSV
{
gdouble h, s, v, a;
};
</STRUCT>
<USER_FUNCTION>
<NAME>GimpRenderFunc</NAME>
<RETURNS>void </RETURNS>
gdouble x,
gdouble y,
GimpRGB *color,
gpointer data
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>GimpPutPixelFunc</NAME>
<RETURNS>void </RETURNS>
gint x,
gint y,
GimpRGB *color,
gpointer data
</USER_FUNCTION>
<USER_FUNCTION>
<NAME>GimpProgressFunc</NAME>
<RETURNS>void </RETURNS>
gint min,
gint max,
gint current,
gpointer data
</USER_FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hsv</NAME>
<RETURNS>void </RETURNS>
const GimpRGB *rgb,GimpHSV *hsv
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hsl</NAME>
<RETURNS>void </RETURNS>
const GimpRGB *rgb,gdouble *hue,gdouble *saturation,gdouble *lightness
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsv_to_rgb</NAME>
<RETURNS>void </RETURNS>
const GimpHSV *hsv,GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsl_to_rgb</NAME>
<RETURNS>void </RETURNS>
gdouble hue,gdouble saturation,gdouble lightness,GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hwb</NAME>
<RETURNS>void </RETURNS>
const GimpRGB *rgb,gdouble *hue,gdouble *whiteness,gdouble *blackness
</FUNCTION>
<FUNCTION>
<NAME>gimp_hwb_to_rgb</NAME>
<RETURNS>void </RETURNS>
gdouble hue,gdouble whiteness,gdouble blackness,GimpRGB *rgb
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hsv_int</NAME>
<RETURNS>void </RETURNS>
gint *red ,gint *green ,gint *blue
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsv_to_rgb_int</NAME>
<RETURNS>void </RETURNS>
gint *hue ,gint *saturation ,gint *value
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hls_int</NAME>
<RETURNS>void </RETURNS>
gint *red ,gint *green ,gint *blue
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_l_int</NAME>
<RETURNS>gint </RETURNS>
gint red,gint green,gint blue
</FUNCTION>
<FUNCTION>
<NAME>gimp_hls_to_rgb_int</NAME>
<RETURNS>void </RETURNS>
gint *hue ,gint *lightness ,gint *saturation
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hsv_double</NAME>
<RETURNS>void </RETURNS>
gdouble *red ,gdouble *green ,gdouble *blue
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsv_to_rgb_double</NAME>
<RETURNS>void </RETURNS>
gdouble *hue ,gdouble *saturation,gdouble *value
</FUNCTION>
<FUNCTION>
<NAME>gimp_rgb_to_hsv4</NAME>
<RETURNS>void </RETURNS>
guchar *hsv,gdouble *red,gdouble *green,gdouble *blue
</FUNCTION>
<FUNCTION>
<NAME>gimp_hsv_to_rgb4</NAME>
<RETURNS>void </RETURNS>
guchar *rgb,gdouble hue,gdouble saturation,gdouble value
</FUNCTION>
<FUNCTION>
<NAME>gimp_adaptive_supersample_area</NAME>
<RETURNS>gulong </RETURNS>
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
</FUNCTION>
<FUNCTION>
<NAME>gimp_bilinear</NAME>
<RETURNS>gdouble </RETURNS>
gdouble x,gdouble y,gdouble *values
</FUNCTION>
<FUNCTION>
<NAME>gimp_bilinear_8</NAME>
<RETURNS>guchar </RETURNS>
gdouble x,gdouble y,guchar *values
</FUNCTION>
<FUNCTION>
<NAME>gimp_bilinear_16</NAME>
<RETURNS>guint16 </RETURNS>
gdouble x,gdouble y,guint16 *values
</FUNCTION>
<FUNCTION>
<NAME>gimp_bilinear_32</NAME>
<RETURNS>guint32 </RETURNS>
gdouble x,gdouble y,guint32 *values
</FUNCTION>
<FUNCTION>
<NAME>gimp_bilinear_rgb</NAME>
<RETURNS>GimpRGB </RETURNS>
gdouble x,gdouble y,GimpRGB *values
</FUNCTION>
<FUNCTION>
<NAME>gimp_bilinear_rgba</NAME>
<RETURNS>GimpRGB </RETURNS>
gdouble x,gdouble y,GimpRGB *values
</FUNCTION>

View File

@ -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 <glib.h>
#include <libgimp/gimp.h>
GimpPlugInInfo PLUG_IN_INFO =
{
NULL,
NULL,
NULL,
NULL,
};

View File

@ -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

View File

@ -1,3 +0,0 @@
#include <gtk/gtk.h>
#include "libgimpcolor-include.c"

View File

@ -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

View File

@ -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 = \
$(content_files) \
$(extra_files) \
$(HTML_IMAGES) \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE).hierarchy \
$(DOC_MODULE).signals \
$(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
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

View File

@ -1,396 +0,0 @@
<FUNCTION>
<NAME>gimp_vector2_inner_product</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector2 *vector1,GimpVector2 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_inner_product_val</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector2 vector1,GimpVector2 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_cross_product</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 *vector1,GimpVector2 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_cross_product_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector1,GimpVector2 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_length</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector2 *vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_length_val</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector2 vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_normalize</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_normalize_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_mul</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *vector,gdouble factor
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_mul_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector,gdouble factor
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_sub</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *result,GimpVector2 *vector1,GimpVector2 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_sub_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector1,GimpVector2 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_set</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *vector,gdouble x,gdouble y
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_new_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
gdouble x,gdouble y
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_add</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *result,GimpVector2 *vector1,GimpVector2 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_add_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector1,GimpVector2 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_neg</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_neg_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_rotate</NAME>
<RETURNS>void </RETURNS>
GimpVector2 *vector,gdouble alpha
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector2_rotate_val</NAME>
<RETURNS>GimpVector2 </RETURNS>
GimpVector2 vector,gdouble alpha
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_inner_product</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector3 *vector1,GimpVector3 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_inner_product_val</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector3 vector1,GimpVector3 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_cross_product</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 *vector1,GimpVector3 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_cross_product_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector1,GimpVector3 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_length</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector3 *vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_length_val</NAME>
<RETURNS>gdouble </RETURNS>
GimpVector3 vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_normalize</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_normalize_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_mul</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *vector,gdouble factor
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_mul_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector,gdouble factor
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_sub</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *result,GimpVector3 *vector1,GimpVector3 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_sub_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector1,GimpVector3 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_set</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *vector,gdouble x,gdouble y,gdouble z
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_new</NAME>
<RETURNS>GimpVector3 </RETURNS>
gdouble x,gdouble y,gdouble z
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_add</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *result,GimpVector3 *vector1,GimpVector3 *vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_add_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector1,GimpVector3 vector2
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_neg</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_neg_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_rotate</NAME>
<RETURNS>void </RETURNS>
GimpVector3 *vector,gdouble alpha,gdouble beta,gdouble gamma
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector3_rotate_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
GimpVector3 vector,gdouble alpha,gdouble beta,gdouble gamma
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector_2d_to_3d</NAME>
<RETURNS>void </RETURNS>
gint sx,gint sy,gint w,gint h,gint x,gint y,GimpVector3 *vp,GimpVector3 *p
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector_2d_to_3d_val</NAME>
<RETURNS>GimpVector3 </RETURNS>
gint sx,gint sy,gint w,gint h,gint x,gint y,GimpVector3 vp,GimpVector3 p
</FUNCTION>
<FUNCTION>
<NAME>gimp_vector_3d_to_2d</NAME>
<RETURNS>void </RETURNS>
gint sx,gint sy,gint w,gint h,gdouble *x,gdouble *y,GimpVector3 *vp,GimpVector3 *p
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_transform_point</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,gdouble x,gdouble y,gdouble *newx,gdouble *newy
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_mult</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix1,GimpMatrix3 matrix2
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_identity</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_translate</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,gdouble x,gdouble y
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_scale</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,gdouble x,gdouble y
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_rotate</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,gdouble theta
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_xshear</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,gdouble amount
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_yshear</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,gdouble amount
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_determinant</NAME>
<RETURNS>gdouble </RETURNS>
GimpMatrix3 matrix
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_invert</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 matrix,GimpMatrix3 matrix_inv
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_duplicate</NAME>
<RETURNS>void </RETURNS>
GimpMatrix3 src,GimpMatrix3 target
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_is_diagonal</NAME>
<RETURNS>gboolean </RETURNS>
GimpMatrix3 matrix
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_is_identity</NAME>
<RETURNS>gboolean </RETURNS>
GimpMatrix3 matrix
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix3_is_simple</NAME>
<RETURNS>gboolean </RETURNS>
GimpMatrix3 matrix
</FUNCTION>
<FUNCTION>
<NAME>gimp_matrix4_to_deg</NAME>
<RETURNS>void </RETURNS>
GimpMatrix4 matrix,gdouble *a,gdouble *b,gdouble *c
</FUNCTION>
<MACRO>
<NAME>G_PI</NAME>
#define G_PI 3.14159265358979323846
</MACRO>
<MACRO>
<NAME>G_PI_2</NAME>
#define G_PI_2 1.57079632679489661923
</MACRO>
<MACRO>
<NAME>G_PI_4</NAME>
#define G_PI_4 0.78539816339744830962
</MACRO>
<MACRO>
<NAME>G_SQRT2</NAME>
#define G_SQRT2 1.4142135623730951
</MACRO>
<MACRO>
<NAME>G_MAXRAND</NAME>
#define G_MAXRAND G_MAXINT
</MACRO>
<MACRO>
<NAME>G_MAXRAND</NAME>
#define G_MAXRAND RAND_MAX
</MACRO>
<MACRO>
<NAME>RINT</NAME>
#define RINT(x) rint(x)
</MACRO>
<MACRO>
<NAME>RINT</NAME>
#define RINT(x) floor ((x) + 0.5)
</MACRO>
<MACRO>
<NAME>ROUND</NAME>
#define ROUND(x) ((int) ((x) + 0.5))
</MACRO>
<MACRO>
<NAME>SQR</NAME>
#define SQR(x) ((x) * (x))
</MACRO>
<MACRO>
<NAME>MAX255</NAME>
#define MAX255(a) ((a) | (((a) & 256) - (((a) & 256) >> 8)))
</MACRO>
<MACRO>
<NAME>CLAMP0255</NAME>
#define CLAMP0255(a) CLAMP(a,0,255)
</MACRO>
<MACRO>
<NAME>gimp_deg_to_rad</NAME>
#define gimp_deg_to_rad(angle) ((angle) * (2.0 * G_PI) / 360.0)
</MACRO>
<MACRO>
<NAME>gimp_rad_to_deg</NAME>
#define gimp_rad_to_deg(angle) ((angle) * 360.0 / (2.0 * G_PI))
</MACRO>
<MACRO>
<NAME>FINITE</NAME>
#define FINITE(x) _finite(x)
</MACRO>
<MACRO>
<NAME>FINITE</NAME>
#define FINITE(x) isfinite(x)
</MACRO>
<MACRO>
<NAME>FINITE</NAME>
#define FINITE(x) finite(x)
</MACRO>
<TYPEDEF>
<NAME>GimpMatrix3[3][3]</NAME>
typedef gdouble GimpMatrix3[3][3];
</TYPEDEF>
<TYPEDEF>
<NAME>GimpMatrix4[4][4]</NAME>
typedef gdouble GimpMatrix4[4][4];
</TYPEDEF>
<STRUCT>
<NAME>GimpVector2</NAME>
</STRUCT>
<STRUCT>
<NAME>GimpVector3</NAME>
</STRUCT>
<STRUCT>
<NAME>GimpVector4</NAME>
</STRUCT>
<STRUCT>
<NAME>GimpVector2</NAME>
struct GimpVector2
{
gdouble x, y;
};
</STRUCT>
<STRUCT>
<NAME>GimpVector3</NAME>
struct GimpVector3
{
gdouble x, y, z;
};
</STRUCT>
<STRUCT>
<NAME>GimpVector4</NAME>
struct GimpVector4
{
gdouble x, y, z, w;
};
</STRUCT>

View File

@ -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 <glib.h>
#include <libgimp/gimp.h>
GimpPlugInInfo PLUG_IN_INFO =
{
NULL,
NULL,
NULL,
NULL,
};

View File

@ -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

View File

@ -1,3 +0,0 @@
#include <gtk/gtk.h>
#include "libgimpmath-include.c"

View File

@ -14,34 +14,6 @@ Mathematical definitions and macros.
</para>
<!-- ##### MACRO G_PI ##### -->
<para>
</para>
<!-- ##### MACRO G_PI_2 ##### -->
<para>
</para>
<!-- ##### MACRO G_PI_4 ##### -->
<para>
</para>
<!-- ##### MACRO G_SQRT2 ##### -->
<para>
</para>
<!-- ##### MACRO G_MAXRAND ##### -->
<para>

View File

@ -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

View File

@ -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 = \
$(content_files) \
$(extra_files) \
$(HTML_IMAGES) \
$(DOC_MAIN_SGML_FILE) \
$(DOC_MODULE).hierarchy \
$(DOC_MODULE).signals \
$(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
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

File diff suppressed because it is too large Load Diff

View File

@ -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

View File

@ -1,48 +0,0 @@
<SIGNAL>
<NAME>GimpChainButton::toggled</NAME>
<RETURNS>void</RETURNS>
GimpChainButton *gimpchainbutton
</SIGNAL>
<SIGNAL>
<NAME>GimpColorButton::color-changed</NAME>
<RETURNS>void</RETURNS>
GimpColorButton *gimpcolorbutton
</SIGNAL>
<SIGNAL>
<NAME>GimpFileSelection::filename-changed</NAME>
<RETURNS>void</RETURNS>
GimpFileSelection *gimpfileselection
</SIGNAL>
<SIGNAL>
<NAME>GimpPathEditor::path-changed</NAME>
<RETURNS>void</RETURNS>
GimpPathEditor *gimppatheditor
</SIGNAL>
<SIGNAL>
<NAME>GimpSizeEntry::value-changed</NAME>
<RETURNS>void</RETURNS>
GimpSizeEntry *gimpsizeentry
</SIGNAL>
<SIGNAL>
<NAME>GimpSizeEntry::refval-changed</NAME>
<RETURNS>void</RETURNS>
GimpSizeEntry *gimpsizeentry
</SIGNAL>
<SIGNAL>
<NAME>GimpSizeEntry::unit-changed</NAME>
<RETURNS>void</RETURNS>
GimpSizeEntry *gimpsizeentry
</SIGNAL>
<SIGNAL>
<NAME>GimpUnitMenu::unit-changed</NAME>
<RETURNS>void</RETURNS>
GimpUnitMenu *gimpunitmenu
</SIGNAL>

View File

@ -1,5 +1,6 @@
#include <gtk/gtk.h>
#include <libgimp/gimp.h>
#include <libgimp/gimpui.h>
#include "libgimpwidgets-include.c"

View File

@ -51,6 +51,8 @@ up two GimpSizeEntries (see #GimpSizeEntry) linked with a #GimpChainButton.
</para>
@gcb:
@active:
<!-- # Unused Parameters # -->
@is_active:

View File

@ -69,6 +69,8 @@ color, the "color_changed" signal is emitted.
</para>
@gcb:
@type:
<!-- # Unused Parameters # -->
@alpha:

View File

@ -49,14 +49,6 @@ dialog-related stuff.
@Returns:
<!-- ##### FUNCTION gimp_dialog_set_icon ##### -->
<para>
</para>
@dialog:
<!-- ##### FUNCTION gimp_dialog_create_action_area ##### -->
<para>

View File

@ -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.
<!-- ##### FUNCTION gimp_help_connect_help_accel ##### -->
<para>
</para>
@widget:
@help_func:
@help_data:
<!-- ##### FUNCTION gimp_help_set_help_data ##### -->
<para>

View File

@ -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:
<!-- # Unused Parameters # -->
@eek:

View File

@ -59,9 +59,11 @@ gimp_coordinates_new()
@menu_show_pixels:
@menu_show_percent:
@show_refval:
@spinbutton_usize:
@spinbutton_width:
@update_policy:
@Returns:
<!-- # Unused Parameters # -->
@spinbutton_usize:
<!-- ##### FUNCTION gimp_size_entry_add_field ##### -->
@ -206,13 +208,6 @@ gimp_coordinates_new()
@gse:
<!-- ##### SIGNAL GimpSizeEntry::value-changed ##### -->
<para>
</para>
@gimpsizeentry: the object which received the signal.
<!-- ##### SIGNAL GimpSizeEntry::refval-changed ##### -->
<para>
@ -227,3 +222,10 @@ gimp_coordinates_new()
@gimpsizeentry: the object which received the signal.
<!-- ##### SIGNAL GimpSizeEntry::value-changed ##### -->
<para>
</para>
@gimpsizeentry: the object which received the signal.

View File

@ -96,10 +96,12 @@ gtk_object_set_user_data().</entry>
@menu_only:
@menu_item_callback:
@data:
@menu_item_callback_data:
@initial:
@Varargs:
@Returns:
<!-- # Unused Parameters # -->
@data:
<!-- ##### FUNCTION gimp_option_menu_set_history ##### -->
@ -108,6 +110,8 @@ gtk_object_set_user_data().</entry>
</para>
@option_menu:
@item_data:
<!-- # Unused Parameters # -->
@user_data:
@ -194,10 +198,12 @@ gtk_object_set_user_data().</entry>
@in_frame:
@frame_title:
@radio_button_callback:
@data:
@radio_button_callback_data:
@initial:
@Varargs:
@Returns:
<!-- # Unused Parameters # -->
@data:
<!-- ##### FUNCTION gimp_spin_button_new ##### -->
@ -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:
<!-- # Unused Parameters # -->
@scale_usize:
@spinbutton_usize:
<!-- ##### MACRO GIMP_RANDOM_SEED_SPINBUTTON ##### -->
@ -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:
<!-- # Unused Parameters # -->
@spinbutton_usize:
<!-- ##### MACRO GIMP_MEM_SIZE_ENTRY_SPINBUTTON ##### -->

View File

@ -28,7 +28,6 @@ gimpwidgetstypes
</para>
@parent_instance:
<!-- ##### STRUCT GimpChainButton ##### -->
<para>
@ -41,6 +40,7 @@ gimpwidgetstypes
</para>
@parent_instance:
<!-- ##### STRUCT GimpColorButton ##### -->
<para>

View File

@ -1,3 +1,7 @@
2002-03-08 Sven Neumann <sven@gimp.org>
* POTFILES.in: Mitch missed one new file.
2002-03-08 Michael Natterer <mitch@gimp.org>
* POTFILES.in: updated.

View File

@ -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

View File

@ -2,6 +2,7 @@
* Makefile.am: fixes for srcdir != builddir.
* gimp_tips.txt
* gimp_tips.pt.txt: removed.
* pt.po: fixed markup.

View File

@ -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 \

View File

@ -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)