1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
|
This file is automatically generated from the file gsumi.html
in the docs subdirectory.
-------------
GSUMI V1.0 - PRESSURE SENSITIVE "INK" DRAWING
By Owen Taylor <otaylor@gtk.org>
[IMAGE]
WHAT IS GSUMI?
gsumi is essentially a port of xink by Raph Levien <raph@acm.org> to
the gtk user interface toolkit. See the file README.xink for details
about the original program. Almost all of the drawing/rendering code
and all of the clever ideas in the implementation are due to Raph.
Briefly, the program allows drawing in black (pen) or white (eraser)
on a high resolution bitmap which is filtered down to screen
resolution. XInput devices can be used (with pressure support), and
different tools and tool properties can be assigned to each device.
The primary purpose of this project was was to create a testbed for my
ideas about how XInput support should be added to the GIMP. Much of
the code that was developed for gsumi has now been incorporated into
the GTK library.
* More information about XInput and the GIMP is available .
The code of gsumi is still mostly untested for any server other than
XFree86 (on Linux and FreeBSD) and any XInput device other than a
Wacom tablet. If you get it working with any other combination, please
let me know. Bug reports and patches are appreciated, as well as
general comments about the interface.
WHY THE NAME?
I was originally planning to call this gink (gtk+xink, contracted),
but that seemed too close to gimp. So I used the Japanese word for
(Japanese) ink instead: [INLINE] (read sumi). It's probably a bit
misleading since the program doesn't simulate the action of a Japanese
brush (an application for tilt?), but with the eraser, the
correspondence to ink was already a bit poor. As a side note, the
eraser probably really should be thought of as chalk, since that's
what [INLINE] (lit. white ink, read hakuboku) means in Japanese.
WHAT'S NEW IN V1.0
* Workaround for a bug in the XFree86 Wacom driver where it will
sometimes report a pressure of 0.5 instead of one of 0.0
What's new in v0.9
* Updated to GTK+-1.0.0
* Now uses autoconf/automake for configuration
* Pressure sensitivity curve can be modified
* Button presses can be simulated from pressure information to give
a lighter touch.
* Brush drawing code fiddled with some
* Bug fixes
What's new in v0.8
* Brushes have been generalized to be ellipses at any orientation.
* Drawing (but not rendering) code has been extensively revised.
* Brush shape will be modified by device tilt.
* v0.8b1 => v0.8 - documentation changes (9/16/97)
What's new in v0.7
* Minor changes to keep up with GTK.
* Bug fix for a crash that happened when there was no .gsumirc.
What's new in v0.6
* Minor changes to keep up with GTK.
What's new in v0.5
* Most of the XInput functionality has been moved to GDK/GTK. The
gximapper idea has been abandoned and core GDK events have been
extended to have non-integer coordinates, pressure and tilt
fields. GDK/GTK supports both switching via gxid and by the
XFree86 3.3+ method. It can be configured with
--with-xinput=[none/gxi/xfree].
* gsumi (as opposed to gdk) has become much simpler.
What's new in v0.4
* As of gimp 0.99.9, gsumi works with the unmodified gtk library.
(Thanks to Peter Mattis for incorporating the necessary changes.)
* Menus are now done very much like in the gimp.
* There's an undoable "clear" menu item.
* The gxid protocol was changed to make it a bit more robust.
* Support for the XFree86 3.3+ method of handling pointer switching
has been added. (There can be multiple logical devices for each
physical device, one is used to control the core pointer in
AlwaysCore mode, the other is used by the program to get detailed
information about motion events. Thanks to Frederic Lepied for
implementing this.)
* Bug Fixes.
What's new in v0.3
* Pointer switching is done via the gxid daemon. (Allows multiple
coexisting clients). See below. [ note: as of v0.4 another method
of switching is also available ]
* Overlapping windows are now handled correctly in most cases.
* The pointer won't leave a window while a button is down. (This may
replace the concept of slop).
* Files can be saved in compressed form via a pipe to gzip.
* 32 bit modes now work correctly.
* The user can specify the number of gray shades to use for 8-bit
mode.
* Settings can be saved via a .gsumirc
* gsumi now compiles and runs without XInput support. (But isn't too
exciting that way).
* Various bugfixes and small enhancements.
REQUIREMENTS
You'll need the GTK+ 1.0.0 or later. (Available from ftp.gtk.org) To enable
XInput support, you'll should compile GTK+ with the --with-xinput=xfree or
--with-xinput=gxid options. See the section Configuring XInput below for
more information.
AVAILABILITY
At least for right now, I have put source for gsumi on my web page:
(http://www.gtk.org/~otaylor/gsumi/gsumi.html)
* Source of gsumi-1.0 (about 100k)
INSTALLATION
* Type 'configure; make'
* Become root if necessary
* Type 'make install'
USE
I hope the operation is reasonably intuitive, but a few notes:
* You'll need to set extension devices you want to use into absolute
mode before using them. The command for this (at least for
XFree86) is 'xsetmode [devicename] ABSOLUTE'. This also can be
done as a setting in your XF86Config file.
* gxid (if used) should be started first.
* gsumi takes the following command line arguments:
Usage: gsumi [ options ]
Valid options are:
-h --help Print this message
-v --version Print version number
-n --num-grays NUM Number of gray levels
--gxid-host HOST Host name for gxid daemon (default: localhost)
--gxid-port PORT Port number for gxid daemon (default: 6951)
The port and host for gxid can also be set via the environment
variables GXID_HOST and GXID_PORT.
* Changing the x-y axis mapping is likely to cause XServer errors
for devices in anything but window-mapped mode.
* Currently implemented keyboard shortcuts other than the menu
accelerators are:
+ the arrow keys to scroll
+ the space bar to toggle between pen and eraser
* A file '$HOME/.gsumirc' is created by the 'Save Options' menu
item. It is read upon subsequent starts of gsumi. This file is
meant to be human readable and editable, but there should be no
reason to do so. (Everything is accessible through the user
interface).
* Your window manager may grab the server when placing a window. In
this case, device switching will not work. With fvwm, I find it
convenient it more convenient to hit <return>to place the window
than to switch back to the mouse. (This only applies to the
generic XInput support).
REPORTING BUGS
Email bugs to me (Owen Taylor <otaylor@gtk.org>). Please let me know:
* The operating system and version
* The X server and version
* Details about your XInput device
It may in some cases be useful to send your '.gsumirc'. (You'll
have to 'Save Options' first). This should give a pretty complete
readout of your XInput device information.
CONFIGURING XINPUT
You'll need either to use the gxid daemon, or a sufficiently new version of
XFree86. See the XInput HOWTO at http://www.gtk.org/~otaylor/xinput/howto/
for more information about configuring your tablet..
COPYRIGHT
gsumi version 1.0
Copyright 1997-1998 Owen Taylor <otaylor@gtk.org>
based upon:
xink version 0.02
Copyright 1997 Raph Levien <raph@acm.org>
The license of gsumi is that of xink:
This code is free for commercial and non-commercial use or
redistribution, as long as the source code release, startup screen,
or product packaging includes this copyright notice.
Note however, that some portions of the user-interface code may be
covered by the GPL and/or LGPL. See the notices at the top of each
source code file for details.
______________________________________________________________________
Return to my home page
|
