1xpaint(1) General Commands Manual xpaint(1)
2
6 xpaint - Simple Paint program
7
9 xpaint [ -size WIDTHxHEIGHT ] [ -winsize WIDTHxHEIGHT ]
10 [ -zoom VALUE ] -8 | -12 | -24 [ -visual VISUAL ] [ -dpi DPI ]
11 [ -canvas ] [ -fullmenu ] [ -simplemenu ] [ -nomenubar ]
12 [ -screenshot ] [ -nowarn ] [ -astext ] [ -tooltips ] [ -notooltips ]
13 [ -undo VALUE ] [ -operation NUMBER ] [ -filter FILE ] [ -proc FILE ]
14 [ -rcfile FILE ] [ -msgfile FILE ] [ -helpfile FILE ] [ -sharedir DIR ]
15 [ -encoding 0/8/16 ] [ -menufont FONT ] [ -textfont FONT ]
16 [ -lang LANGUAGE ] [ -twistcolor VALUE ] [ -hilitcolor VALUE ]
17 [ /o ] [ /c ] [ /l ] FILENAMES ...
18
20 XPaint is a color image editing tool which features most standard paint
21 program options, as well as advanced features such as image processing
22 algorithms. It allows for the editing of multiple images simultane‐
23 ously and supports various formats, including PPM, XBM, TIFF, JPEG,
24 etc.
25 The functionality of XPaint is divided into a toolbox area for select‐
27 ing the current paint operation and paint windows for modifying/creat‐
28 ing images. Each paint window has access to its own color palette and
29 set of patterns, although the paint operation in use is globally
30 selected for all windows.
31 XPaint runs on a variety of displays. It should be noted that saving
33 images will adapt them to the current display type (i.e. a color image
34 loaded on a greyscale screen will be saved as a grey image).
35 There is also an extensive on-line help system available.
37
39 By default all images given on the command line are listed in the
40 browser of preselected files, but only the first one will be displayed.
41 The /o switch (resp. /c, /l) indicates that the next images will be
42 opened in a graphical canvas (resp. in the clipboard, resp. again
43 listed in the file browser).
44 In addition to being able to specify image files to open, the following
46 options are available on the command line:
47 -size wxh Default width and height for new paint canvas being
49 opened.
50 -winsize wxh
52 Default width and height for new canvas window being
53 opened.
54 -zoom z Default zoom value of image being opened. Reduction can
56 be obtained by specifying for example :3 or -3 which
57 yields reduction factor 1/3. Only non zero integers and
58 inverses of integers are allowed.
59 -8 Use an 8 bit PseudoColor visual.
61 -12 Use a 12 bit PseudoColor visual.
63 -24 Use a 24 bit TrueColor visual.
65 -visual VISUAL
67 Use VISUAL instead of the default visual. See also the
68 section VISUAL FORMAT below for the list of possible
69 visual types.
70 -dpi DPI Use DPI as dpi (dot per inch) value for vector format
72 images such as PS, PDF, SVG, and TeX, LaTeX documents.
73 Default is 300. The option has no effect for bitmap
74 images.
75 -lang LANGUAGE
77 Use LANGUAGE instead of the default language set by the
78 environment.
79 -encoding 0/8/16
81 Use UTF8, or one of the usual earliers 8bit locales (or
82 one of the rare 16bit locales). Default is 0, i.e. UTF8.
83 -menufont FONT
85 Use FONT in the menu fonts. This should be specified
86 according to the fontconfig library specifications.
87 Default is Liberation-10:matrix=0.85 0 0 0.9 , that is
88 Liberation font with a suitable matrix scaling.
89 -textfont FONT
91 Use FONT as default text font. This should be specified
92 according to the fontconfig library specifications.
93 Default is Times-18 , that is Times at 18pt.
94 -twistcolor VALUE
96 Use an hexadecimal color value #PQRSTU in order to indi‐
97 cate insensitive items in the menus through a color
98 twist - if # is replaced with | (resp. &, ^) the result‐
99 ing value is an OR (resp. AND, XOR) of the specified
100 normal color with the given hexadecimal value. When
101 #PQRSTU is replaced by ~PQ, the option sets a trans‐
102 parency level instead.
103 -hilitcolor VALUE
105 Use VALUE to modify background color for hilighted
106 items. Use an hexadecimal value #PQRSTU which is either
107 close to #000000 or close to #ffffff for best results.
108 -sharedir DIR
110 Use DIR instead of the default share directory (e.g.
111 /usr/share/xpaint).
112 -rcfile FILE
114 Load FILE instead of the default RC file specified at
115 compile time. See also the section RC FILE FORMAT below.
116 -msgfile FILE
118 Load FILE instead of the default message file specified
119 in the app-defaults file (if any). The directory is rel‐
120 ative to the share directory, unless FILE starts with a
121 slash or a dot character.
122 -helpfile FILE
124 Load FILE instead of the default help file specified in
125 the app-defaults file (if any). The directory is rela‐
126 tive to the share directory, unless FILE starts with a
127 slash or a dot character.
128 -canvas Popup an empty canvas on startup.
130 -fullmenu This controls whether the floating canvas popup shows
132 the whole menu from the canvas menubar.
133 -simplemenu
135 This controls whether the floating canvas popup just
136 shows the edit commands.
137 -nomenubar
139 Do not show menu bar on top of canvas windows.
140 -screenshot
142 Operate xpaint in screenshot mode from start-up.
143 -operation NUMBER
145 Start with operation <NUMBER> set in tool panel.
146 -undo NUMBER
148 Set undo memory limit to <NUMBER> (default is 1 - only
149 one undo !)
150 -filter FILE
152 Define filter at start-up by using <FILE> as C-script.
153 -proc FILE
155 Define and execute procedure at start-up by using <FILE>
156 as C-script.
157 -nowarn Do not emit warnings about possible data loss due to
159 different depth of display and image.
160 -astext Try to load as text those files which fail to be
162 detected as a proper image format.
163 -tooltips Enable tooltips for certain buttons.
165 -notooltips
167 Disable tooltips.
168 -help Give a summary of the available options.
170
172 The toolbox window is displayed when XPaint is started. The toolbox is
173 used to select an operation which can then be applied to any image area
174 presented (painting window, fat bits, pattern editor, etc.). The win‐
175 dow has a selection of painting operations (as icons) and several pull
176 down menus.
177
179 The painting window holds a canvas area for painting the displayed
180 image, menus for performing operations on this image, and primary and
181 secondary color/pattern palettes along with buttons for adding to
182 these.
183
186 The display visual to use may be specified using the -visual option.
187 Choices for the argument are: TrueColor, PseudoColor, DirectColor,
188 StaticColor, StaticGray, GrayScale, or the decimal visual number (from
189 xdpyinfo). Examples:
190 -visual TrueColor
192 -visual GrayScale
194 -visual PseudoColor
196 -visual 47
198 Alternatively, -8, -12, and -24 are also acceptable for specifying
200 pseudo8, pseudo12, and truecolor24 respectively.
201
204 The RC file can be used to customize the color/pattern palettes. If a
205 system-wide RC file is specified with the -rcFile option, that file is
206 read first; otherwise, the defaults specified at compile time are
207 loaded. Then, the file .XPaintrc is searched for first in the user's
208 home directory and then in the current directory. Any settings speci‐
209 fied here are appended to the one in the system-wide RC file.
210 Any time a new canvas is created, the .XPaintrc file is read again if
212 it has changed.
213 The RC file can contain any of the following entries, in any order:
215 # or
218 ! at the start of a line initiates a comment. The rest of
220 the line is ignored.
221 solid color
223 where color is a color in standard X11 format (eg.
224 GoldenRod1, #a2b5cd - see also X(1)) adds a solid color
225 to the palette.
226 pattern BeginData bitmap EndData
228 where bitmap is a bitmap specification in XBM or XPM
229 format, adds a fill pattern to the palette.
230 Note that there must be a newline after BeginData, and
232 that EndData must appear on a line by itself.
233 pattern filename
236 where filename is a file containing a bitmap in XBM or
237 XPM format, also adds a pattern to the palette.
238 The squares in the palette have a default size of 24 by 24 pixels. This
240 can be changed by setting the XPaint.patternsize resource to a number
241 between 4 and 64.
242
246 The original author is David Koblas, koblas@netcom.com. Around 1992,
247 he wrote this : I am interested in how this program is used, if you
248 find any bugs, I'll fix them; if you notice any rough spots, or think
249 of some way in which it could be better, feel free to drop me a mes‐
250 sage.
251 Torsten Martinsen, torsten@danbbs.dk, has taken maintenance from 1996
253 to 2000 approximately, from version 2.2 to version 2.6.2.
254 Jean-Pierre Demailly, demailly@fourier.ujf-grenoble.fr, who started
256 maintaining Xpaint around 1999, is to blame for any (mis)features added
257 in version 2.5.8 and in the following releases.
258 Many people, too numerous to mention, have contributed to the develop‐
260 ment of XPaint. See ChangeLog in the source distribution for details.
261 XPAINT_RELEASE xpaint(1)