| 1 |
.\" Copyright 1993, 1998 The Open Group |
| 2 |
.\" |
| 3 |
.\" Permission to use, copy, modify, distribute, and sell this software and its |
| 4 |
.\" documentation for any purpose is hereby granted without fee, provided that |
| 5 |
.\" the above copyright notice appear in all copies and that both that |
| 6 |
.\" copyright notice and this permission notice appear in supporting |
| 7 |
.\" documentation. |
| 8 |
.\" |
| 9 |
.\" The above copyright notice and this permission notice shall be included |
| 10 |
.\" in all copies or substantial portions of the Software. |
| 11 |
.\" |
| 12 |
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
| 13 |
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
| 14 |
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
| 15 |
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR |
| 16 |
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, |
| 17 |
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
| 18 |
.\" OTHER DEALINGS IN THE SOFTWARE. |
| 19 |
.\" |
| 20 |
.\" Except as contained in this notice, the name of The Open Group shall |
| 21 |
.\" not be used in advertising or otherwise to promote the sale, use or |
| 22 |
.\" other dealings in this Software without prior written authorization |
| 23 |
.\" from The Open Group. |
| 24 |
.\" |
| 25 |
.\" |
| 26 |
.TH BITMAP 1 "bitmap 1.1.0" "X Version 11" |
| 27 |
.SH NAME |
| 28 |
bitmap, bmtoa, atobm \- bitmap editor and converter utilities for the X Window System |
| 29 |
.SH SYNOPSIS |
| 30 |
.B bitmap |
| 31 |
[ |
| 32 |
.I \-options |
| 33 |
\&.\|.\|. ] [ |
| 34 |
.I filename |
| 35 |
] [ |
| 36 |
.I basename |
| 37 |
] |
| 38 |
.sp |
| 39 |
.B bmtoa |
| 40 |
[ |
| 41 |
.B \-chars |
| 42 |
\&.\|.\|. ] [ |
| 43 |
.I filename |
| 44 |
] |
| 45 |
.sp |
| 46 |
.B atobm |
| 47 |
[ |
| 48 |
.B \-chars |
| 49 |
.I cc |
| 50 |
] [ |
| 51 |
.B \-name |
| 52 |
.I variable |
| 53 |
] [ |
| 54 |
.B \-xhot |
| 55 |
.I number |
| 56 |
] [ |
| 57 |
.B \-yhot |
| 58 |
.I number |
| 59 |
] [ |
| 60 |
.I filename |
| 61 |
] |
| 62 |
.SH DESCRIPTION |
| 63 |
The \fIbitmap\fP program is a rudimentary tool for creating or editing |
| 64 |
rectangular images made up of 1's and 0's. Bitmaps are used in X for |
| 65 |
defining clipping regions, cursor shapes, icon shapes, and tile and |
| 66 |
stipple patterns. |
| 67 |
.PP |
| 68 |
The \fIbmtoa\fP and \fIatobm\fP filters convert \fIbitmap\fP files (FILE |
| 69 |
FORMAT) to and from ASCII strings. They are most commonly used to |
| 70 |
quickly print out bitmaps and to generate versions for including in text. |
| 71 |
.SH COMMAND LINE OPTIONS |
| 72 |
\fIBitmap\fP supports the standard X Toolkit command line arguments |
| 73 |
(see \fIX\fP(7)). The following additional arguments are supported as well. |
| 74 |
.TP 4 |
| 75 |
.B \-size\fI WIDTHxHEIGHT\fP |
| 76 |
Specifies size of the grid in squares. |
| 77 |
.TP 4 |
| 78 |
.B \-sw\fI dimension\fP |
| 79 |
Specifies the width of squares in pixels. |
| 80 |
.TP 4 |
| 81 |
.B \-sh\fI dimension\fP |
| 82 |
Specifies the height of squares in pixels. |
| 83 |
.TP 4 |
| 84 |
.B \-gt\fI dimension\fP |
| 85 |
Grid tolerance. If the square dimensions fall below the specified |
| 86 |
value, grid will be automatically turned off. |
| 87 |
.TP 4 |
| 88 |
.B \-grid, +grid |
| 89 |
Turns on or off the grid lines. |
| 90 |
.TP 4 |
| 91 |
.B \-axes, +axes |
| 92 |
Turns on or off the major axes. |
| 93 |
.TP 4 |
| 94 |
.B \-dashed, +dashed |
| 95 |
Turns on or off dashing for the frame and grid lines. |
| 96 |
.TP 4 |
| 97 |
.B \-stippled, +stippled |
| 98 |
Turns on or off stippling of highlighted squares. |
| 99 |
.TP 4 |
| 100 |
.B \-proportional, +proportional |
| 101 |
Turns proportional mode on or off. If proportional mode is on, |
| 102 |
square width is equal to square height. If proportional mode is |
| 103 |
off,\fI bitmap\fP will use the smaller square dimension, if they |
| 104 |
were initially different. |
| 105 |
.TP 4 |
| 106 |
.B \-dashes\fI filename\fP |
| 107 |
Specifies the bitmap to be used as a stipple for dashing. |
| 108 |
.TP 4 |
| 109 |
.B \-stipple\fI filename\fP |
| 110 |
Specifies the bitmap to be used as a stipple for highlighting. |
| 111 |
.TP 4 |
| 112 |
.B \-hl\fI color\fP |
| 113 |
Specifies the color used for highlighting. |
| 114 |
.TP 4 |
| 115 |
.B \-fr\fI color\fP |
| 116 |
Specifies the color used for the frame and grid lines. |
| 117 |
.TP 4 |
| 118 |
.B filename |
| 119 |
Specifies the bitmap to be initially loaded into the program. |
| 120 |
If the file does not exist,\fI bitmap\fP will assume it is a new file. |
| 121 |
.TP 4 |
| 122 |
.B basename |
| 123 |
Specifies the basename to be used in the C code output file. |
| 124 |
If it is different than the basename in the working file,\fI bitmap\fP |
| 125 |
will change it when saving the file. |
| 126 |
.PP |
| 127 |
\fIBmtoa\fP accepts the following option: |
| 128 |
.TP 4 |
| 129 |
.B \-chars \fIcc\fP |
| 130 |
This option specifies the pair of characters to use in the string version |
| 131 |
of the bitmap. The first character is used for 0 bits and the second character |
| 132 |
is used for 1 bits. The default is to use dashes (\-) for 0's and sharp signs |
| 133 |
(#) for 1's. |
| 134 |
.PP |
| 135 |
\fIAtobm\fP accepts the following options: |
| 136 |
.TP 4 |
| 137 |
.B \-chars \fIcc\fP |
| 138 |
This option specifies the pair of characters to use when converting string |
| 139 |
bitmaps into arrays of numbers. The first character represents a 0 bit and |
| 140 |
the second character represents a 1 bit. The default is to use dashes (\-) |
| 141 |
for 0's and sharp signs (#) for 1's. |
| 142 |
.TP 4 |
| 143 |
.B \-name \fIvariable\fP |
| 144 |
This option specifies the variable name to be used when writing out the |
| 145 |
bitmap file. The default is to use the basename of the \fIfilename\fP command |
| 146 |
line argument or leave it blank if the standard input is read. |
| 147 |
.TP 4 |
| 148 |
.B \-xhot \fInumber\fP |
| 149 |
This option specifies the X coordinate of the hotspot. Only positive values |
| 150 |
are allowed. By default, no hotspot information is included. |
| 151 |
.TP 4 |
| 152 |
.B \-yhot \fInumber\fP |
| 153 |
This option specifies the Y coordinate of the hotspot. Only positive values |
| 154 |
are allowed. By default, no hotspot information is included. |
| 155 |
.SH USAGE |
| 156 |
\fIBitmap\fP displays grid in which each square represents a single |
| 157 |
bit in the picture being edited. Actual size of the bitmap image, as |
| 158 |
it would appear normally and inverted, can be obtained by pressing\fB |
| 159 |
Meta-I\fP key. You are free to move the image popup out of the way to |
| 160 |
continue editing. Pressing the left mouse button in the popup window |
| 161 |
or\fB Meta-I\fP again will remove the real size bitmap image. |
| 162 |
.PP |
| 163 |
If the bitmap is to be used for defining a cursor, one of the squares |
| 164 |
in the images may be designated as the hot spot. This determines |
| 165 |
where the cursor is actually pointing. For cursors with sharp tips |
| 166 |
(such as arrows or fingers), this is usually at the end of the tip; |
| 167 |
for symmetric cursors (such as crosses or bullseyes), this is usually |
| 168 |
at the center. |
| 169 |
.PP |
| 170 |
Bitmaps are stored as small C code fragments suitable for including in |
| 171 |
applications. They provide an array of bits as well as symbolic |
| 172 |
constants giving the width, height, and hot spot (if specified) that |
| 173 |
may be used in creating cursors, icons, and tiles. |
| 174 |
.SH EDITING |
| 175 |
To edit a bitmap image simply click on one of the buttons with drawing |
| 176 |
commands (\fBPoint, Curve, Line, Rectangle,\fP etc.) and move the |
| 177 |
pointer into the bitmap grid window. Press one of the buttons on your |
| 178 |
mouse and the appropriate action will take place. You can either set, |
| 179 |
clear or invert the grid squares. Setting a grid square corresponds |
| 180 |
to setting a bit in the bitmap image to 1. Clearing a grid square |
| 181 |
corresponds to setting a bit in the bitmap image to 0. Inverting a |
| 182 |
grid square corresponds to changing a bit in the bitmap image from 0 to |
| 183 |
1 or 1 to 0, depending what its previous state was. The |
| 184 |
default behavior of mouse buttons is as specified below. |
| 185 |
.sp |
| 186 |
.nf |
| 187 |
MouseButton1 Set |
| 188 |
MouseButton2 Invert |
| 189 |
MouseButton3 Clear |
| 190 |
MouseButton4 Clear |
| 191 |
MouseButton5 Clear |
| 192 |
.fi |
| 193 |
.sp |
| 194 |
This default behavior can be changed by setting the button function |
| 195 |
resources. An example is provided below. |
| 196 |
.sp |
| 197 |
.nf |
| 198 |
bitmap*button1Function: Set |
| 199 |
bitmap*button2Function: Clear |
| 200 |
bitmap*button3Function: Invert |
| 201 |
etc. |
| 202 |
.fi |
| 203 |
.sp |
| 204 |
The button function applies to all drawing commands, including copying, |
| 205 |
moving and pasting, flood filling and setting the hot spot. |
| 206 |
.SH DRAWING COMMANDS |
| 207 |
Here is the list of drawing commands accessible through the |
| 208 |
buttons at the left side of the application's window. Some commands |
| 209 |
can be aborted by pressing A inside the bitmap window, allowing the |
| 210 |
user to select different guiding points where applicable. |
| 211 |
.TP 4 |
| 212 |
.B Clear |
| 213 |
This command clears all bits in the bitmap image. The grid squares |
| 214 |
will be set to the background color. Pressing C inside the bitmap |
| 215 |
window has the same effect. |
| 216 |
.TP 4 |
| 217 |
.B Set |
| 218 |
This command sets all bits in the bitmap image. The grid squares |
| 219 |
will be set to the foreground color. Pressing S inside the bitmap |
| 220 |
window has the same effect. |
| 221 |
.TP 4 |
| 222 |
.B Invert |
| 223 |
This command inverts all bits in the bitmap image. The grid squares |
| 224 |
will be inverted appropriately. Pressing I inside the bitmap window |
| 225 |
has the same effect. |
| 226 |
.TP 4 |
| 227 |
.B Mark |
| 228 |
This command is used to mark an area of the grid by dragging out a |
| 229 |
rectangular shape in the highlighting color. Once the area is marked, |
| 230 |
it can be operated on by a number of commands (see \fBUp, Down, Left, |
| 231 |
Right, Rotate, Flip, Cut,\fP etc.) Only one marked area can be present |
| 232 |
at any time. If you attempt to mark another area, the old mark will |
| 233 |
vanish. The same effect can be achieved by pressing\fB |
| 234 |
Shift-MouseButton1\fP and dragging out a rectangle in the grid window. |
| 235 |
Pressing\fB Shift-MouseButton2\fP will mark the entire grid area. |
| 236 |
.TP 4 |
| 237 |
.B Unmark |
| 238 |
This command will cause the marked area to vanish. The same effect can |
| 239 |
be achieved by pressing\fB Shift-MouseButton3\fP. |
| 240 |
.TP 4 |
| 241 |
.B Copy |
| 242 |
This command is used to copy an area of the grid from one location to |
| 243 |
another. If there is no marked grid area displayed,\fB Copy\fP |
| 244 |
behaves just like\fB Mark\fP described above. Once there is a marked |
| 245 |
grid area displayed in the highlighting color, this command has two |
| 246 |
alternative behaviors. If you click a mouse button inside the marked |
| 247 |
area, you will be able to drag the rectangle that represents the |
| 248 |
marked area to the desired location. After you release the mouse |
| 249 |
button, the area will be copied. If you click outside the marked |
| 250 |
area,\fB Copy\fP will assume that you wish to mark a different region of |
| 251 |
the bitmap image, thus it will behave like\fB Mark\fP again. |
| 252 |
.TP 4 |
| 253 |
.B Move |
| 254 |
This command is used to move an area of the grid from one location to |
| 255 |
another. Its behavior resembles the behavior of\fB Copy\fP command, |
| 256 |
except that the marked area will be moved instead of copied. |
| 257 |
.TP 4 |
| 258 |
.B Flip Horizontally |
| 259 |
This command will flip the bitmap image with respect to the horizontal axes. |
| 260 |
If a marked area of the grid is highlighted, it will operate only |
| 261 |
inside the marked area. Pressing H inside the bitmap window has the |
| 262 |
same effect. |
| 263 |
.TP 4 |
| 264 |
.B Up |
| 265 |
This command moves the bitmap image one pixel up. |
| 266 |
If a marked area of the grid is highlighted, it will operate only |
| 267 |
inside the marked area. Pressing UpArrow inside the bitmap window has the |
| 268 |
same effect. |
| 269 |
.TP 4 |
| 270 |
.B Flip Vertically |
| 271 |
This command will flip the bitmap image with respect to the vertical axes. |
| 272 |
If a marked area of the grid is highlighted, it will operate only |
| 273 |
inside the marked area. Pressing V inside the bitmap window has the |
| 274 |
same effect. |
| 275 |
.TP 4 |
| 276 |
.B Left |
| 277 |
This command moves the bitmap image one pixel to the left. |
| 278 |
If a marked area of the grid is highlighted, it will operate only |
| 279 |
inside the marked area. Pressing LeftArrow inside the bitmap window has |
| 280 |
the same effect. |
| 281 |
.TP 4 |
| 282 |
.B Fold |
| 283 |
This command will fold the bitmap image so that the opposite corners |
| 284 |
become adjacent. This is useful when creating bitmap images for |
| 285 |
tiling. Pressing F inside the bitmap window has the same effect. |
| 286 |
.TP 4 |
| 287 |
.B Right |
| 288 |
This command moves the bitmap image one pixel to the right. |
| 289 |
If a marked area of the grid is highlighted, it will operate only |
| 290 |
inside the marked area. Pressing RightArrow inside the bitmap window |
| 291 |
has the same effect. |
| 292 |
.TP 4 |
| 293 |
.B Rotate Left |
| 294 |
This command rotates the bitmap image 90 degrees to the left (counter |
| 295 |
clockwise.) |
| 296 |
If a marked area of the grid is highlighted, it will operate only |
| 297 |
inside the marked area. Pressing L inside the bitmap window has the |
| 298 |
same effect. |
| 299 |
.TP 4 |
| 300 |
.B Down |
| 301 |
This command moves the bitmap image one pixel down. |
| 302 |
If a marked area of the grid is highlighted, it will operate only |
| 303 |
inside the marked area. Pressing DownArrow inside the bitmap window |
| 304 |
has the same effect. |
| 305 |
.TP 4 |
| 306 |
.B Rotate Right |
| 307 |
This command rotates the bitmap image 90 degrees to the right (clockwise.) |
| 308 |
If a marked area of the grid is highlighted, it will operate only |
| 309 |
inside the marked area. Pressing R inside the bitmap window has the |
| 310 |
same effect. |
| 311 |
.TP 4 |
| 312 |
.B Point |
| 313 |
This command will change the grid squares underneath the mouse pointer if |
| 314 |
a mouse button is being pressed down. If you drag the mouse button |
| 315 |
continuously, the line may not be continuous, depending on the speed of your |
| 316 |
system and frequency of mouse motion events. |
| 317 |
.TP 4 |
| 318 |
.B Curve |
| 319 |
This command will change the grid squares underneath the mouse pointer if |
| 320 |
a mouse button is being pressed down. If you drag the mouse button |
| 321 |
continuously, it will make sure that the line is continuous. If your system |
| 322 |
is slow or\fI bitmap\fP receives very few mouse motion events, it might |
| 323 |
behave quite strangely. |
| 324 |
.TP 4 |
| 325 |
.B Line |
| 326 |
This command will change the grid squares in a line between two squares. |
| 327 |
Once you press a mouse button in the grid window,\fI bitmap\fP will |
| 328 |
highlight the line from the square where the mouse button was initially |
| 329 |
pressed to the square where the mouse pointer is located. By releasing the |
| 330 |
mouse button you will cause the change to take effect, and the highlighted |
| 331 |
line will disappear. |
| 332 |
.TP 4 |
| 333 |
.B Rectangle |
| 334 |
This command will change the grid squares in a rectangle between two squares. |
| 335 |
Once you press a mouse button in the grid window,\fI bitmap\fP will |
| 336 |
highlight the rectangle from the square where the mouse button was initially |
| 337 |
pressed to the square where the mouse pointer is located. By releasing the |
| 338 |
mouse button you will cause the change to take effect, and the highlighted |
| 339 |
rectangle will disappear. |
| 340 |
.TP 4 |
| 341 |
.B Filled Rectangle |
| 342 |
This command is identical to\fB Rectangle\fP, except at the end the |
| 343 |
rectangle will be filled rather than outlined. |
| 344 |
.TP 4 |
| 345 |
.B Circle |
| 346 |
This command will change the grid squares in a circle between two squares. |
| 347 |
Once you press a mouse button in the grid window,\fI bitmap\fP will |
| 348 |
highlight the circle from the square where the mouse button was initially |
| 349 |
pressed to the square where the mouse pointer is located. By releasing the |
| 350 |
mouse button you will cause the change to take effect, and the highlighted |
| 351 |
circle will disappear. |
| 352 |
.TP 4 |
| 353 |
.B Filled Circle |
| 354 |
This command is identical to\fB Circle\fP, except at the end the |
| 355 |
circle will be filled rather than outlined. |
| 356 |
.TP 4 |
| 357 |
.B Flood Fill |
| 358 |
This command will flood fill the connected area underneath the mouse |
| 359 |
pointer when you click on the desired square. Diagonally adjacent |
| 360 |
squares are not considered to be connected. |
| 361 |
.TP 4 |
| 362 |
.B Set Hot Spot |
| 363 |
This command designates one square in the grid as the hot spot if this |
| 364 |
bitmap image is to be used for defining a cursor. Pressing a mouse button |
| 365 |
in the desired square will cause a diamond shape to be displayed. |
| 366 |
.TP 4 |
| 367 |
.B Clear Hot Spot |
| 368 |
This command removes any designated hot spot from the bitmap image. |
| 369 |
.TP 4 |
| 370 |
.B Undo |
| 371 |
This command will undo the last executed command. It has depth one, |
| 372 |
that is, pressing\fB Undo\fP after\fB Undo\fP will undo itself. |
| 373 |
.SH FILE MENU |
| 374 |
The File menu commands can be accessed by pressing the File button and |
| 375 |
selecting the appropriate menu entry, or by pressing Ctrl key with |
| 376 |
another key. These commands deal with files and global bitmap |
| 377 |
parameters, such as size, basename, filename etc. |
| 378 |
.TP 4 |
| 379 |
.B New |
| 380 |
This command will clear the editing area and prompt for the name of |
| 381 |
the new file to be edited. It will not load in the new file. |
| 382 |
.TP 4 |
| 383 |
.B Load |
| 384 |
This command is used to load a new bitmap file into the bitmap editor. |
| 385 |
If the current image has not been saved, user will be asked whether to |
| 386 |
save or ignore the changes. The editor can edit only one file at a |
| 387 |
time. If you need interactive editing, run a number of editors and |
| 388 |
use cut and paste mechanism as described below. |
| 389 |
.TP 4 |
| 390 |
.B Insert |
| 391 |
This command is used to insert a bitmap file into the image |
| 392 |
being currently edited. After being prompted for the filename, |
| 393 |
click inside the grid window and drag the outlined rectangle to the |
| 394 |
location where you want to insert the new file. |
| 395 |
.TP 4 |
| 396 |
.B Save |
| 397 |
This command will save the bitmap image. It will not prompt for the |
| 398 |
filename unless it is said to be <none>. If you leave the filename |
| 399 |
undesignated or \-, the output will be piped to stdout. |
| 400 |
.TP 4 |
| 401 |
.B Save As |
| 402 |
This command will save the bitmap image after prompting for a new |
| 403 |
filename. It should be used if you want to change the filename. |
| 404 |
.TP 4 |
| 405 |
.B Resize |
| 406 |
This command is used to resize the editing area to the new number of |
| 407 |
pixels. The size should be entered in the WIDTHxHEIGHT format. The |
| 408 |
information in the image being edited will not be lost unless the new |
| 409 |
size is smaller that the current image size. The editor was not |
| 410 |
designed to edit huge files. |
| 411 |
.TP 4 |
| 412 |
.B Rescale |
| 413 |
This command is used to rescale the editing area to the new width and |
| 414 |
height. The size should be entered in the WIDTHxHEIGHT format. It will |
| 415 |
not do antialiasing and information will be lost if you rescale to the |
| 416 |
smaller sizes. Feel free to add you own algorithms for better rescaling. |
| 417 |
.TP 4 |
| 418 |
.B Filename |
| 419 |
This command is used to change the filename without changing the basename |
| 420 |
nor saving the file. If you specify \- for a filename, the output will |
| 421 |
be piped to stdout. |
| 422 |
.TP 4 |
| 423 |
.B Basename |
| 424 |
This command is used to change the basename, if a different one from |
| 425 |
the specified filename is desired. |
| 426 |
.TP 4 |
| 427 |
.B Quit |
| 428 |
This command will terminate the bitmap application. If the file was |
| 429 |
not saved, user will be prompted and asked whether to save the image |
| 430 |
or not. This command is preferred over killing the process. |
| 431 |
.SH EDIT MENU |
| 432 |
The Edit menu commands can be accessed by pressing the Edit button and |
| 433 |
selecting the appropriate menu entry, or by pressing Meta key with |
| 434 |
another key. These commands deal with editing facilities such as |
| 435 |
grid, axes, zooming, cut and paste, etc. |
| 436 |
.TP 4 |
| 437 |
.B Image |
| 438 |
This command will display the image being edited and its inverse in its |
| 439 |
actual size in a separate window. The window can be moved away to continue |
| 440 |
with editing. Pressing the left mouse button in the image window will |
| 441 |
cause it to disappear from the screen. |
| 442 |
.TP 4 |
| 443 |
.B Grid |
| 444 |
This command controls the grid in the editing area. If the grid spacing |
| 445 |
is below the value specified by gridTolerance resource (8 by default), |
| 446 |
the grid will be automatically turned off. It can be enforced by explicitly |
| 447 |
activating this command. |
| 448 |
.TP 4 |
| 449 |
.B Dashed |
| 450 |
This command controls the stipple for drawing the grid lines. The stipple |
| 451 |
specified by dashes resource can be turned on or off by activating this |
| 452 |
command. |
| 453 |
.TP 4 |
| 454 |
.B Axes |
| 455 |
This command controls the highlighting of the main axes of the image |
| 456 |
being edited. The actual lines are not part of the image. They are |
| 457 |
provided to aid user when constructing symmetrical images, or whenever |
| 458 |
having the main axes highlighted helps your editing. |
| 459 |
.TP 4 |
| 460 |
.B Stippled |
| 461 |
This command controls the stippling of the highlighted areas of the |
| 462 |
bitmap image. The stipple specified by stipple resource can be turned on |
| 463 |
or off by activating this command. |
| 464 |
.TP 4 |
| 465 |
.B Proportional |
| 466 |
This command controls the proportional mode. If the proportional mode |
| 467 |
is on, width and height of all image squares are forced to be equal, |
| 468 |
regardless of the proportions of the bitmap window. |
| 469 |
.TP 4 |
| 470 |
.B Zoom |
| 471 |
This command controls the zoom mode. If there is a marked area of the |
| 472 |
image already displayed, bitmap will automatically zoom into it. Otherwise, |
| 473 |
user will have to highlight an area to be edited in the zoom mode and |
| 474 |
bitmap will automatically switch into it. One can use all the editing |
| 475 |
commands and other utilities in the zoom mode. When you zoom out, undo |
| 476 |
command will undo the whole zoom session. |
| 477 |
.TP 4 |
| 478 |
.B Cut |
| 479 |
This commands cuts the contents of the highlighted image area into the |
| 480 |
internal cut and paste buffer. |
| 481 |
.TP 4 |
| 482 |
.B Copy |
| 483 |
This command copies the contents of the highlighted image area into the |
| 484 |
internal cut and paste buffer. |
| 485 |
.TP 4 |
| 486 |
.B Paste |
| 487 |
This command will check if there are any other bitmap applications with |
| 488 |
a highlighted image area, or if there is something in the internal cut |
| 489 |
and paste buffer and copy it to the image. To place the copied image, |
| 490 |
click in the editing window and drag the outlined image to the position |
| 491 |
where you want to place i, and then release the button. |
| 492 |
.SH CUT AND PASTE |
| 493 |
Bitmap supports two cut and paste mechanisms; the internal cut and |
| 494 |
paste and the global X selection cut and paste. The internal cut and |
| 495 |
paste is used when executing copy and move drawing commands and also |
| 496 |
cut and copy commands from the edit menu. The global X selection cut |
| 497 |
and paste is used whenever there is a highlighted area of a bitmap |
| 498 |
image displayed anywhere on the screen. To copy a part of image from |
| 499 |
another bitmap editor simply highlight the desired area by using the |
| 500 |
Mark command or pressing the shift key and dragging the area with the |
| 501 |
left mouse button. When the selected area becomes highlighted, any |
| 502 |
other applications (such as xterm, etc.) that use primary selection |
| 503 |
will discard their selection values and unhighlight the appropriate |
| 504 |
information. Now, use the Paste command for the Edit menu or control |
| 505 |
mouse button to copy the selected part of image into another (or the |
| 506 |
same) bitmap application. If you attempt to do this without a visible |
| 507 |
highlighted image area, the bitmap will fall back to the internal cut |
| 508 |
and paste buffer and paste whatever was there stored at the moment. |
| 509 |
.SH WIDGETS |
| 510 |
Below is the widget structure of the \fIbitmap\fP |
| 511 |
application. Indentation indicates hierarchical structure. The |
| 512 |
widget class name is given first, followed by the widget instance |
| 513 |
name. All widgets except the bitmap widget are from the standard |
| 514 |
Athena widget set. |
| 515 |
.sp |
| 516 |
.nf |
| 517 |
Bitmap bitmap |
| 518 |
TransientShell image |
| 519 |
Box box |
| 520 |
Label normalImage |
| 521 |
Label invertedImage |
| 522 |
TransientShell input |
| 523 |
Dialog dialog |
| 524 |
Command okay |
| 525 |
Command cancel |
| 526 |
TransientShell error |
| 527 |
Dialog dialog |
| 528 |
Command abort |
| 529 |
Command retry |
| 530 |
TransientShell qsave |
| 531 |
Dialog dialog |
| 532 |
Command yes |
| 533 |
Command no |
| 534 |
Command cancel |
| 535 |
Paned parent |
| 536 |
Form formy |
| 537 |
MenuButton fileButton |
| 538 |
SimpleMenu fileMenu |
| 539 |
SmeBSB new |
| 540 |
SmeBSB load |
| 541 |
SmeBSB insert |
| 542 |
SmeBSB save |
| 543 |
SmeBSB saveAs |
| 544 |
SmeBSB resize |
| 545 |
SmeBSB rescale |
| 546 |
SmeBSB filename |
| 547 |
SmeBSB basename |
| 548 |
SmeLine line |
| 549 |
SmeBSB quit |
| 550 |
MenuButton editButton |
| 551 |
SimpleMenu editMenu |
| 552 |
SmeBSB image |
| 553 |
SmeBSB grid |
| 554 |
SmeBSB dashed |
| 555 |
SmeBSB axes |
| 556 |
SmeBSB stippled |
| 557 |
SmeBSB proportional |
| 558 |
SmeBSB zoom |
| 559 |
SmeLine line |
| 560 |
SmeBSB cut |
| 561 |
SmeBSB copy |
| 562 |
SmeBSB paste |
| 563 |
Label status |
| 564 |
Pane pane |
| 565 |
Bitmap bitmap |
| 566 |
Form form |
| 567 |
Command clear |
| 568 |
Command set |
| 569 |
Command invert |
| 570 |
Toggle mark |
| 571 |
Command unmark |
| 572 |
Toggle copy |
| 573 |
Toggle move |
| 574 |
Command flipHoriz |
| 575 |
Command up |
| 576 |
Command flipVert |
| 577 |
Command left |
| 578 |
Command fold |
| 579 |
Command right |
| 580 |
Command rotateLeft |
| 581 |
Command down |
| 582 |
Command rotateRight |
| 583 |
Toggle point |
| 584 |
Toggle curve |
| 585 |
Toggle line |
| 586 |
Toggle rectangle |
| 587 |
Toggle filledRectangle |
| 588 |
Toggle circle |
| 589 |
Toggle filledCircle |
| 590 |
Toggle floodFill |
| 591 |
Toggle setHotSpot |
| 592 |
Command clearHotSpot |
| 593 |
Command undo |
| 594 |
.fi |
| 595 |
.SH COLORS |
| 596 |
If you would like bitmap to be viewable in color, include the following |
| 597 |
in the #ifdef COLOR section of the file you read with xrdb: |
| 598 |
.sp 1 |
| 599 |
*customization: \-color |
| 600 |
.sp 1 |
| 601 |
.br |
| 602 |
This will cause bitmap to pick up the colors in the app-defaults color |
| 603 |
customization file: |
| 604 |
.sp 1 |
| 605 |
/etc/X11/app-defaults/Bitmap-color |
| 606 |
.sp 1 |
| 607 |
.fi |
| 608 |
.SH BITMAP WIDGET |
| 609 |
Bitmap widget is a stand-alone widget for editing raster images. It |
| 610 |
is not designed to edit large images, although it may be used in that |
| 611 |
purpose as well. It can be freely incorporated with other |
| 612 |
applications and used as a standard editing tool. The following are |
| 613 |
the resources provided by the bitmap widget. |
| 614 |
.sp |
| 615 |
.TS |
| 616 |
lb lb |
| 617 |
l l. |
| 618 |
Bitmap Widget |
| 619 |
|
| 620 |
Header file Bitmap.h |
| 621 |
Class bitmapWidgetClass |
| 622 |
Class Name Bitmap |
| 623 |
Superclass Bitmap |
| 624 |
.TE |
| 625 |
|
| 626 |
All the Simple Widget resources plus .\|.\|. |
| 627 |
|
| 628 |
.TS |
| 629 |
lb lb lb lb lb |
| 630 |
l l l l l. |
| 631 |
Name Class Type Default Value |
| 632 |
foreground Foreground Pixel XtDefaultForeground |
| 633 |
highlight Highlight Pixel XtDefaultForeground |
| 634 |
framing Framing Pixel XtDefaultForeground |
| 635 |
gridTolerance GridTolerance Dimension 8 |
| 636 |
size Size String 32x32 |
| 637 |
dashed Dashed Boolean True |
| 638 |
grid Grid Boolean True |
| 639 |
stippled Stippled Boolean True |
| 640 |
proportional Proportional Boolean True |
| 641 |
axes Axes Boolean False |
| 642 |
squareWidth SquareWidth Dimension 16 |
| 643 |
squareHeight SquareHeight Dimension 16 |
| 644 |
margin Margin Dimension 16 |
| 645 |
xHot XHot Position NotSet (\-1) |
| 646 |
yHot YHot Position NotSet (\-1) |
| 647 |
button1Function Button1Function DrawingFunction Set |
| 648 |
button2Function Button2Function DrawingFunction Invert |
| 649 |
button3Function Button3Function DrawingFunction Clear |
| 650 |
button4Function Button4Function DrawingFunction Invert |
| 651 |
button5Function Button5Function DrawingFunction Invert |
| 652 |
filename Filename String None ("") |
| 653 |
basename Basename String None ("") |
| 654 |
.TE |
| 655 |
|
| 656 |
.SH AUTHOR |
| 657 |
Davor Matic, MIT X Consortium |