gimp/plug-ins/gflare
Michael Natterer ef751a454d gimprc.in replaced "color-cube" by "min-colors".
2000-04-30  Michael Natterer  <mitch@gimp.org>

	* gimprc.in
	* app/gimprc.[ch]: replaced "color-cube" by "min-colors".

	* app/app_procs.c: read unitrc/gimprc before displaying the splash.

	* app/colormaps.c: set min_colors and install_cmap before
	initializing GdkRGB.

	* app/gimprc.[ch]
	* app/gimpunit.c: don't call the splash's progress_update function.

	* app/plug_in.c: pass min_colors instead of color_cube to plugins.

	* app/preferences_dialog.c: widget for min_colors.

	* libgimp/gimp.[ch]: s/color_cube/min_colors/ but left
	gimp_color_cube() there for source level compatibility.

	* libgimp/gimpprotocol.[ch]: changed the GPConfig message
	accordinly and increased the gimp protocol version number because
	the change breaks binary compatibility. Also actually pass the
	use_xshm variable over the wire (was only in the GPConfig struct
	before).

	Was it the right thing to do to increase the version number??

	* libgimp/gimpui.c (gimp_ui_init): use the same code as the app
	for initializing GdkRGB. Never explicitly activate Gdk's SHM
	usage (only switch it off).

	* app/main.c
	* libgimp/gimp.c: reverted the handling of all signals except
	SIGCHLD back to plain old signal() because those signals are
	fatal anyway and sigaction() as used by gimp_signal_*() made
	debugging (stacktrace) impossible.

	* plug-ins/AlienMap/AlienMap.c
	* plug-ins/AlienMap2/AlienMap2.c
	* plug-ins/FractalExplorer/Dialogs.c
	* plug-ins/bmp/bmp.c
	* plug-ins/borderaverage/borderaverage.c
	* plug-ins/dbbrowser/dbbrowser.c
	* plug-ins/faxg3/faxg3.c
	* plug-ins/fits/fits.c
	* plug-ins/flame/flame.c
	* plug-ins/fp/fp.c
	* plug-ins/fp/fp_gtk.c
	* plug-ins/gdyntext/Makefile.am
	* plug-ins/gdyntext/gdyntext_ui.c
	* plug-ins/gfig/gfig.c
	* plug-ins/gflare/gflare.c
	* plug-ins/gfli/gfli.c
	* plug-ins/gimpressionist/gimpressionist.c
	* plug-ins/helpbrowser/helpbrowser.c
	* plug-ins/ifscompose/ifscompose.c
	* plug-ins/imagemap/Makefile.am
	* plug-ins/imagemap/imap_main.c
	* plug-ins/maze/maze_face.c
	* plug-ins/mosaic/mosaic.c
	* plug-ins/pagecurl/pagecurl.c
	* plug-ins/print/print.c
	* plug-ins/rcm/rcm_dialog.c
	* plug-ins/script-fu/script-fu-console.c
	* plug-ins/script-fu/script-fu-scripts.c
	* plug-ins/script-fu/script-fu-server.c
	* plug-ins/sel2path/Makefile.am
	* plug-ins/sel2path/sel2path.c
	* plug-ins/sgi/sgi.c
	* plug-ins/sinus/sinus.c
	* plug-ins/struc/struc.c
	* plug-ins/webbrowser/webbrowser.c
	* plug-ins/winsnap/winsnap.c
	* plug-ins/xjt/xjt.c: use gimp_ui_init().

	* plug-ins/Lighting/lighting_ui.c
	* plug-ins/MapObject/mapobject_ui.c: only switch Gdk SHM usage off,
	never on. Don't use gimp_ui_init() here because of libgck.
2000-04-30 18:17:55 +00:00
..
gflares (from gimp-narazaki-990909-0) 1999-09-09 07:09:33 +00:00
.cvsignore (from gimp-narazaki-990909-0) 1999-09-09 07:09:33 +00:00
asupsample.c *** empty log message *** 1999-09-06 23:31:51 +00:00
asupsample.h *** empty log message *** 1999-09-06 23:31:51 +00:00
gflare.c gimprc.in replaced "color-cube" by "min-colors". 2000-04-30 18:17:55 +00:00
gtkmultioptionmenu.c remove unneccessary rgb_to_hsv and bugfiles 2000-01-19 14:57:19 +00:00
gtkmultioptionmenu.h *** empty log message *** 1999-09-06 23:31:51 +00:00
Makefile.am gimprc.in user_install renamed the "gflares" dir to "gflare" in all places 2000-02-04 15:12:17 +00:00
README *** empty log message *** 1999-09-06 23:31:51 +00:00

==========================================================================

	GFlare plug-in ver 0.25

		Eiichi Takamori <taka@ma1.seikyou.ne.jp>

==========================================================================

  GFlare is a plug-in for the GIMP.  The name "GFlare" is short for
"Gradient Flare".  It renders lense flare effect using custom
gradients.  The basic idea is suggested by Marcelo Malheiros,
originally based on a 3DStudio MAX plug-in called LenZFX:
	http://www.digimation.com/techsupp/lzfxfeat.htm

INSTALL:

1) Edit Makefile, if needed.

2) Type "make install".

3) Type "make install-data" if needed. (It copies sample gradients and
   gflares under ~/.gimp)

3) Add new entry to ~/.gimp/gimprc as
     (gflare-path "${gimp_dir}/gflares:${gimp_data_dir}/gflares")

3) Run the GIMP. The menu path is <Image>/Filters/Effects/GFlare.


HOW TO USE IT:

  The document is not yet done. Try and see.

  Main Dialog:
  - Preview
      click on it changes the position of GFlare
  - Settings page
    - Center, Radius (pixel), Rotation (degree), Hue Rotation (degree)
    - Vector Angle (degree) and Vector Length (percentage to Radius)
    - adaptive supersampling ... same as "Blend tool"
  - Selector page
    - ListBox
    - New, Edit, Copy, Delete buttons. Edit button invokes GFlare Editor.

  GFlare Editor:
  - General page:
  - Glow page:
  - Rays page:
  - Second Flares page:     

  WARNING: This plug-in is in development stage, and the code is very
alpha. The GFlare datafile format may be changed in future version.

  Suggestions and ideas for user interface, flare algorithm, etc. are
very welcome.


KNOWN BUGS:

  There are still lots of bugs, of course. ;-)
  They seem related to GTK, and I don't know exactly how I can fix them.

  * It warns at startup as:
    ** WARNING **: file gdkwindow.c: line 422 (gdk_window_move_resize): "window != NULL"
    If you are annoyed, accompanying "gtkviewport.c.patch" will shut up
    the warning.
  * Edit button remains prelighted when GFlare Editor dialog is done.
  * Dialogs are not shown quickly at startup.
  * Sometimes note tab labels are disappeared.
  * Sometimes it crashes, but I don't know yet why it happens.

TODO:
  * Random hue scattering for Second Flares.
  * Improve internal gradients.
  * Currently number of Second Flares is fixed(30).
  * Change opacity for one second flare dynamically, in inverse
    proportion to the size of it.
  * Reduce dialog size
  * Add tweak ability "How to combine Glow, Rays, Second Flares in
    what order"


CREDITS:

  Marcelo Marheiros and Federico Mena Quintero suggested a lot of
ideas. Very Thanks!!

  Marcelo made gradients whose names end with _1, _2, etc. The
gradients whose names end with _101, _102 etc. are mine.

  Quartic did awful Gradient Editor, and gradients PDB procedures.

  A fair proportion of this code was taken from:

  The GIMP -- an image manipulation program
  Copyright (C) 1995 Spencer Kimball and Peter Mattis

  Gradient editor module copyight (C) 1996-1997 Federico Mena Quintero
  federico@nuclecu.unam.mx