gimp/plug-ins/gimpressionist
Jehan 18c37f7084 plug-ins, libgimp: override set_i18n() for all our core plug-ins.
Hence avoiding the stderr messages. These are going to be localized with
centrally installed catalogs "gimp*-std-plugins", "gimp*-script-fu" and
"gimp*-python".

We now handle core plug-in localizations differently and in particular,
with kind of a reverse logic:

- We don't consider "gimp*-std-plugins" to be the default catalog
  anymore. It made sense in the old world where we would consider the
  core plug-ins to be the most important and numerous ones. But we want
  to push a world where people are even more encouraged to develop their
  own plug-ins. These won't use the standard catalog anymore (because
  there are nearly no reasons that the strings are the same, it's only a
  confusing logic). So let's explicitly set the standard catalogs with
  DEFINE_STD_SET_I18N macro (which maps to a different catalog for
  script-fu plug-ins).
- Doing something similar for Python plug-ins which have again their own
  catalog.
- Getting rid of the INIT_I18N macro since now all the locale domain
  binding is done automatically by libgimp when using the set_i18n()
  method infrastructure.
2022-06-05 01:57:02 +02:00
..
Brushes Meson port. 2019-09-11 16:42:04 +02:00
Paper Meson port. 2019-09-11 16:42:04 +02:00
Presets Meson port. 2019-09-11 16:42:04 +02:00
.gitignore Adding Microsoft Windows executables to the .gitignore files 2009-06-19 00:14:17 +02:00
Makefile.am plug-ins: port gimpressionist to libgimp objects 2019-08-31 00:19:20 +02:00
README Bug 692641 - Various spelling fixes 2013-01-27 18:59:02 +01:00
brush.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
brush.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
color.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
color.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
general.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
general.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
gimp.c plug-ins, libgimp: override set_i18n() for all our core plug-ins. 2022-06-05 01:57:02 +02:00
gimpressionist.c libgimp, plug-ins: remove the "preview" parameter from gimp_ui_init() 2019-09-20 19:56:00 +02:00
gimpressionist.h app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
globals.c Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
infile.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
meson.build meson: Use libgimp(ui)_dep in plug-ins meson files 2020-05-11 07:01:37 +02:00
orientation.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
orientation.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
orientmap.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
orientmap.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
paper.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
paper.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
placement.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
placement.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
plasma.c Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
ppmtool.c app, libgimp*, pdb, plug-ins: use g_memdup2() instead of g_memdup() 2021-08-26 17:32:09 +02:00
ppmtool.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
presets.c Use g_ascii_dtostr() instead of g_ascii_formatd() 2019-07-30 15:57:36 +02:00
presets.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
preview.c Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
preview.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
random.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
repaint.c Issue #6994: Color Noise produces artifacts with highly saturated… 2021-07-17 18:58:16 +02:00
size.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
size.h Change the license URL from http://www.gnu.org/licenses/ to https:// 2018-07-11 23:29:46 +02:00
sizemap.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00
utils.c app, libgimpwidgets, modules, plug-ins: code changes after GimpScaleEntry… 2020-11-05 18:06:52 +01:00

README

	This is the README for The GIMPressionist
	(c) 1998, 1999 Vidar Madsen - vidar@prosalg.no

	The GIMPressionist is free software, and may be distributed
	freely, provided this file is included!

	This program comes with no warranty, whatsoever. The author
	can not be held liable for any damage caused by proper or
	improper use of this program.


--- Introduction

The GIMPressionist is a plug-in for the GNU Image Manipulation Program,
a.k.a. GIMP. It can be used to create natural looking painting effects
and similar. It can also be run in a primitive "standalone" mode. 

The current version is still a bit shaky, and is to be considered beta
software. I'll do some serious testing, hopefully across a few more
platforms, as soon as I can.

The official Web-page is http://www.prosalg.no/~vidar/gimpressionist/ and
will always contain a link to the latest released version. 


--- Compiling / Installing

To compile (hopefully):
	make

If you want to compile for GTK-1.1 and GIMP-1.1 instead, you will have
to change the two variable at the top of Makefile. Possibly you would
want to edit DEFAULTPATH as well, but that's not critical.

To install plug-in and accompanying files:
	make install

The plug-in installs itself under $HOME/.gimp/plug-ins/ and copies a
couple of files into the directory $HOME/.gimp/gimpressionist/.  The
subdirectories 'Brushes', 'Paper' and 'Presets' will be created during
"make install", and a few files will be added; As a minimum,
'defaultbrush.pgm' and 'defaultpaper.pgm' under their respective
directories. These are vanilla .PGM files, which could be edited (and
created) with any decent program - like GIMP! :-) 


--- Standalone

As of version 0.99 and later, the GIMPressionist can also be run
separately from GIMP. This is primarily intended for debugging
purposes, though, as it still needs GIMP libraries to compile. In your
shell, type: 
	gimpressionist somefile.ppm

The image specified must be a valid PPM file. No other formats are
supported, and probably never will.

If you click "OK", the PPM will be replaced with the "repainted" version.
If you "Cancel", nothing will be done to the file. 


--- File Formats

The "normal" brushes are simply grayscale PGM files, which can be created
with almost any program, including xv and of course GIMP. A number of
brushes is included, so I guess a more in-depth explanation is not
necessary. And, for those who might want to try it, GIMPressionist can
also read GBR files, which is GIMP's native brush format. (You still
need to copy them to the GIMPressionist's brush-directory, though. This
will probably be fixed sometimes.)

Version 0.99.4 introduced the concept of using "colored" brushes (although
"pre-rendered" usually is more correct). The brushes' file format is a
plain PPM file, but the layout is somewhat special (and kinda hard to
explain);

- The Red channel contains a shading map of the brush in question. Often
  it resembles the overall image more or less completely.

- The Green channel contains a high-light map. This is a pre-defined
  image of the shiny parts of the brush. (Ordinary grayscale brushes
  have this calculated automatically with a rough emboss-ish algorithm.)

- The Blue channel functions as a brush mask. When applying a brush
  stroke to the image, all areas colored blue in the file are first
  "blacked out" of the image.


--- Feedback

If you have any comments, criticism, ideas for improvement or new
features, or if you run into problems of any sort, let me know, so that I
can (try to) fix it for the next release! (And, if you find platform-
dependent bugs, please try to fix them and send me a patch!) 

I'm also welcoming contributions in the form of brushes or textures! For
this program to be valuable, it needs them... Bad! All contributions will
be properly credited, of course. 

Good luck and happy painting!

Vidar Madsen <vidar@prosalg.no>