summaryrefslogtreecommitdiffstats
path: root/plug-ins/gimpressionist/README
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--plug-ins/gimpressionist/README102
1 files changed, 102 insertions, 0 deletions
diff --git a/plug-ins/gimpressionist/README b/plug-ins/gimpressionist/README
new file mode 100644
index 0000000..42d90a4
--- /dev/null
+++ b/plug-ins/gimpressionist/README
@@ -0,0 +1,102 @@
+ 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>