Find a file
Michael Natterer b10adabb5e Added parent window API to the GimpProgress interface and to the libgimp
2005-09-09  Michael Natterer  <mitch@gimp.org>

	Added parent window API to the GimpProgress interface and to
	the libgimp progress stuff. Might look strange, but does
	the right thing in almost all cases (image window, file dialog,
	script-fu dialog etc). Fixes bug #62988.

	* app/core/gimpprogress.[ch]: added GimpProgress::get_window()
	which should return a toplevel window ID if the progress is in a
	window that wants to be the transient parent of plug-in dialogs.

	* app/widgets/gimpwidgets-utils.[ch] (gimp_window_get_native): new
	function which returns the window handle of a GtkWindow's GdkWindow.

	* app/widgets/gimpfiledialog.c: implement ::get_window().

	* app/display/gimpdisplay.[ch]: ditto. Removed window handle API.

	* app/gui/gui-vtable.c: changed accordingly.

	* libgimpbase/gimpbaseenums.[ch] (enum GimpProgressCommand):
	added GIMP_PROGRESS_COMMAND_GET_WINDOW.

	* app/plug-in/plug-in-progress.[ch] (plug_in_progress_get_window):
	new function. Also renamed some functions to match the
	GimpProgress interface, and not the legacy PDB procedure names.

	* tools/pdbgen/pdb/progress.pdb
	* app/core/gimppdbprogress.c: implement get_window() on both
	sides of the wire, keeping backward compatibility (hopefully).

	* libgimp/gimpprogress.[ch]: deprecated gimp_progress_install()
	and added gimp_progress_install_vtable() which takes a vtable with
	padding to be extensible. Added get_window() vtable entry and
	dispatch it accordingly. Also added pulse() which was implemented
	in a hackish way before. Everything is of course backward
	compatible.

	* libgimp/gimpprogressbar.c: inmplement the get_window() stuff
	so a plug-in dialog containing a progress can be the transient
	parent of another dialog in another plug-in.

	* libgimp/gimpui.[ch] (gimp_ui_get_progress_window): new function
	which returns a foreign GdkWindow of this plug-ins progress
	window.

	Renamed gimp_window_set_transient_for_default_display() to
	gimp_window_set_transient() and make it use the progress' window
	handle instead of the display's (which is the right thing to do in
	almost all cases).

	* libgimp/gimp.def
	* libgimp/gimpui.def: add the new functions.

	* tools/pdbgen/enums.pl
	* app/pdb/internal_procs.c
	* app/pdb/progress_cmds.c
	* libgimp/gimpprogress_pdb.[ch]: regenerated.

	* libgimp/gimpexport.c
	* plug-ins/*/*.c: follow API change.
2005-09-09 18:07:31 +00:00
app Added parent window API to the GimpProgress interface and to the libgimp 2005-09-09 18:07:31 +00:00
cursors cursors/Makefile.am cursors/gimp-tool-cursors.xcf 2005-08-18 21:35:06 +00:00
data What The Splash, photo by antenne. 2005-08-10 00:37:32 +00:00
desktop for consistency 2005-06-16 15:49:56 +00:00
devel-docs added new functions. 2005-09-05 21:35:47 +00:00
docs Made 2.3.3, the "What The Hack" release. 2005-08-10 00:55:52 +00:00
etc Made 2.3.3, the "What The Hack" release. 2005-08-10 00:55:52 +00:00
libgimp Added parent window API to the GimpProgress interface and to the libgimp 2005-09-09 18:07:31 +00:00
libgimpbase Added parent window API to the GimpProgress interface and to the libgimp 2005-09-09 18:07:31 +00:00
libgimpcolor deprecated RGB intensity functions and definitions. These coefficients do 2005-08-03 00:36:41 +00:00
libgimpconfig applied capitalization patches contributed by Stephan Binner. Fixes bug 2005-08-23 00:18:08 +00:00
libgimpmath libgimpmath/gimpmd5.c libgimpmath/test-md5.c plug-ins/common/CEL.c 2005-08-03 01:15:36 +00:00
libgimpmodule deprecated. Changed implementation to simply call 2005-06-15 09:26:01 +00:00
libgimpthumb build menus with nmake, too menus/Makefile.am : added to EXTRA_DIST 2005-04-24 15:39:15 +00:00
libgimpwidgets app/actions/channels-commands.c app/actions/qmask-commands.c 2005-08-22 23:39:12 +00:00
m4macros python headers on Win32 don't live in a versioned subdir. Handle that 2005-08-28 16:59:56 +00:00
menus app/actions/edit-actions.c app/menus/menus.c app/widgets/gimpundoeditor.c 2005-09-05 19:31:28 +00:00
modules applied patch that fixes a build issue on Cygwin (bug #314893). 2005-09-02 19:57:44 +00:00
plug-ins Added parent window API to the GimpProgress interface and to the libgimp 2005-09-09 18:07:31 +00:00
po update by amanpreetalam@yahoo.com for Punjabi 2005-09-09 08:50:47 +00:00
po-libgimp Updated Canadian English translation. 2005-09-06 22:19:36 +00:00
po-plug-ins Updated Basque translation. 2005-09-07 20:01:20 +00:00
po-script-fu vi.po: Updated Vietnamese translation. 2005-09-08 11:13:14 +00:00
po-tips Added Gujarati Translations 2005-09-05 04:16:30 +00:00
regexrepl Applied a bunch of small changes contributed by Tim Mooney that fix stack 2004-07-30 20:56:29 +00:00
themes themes/Default/images/tools/stock-tool-foreground-select-16.png icon for 2005-08-08 20:30:26 +00:00
tools Added parent window API to the GimpProgress interface and to the libgimp 2005-09-09 18:07:31 +00:00
.cvsignore Remove outdated file. 2005-03-19 20:27:39 +00:00
acinclude.m4 acinclude.m4 m4macros/Makefile.am new macro: GIMP_DETECT_CFLAGS; used to 2005-08-01 04:45:34 +00:00
AUTHORS AUTHORS regenerated. 2005-09-02 11:14:40 +00:00
authors.dtd authors.dtd simplified by making dc: the default namespace. 2005-08-20 01:52:26 +00:00
authors.xml Mark people as documenter or artist, based on ChangeLogs and other 2005-09-02 11:01:51 +00:00
authors.xsl authors.dtd simplified by making dc: the default namespace. 2005-08-20 01:52:26 +00:00
autogen.sh if any of the pygimp dependencies aren't fulfilled, display a more 2005-06-11 21:10:43 +00:00
ChangeLog Added parent window API to the GimpProgress interface and to the libgimp 2005-09-09 18:07:31 +00:00
ChangeLog.pre-1-0
ChangeLog.pre-1-2 converted to utf-8 2004-05-10 17:45:17 +00:00
ChangeLog.pre-2-0 vte sucks 2004-05-20 02:36:11 +00:00
ChangeLog.pre-2-2 Copied current ChangeLog away and truncated it. 2004-12-19 02:55:34 +00:00
config.h.in grr 2002-06-04 19:31:27 +00:00
config.h.win32 Add comment that the file is outdated. 2003-09-10 02:46:31 +00:00
configure.in Removed 'hi' again until all po files are there. 2005-09-09 08:58:52 +00:00
COPYING
gimp-zip.in For Win32, install gimpthumb.def, like the .def files of the other 2004-04-15 21:09:23 +00:00
gimp.pc.in allow to access (read-only) the current color management configuration 2005-06-26 12:53:31 +00:00
gimpdefs.msc new file to keep common definitions for the msc build use common 2004-02-07 23:01:33 +00:00
gimpthumb.pc.in modernized, made a lot of things m4 macros, and made versioning a lot more 2004-01-22 03:51:46 +00:00
gimptool-2.0.in Create any directories in the install path that do not already exist. 2004-04-04 01:12:32 +00:00
gimptool-win32.c.in Practice what I preach and use g_ascii_strcasecmp() instead of 2005-09-09 13:48:54 +00:00
gimpui.pc.in add libgimpconfig to Libs. 2005-02-04 23:17:54 +00:00
HACKING changed automake version requirement 2005-06-12 10:37:57 +00:00
INSTALL INSTALL Allow gtkhtml2, svg, and lcms features to be disabled explicitly 2005-07-06 00:49:17 +00:00
LICENSE cosmetics. 2003-08-15 10:41:31 +00:00
Makefile.am added po-tips. 2005-07-01 14:29:43 +00:00
makefile.msc TILE_WIDTH is used unconditionally so always include "tile.h" WIN32 needs 2005-02-19 00:50:36 +00:00
NEWS Mention new path cursors. 2005-08-09 21:06:42 +00:00
NEWS.pre-2-0 Makefile.am moved old NEWS to this new file. 2004-04-05 00:17:57 +00:00
NEWS.pre-2-2 added NEWS for the stable branch (no, we haven't branched yet). 2004-12-22 01:07:11 +00:00
README made the warning about the library search path problem more prominent 2005-05-10 22:58:51 +00:00
README.i18n Switch to a more standard way of treating the translations for the startup 2005-06-10 16:38:36 +00:00
README.win32 Sven fixed the EXEEXT problem in plug-ins/common. Updated README.win32 accordingly. 2004-01-29 23:49:29 +00:00

The GNU Image Manipulation Program Version 2.3
----------------------------------------------

This is an unstable development version of GIMP. Please realize that
this is in no way a final product. A lot of new features are
incomplete and some things may even be completely broken. If you need
to get work done, please use the stable version, GIMP 2.2.

GIMP 2.3 replaces earlier GIMP 2.x versions. It is advised that you
uninstall them before installing GIMP 2.3. If you want to keep your
older GIMP 2.x installation in parallel to GIMP 2.3, you have to
choose a separate prefix which is not in your default library search
path. Otherwise your GIMP 2.2 or GIMP 2.0 installation will start to
use the new libraries. You have been warned.

If you think you found a bug in this version, please make sure that it
hasn't been reported earlier and that it is not just new stuff that is
still being worked on and obviously not quite finished yet.

If you want to hack on The GIMP, please read the file HACKING. For
detailed installation instructions, see the file INSTALL.


1. Web Resources
================

The GIMP's home page is at:

	http://www.gimp.org/

Please be sure to visit this site for information, documentation,
tutorials, news, etc.  All things GIMP-ish are available from there.

The automated plug-in registry is located at:

	http://registry.gimp.org/

There you can get the latest versions of plug-ins, using a convenient
forms-based interface.

The latest version of The GIMP can be found at:

	http://www.gimp.org/downloads/


2. Mailing Lists
================

We have several mailing lists dedicated to GIMP user and development
discussion.  There is more info at

	https://lists.xcf.berkeley.edu/mailman/listinfo/<listname>

with <listname> replaced by "gimp-announce", "gimp-user", "gimp-win-users"
or "gimp-developer" (without the quotes, of course) depending on the list
you want to subscribe to.  Links to the mailing list archives can be
found at the same addresses as given above.

Gimp-announce is a low-traffic list with announcements about new
releases of GIMP and plug-ins. Gimp-user is a mailing list dedicated
to user problems, hints and tips, discussion of cool effects, etc.
Gimp-developer is oriented to GIMP core and plug-in developers.  Most
people will only want to be subscribed to gimp-user. If you want to
help develop The GIMP, the gimp-developer mailing list is a good
starting point.

There is also a mailing list, "gimpwin-users", dedicated to users of the
Win32 port.  To subscribe, send an empty message to

	gimpwin-users-subscribe@egroups.com

You can also use the web interface at
http://www.egroups.com/group/gimpwin-users/. Note that as this mailing
list is hosted on egroups.com, the messages from the list contain
relatively unintrusive and easily ignored advertisements at the
end. But if you are absolutely allergic to ads, don't subscribe.


3. IRC
======

And finally, for the real junkies, there is an IRC channel devoted to
the GIMP. On GIMPNet (a private free software oriented network) there is
#gimp.  Many of the developers hang out there.  Some of the GIMPNet
servers are:

	irc.gimp.org:6667
	irc.us.gimp.org:6667
	irc.eu.gimp.org:6667


4. Customizing
==============

The look of GIMP's interface can be customized like any other GTK app
by editing the ~/.gtkrc-2.0 file or by using "themes" (ready-made
customizations).  For downloadable themes and further details, see
http://gtk.themes.org.  Additionally, GIMP reads ~/.gimp-2.2/gtkrc so
you can have settings that only apply to The GIMP.

Included is a set of keybindings similar to those in Adobe Photoshop.
You can find them in the ps-menurc file.  To use them, copy this file
to ~/.gimp-2.2/menurc. You can also manually change the keybindings to
any of your choice by editing ~/.gimp-2.2/menurc.


Have fun,

  Spencer Kimball
  Peter Mattis
  Federico Mena
  Manish Singh
  Sven Neumann
  Michael Natterer
  Dave Neary