____ _ __ __ _ _ _
/ ___(_)_ __ ___ _ __ | \/ (_) | |
| | _| | '_ ` _ \| '_ \| |\/| | | | |
| |_| | | | | | | | |_) | | | | | | |
\____|_|_| |_| |_| .__/|_| |_|_|_|_|
A Sawmill theme tool for The GIMP.
GimpMill is a GIMP plugin written in Python using James Henstrige's
really cool Python GIMP bindings. It allows the construction of Sawmill
themes within The GIMP - extending the GIMP interface to allow theme
creation like the GAP extends it to allow animation creation.
To run GimpMill you'll need GIMP 1.1 installed (I'm using 1.1.14, but I
don't know what other versions will work) and pygimp (Debian package
gimp-python, or look at http://www.daa.com.au/~james/pygimp/). Just copy
the gimpmill.py file to ~/.gimp-1.1/plug-ins and start The GIMP.
GimpMill's design revolves around the design of Sawmill and its themes,
so to understand how to use GimpMill you'll need to have a understanding
of Sawmill themes. Sawmill themes are based around "frame parts" - images
or text that are stuck to the outside of windows.
To use GimpMill, first create a mockup "screenshot" of how you would like
one window to look. Next turn the "application window" bit of your image
(i.e the bit in between your window borders) into its own layer - the size
of the window - by selecting the area and using <Image>/Select/Float and
then <Layers>/New. Name this layer "WINDOW". For each of the frame parts
create a separate layer in the way described above, but call each of these
"PART: name" where name will be used in the image name. To set frame part
attributes append "name = value" pairs to the frame part's layer's name
(e.g. "PART: closebutton class=close-button"). Finally to specify the
difference between the default frame decoration and the focussed,
mouseover, etc decoration you can optionally create layers called NORMAL,
FOCUSED, HIGHLIGHTED and CLICKED. These are merged with frame part layers
before they're saved. Often a black layer with 50% opacity in "Multiply"
mode will be what you're after, but if nececarry you can provide complete
Finally "<Image>/Filters/Misc/Make Sawmill Theme" will build your theme
and put it in your ~/.sawmill/themes directory - ready for you to use and
Take a look at the BoldLineY.xcf for the nitty gritty implementation
o GIMP 1.1.14 seems to have a bug converting floating selections into
layers by pressing <Layers>/New. If often gets the size wrong and
generally internally confused.
o Only one frame type is supported. It is used for default, transient,
shaped and shaped-transient windows. I would like to support differnt
frame types, but I can't think of an elegant way of doing it. I would
certainly welcome suggestions.
o Its probably hard to produce really complex themes fully using this
tool. It is however a good way to produce the required images and an
initial theme.jl file. I'm planning to support tiled images when I can
think of a nice way of specifying them (again, ideas are more than
NOTE: BoldLineY is based off the BoldLineY screenshot I got off
http://www.kaleidoscope.net/. It was designed by Hideaki Kamada. Some more
of his themes (or schemes as Kaleidoscope calls them) for the Mac are
Enjoy, and don't forget to submit your themes to sawmill.themes.org.
Updates will be posted at http://www.yakk.net/projects.gimpmill.html.
Files are stored at ftp://ftp.ucc.gu.uwa.edu.au/members/yakk/gimpmill/.
Ian McKellar <[EMAIL PROTECTED]> Tue Jan 11 2000
Ian McKellar | Email: yakk(a)yakk.net | Web: http://www.yakk.net/
Fax: +61 (8) 9265 0821 / +0 (775) 205 0307 | Home: +61 (8) 9389 9152
If God didn't want us to eat animals, he wouldn't have made them out of meat.