--- ../../Ver2.3/source/touchup.man Fri Jun 17 00:25:36 1988
***************
*** 1,4 ****
! .TH Touchup 1 "26 March 1988"
.SH NAME
touchup \- a bitmap graphics editor for Sun raster files
.SH SYNOPSIS
--- 1,4 ----
! .TH TOUCHUP 1 "4 June 1988"
.SH NAME
touchup \- a bitmap graphics editor for Sun raster files
.SH SYNOPSIS
***************
*** 34,40 ****
will require less memory. The use of this
option will make the color version much more
usable, by freeing up a large amount of the memory.
-
.SH COMMANDS
.LP
To edit a bitmap, type `\fBtouchup\fP'.
--- 34,39 ----
***************
*** 74,80 ****
.IP "\fBSave:standard format\fP" 10
When the save cycle is set to this mode the current image
will be saved out in the standard Sun raster file format.
! .IP "\fBSave:compress\fP" 10
When the save cycle is set to this mode the current image
will be saved out in the Sun raster file
BYTE_ENCODED format. This will often compress the file to one half
--- 73,79 ----
.IP "\fBSave:standard format\fP" 10
When the save cycle is set to this mode the current image
will be saved out in the standard Sun raster file format.
! .IP "\fBSave:Byte_Encoded\fP" 10
When the save cycle is set to this mode the current image
will be saved out in the Sun raster file
BYTE_ENCODED format. This will often compress the file to one half
***************
*** 90,102 ****
When Grid is set to some value other that "none" every bitmap operation
will be forced to the closest grid point. The number after Grid is the number of
pixels between each grid point. The actual grid is not visible.
.IP "\fB(undo)\fP"
! When this button pressed the last operation effecting the drawing area will be removed.
.IP "\fB(view)\fP"
When this button is pressed a window will be displayed containing
one of two possible images, depending on the "view" cycle.
.IP "\fBview:man page\fP"
! This will set the view to the manual page entry for Touchup, so that when
the "view" button is pressed, a window containing the manual page
will be displayed.
.IP "\fBview:Cut/Paste\fP"
--- 89,116 ----
When Grid is set to some value other that "none" every bitmap operation
will be forced to the closest grid point. The number after Grid is the number of
pixels between each grid point. The actual grid is not visible.
+ .IP "\fBBitmap OP: default\fP"
+ The BITMAP OP setting determines what boolean operation is to be performed
+ between the drawing primitive and the destination bitmap. The possible
+ boolean operations are default, which uses default settings for each
+ command, XOR which does a exclusive-or (invert), AND which will do
+ a AND between the bits in the drawing area and the ones you are drawing,
+ OR which will just set bits in the drawing area but not rest any bits,
+ and SRC, which will just copy the source drawing directly on to the
+ drawing area.
+ For example,
+ if you wanted to place white text in to a black region of the drawing area.
+ You would first set BITMAP OP to XOR (exlusive or) and do the normal
+ commands to place text in the drawing area.
.IP "\fB(undo)\fP"
! When this button pressed the last operation effecting the drawing area will be removed. If this button is pressed again, the last operation effecting the drawing area will be redisplayed.
.IP "\fB(view)\fP"
When this button is pressed a window will be displayed containing
one of two possible images, depending on the "view" cycle.
.IP "\fBview:man page\fP"
! This will set the view to the manual page entry for
! .IR Touchup ,
! so that when
the "view" button is pressed, a window containing the manual page
will be displayed.
.IP "\fBview:Cut/Paste\fP"
***************
*** 104,112 ****
the "view" button is pressed, a window with current Cut/Paste buffer
will be displayed.
.IP "\fBview:Touchup info\fP"
! This will set the view to the copyright notice for touchup, so that when
the "view" button is pressed, a window with the copyright notice
will appear.
.IP "\fBBorders:Yes\fP"
This cycle determines is borders are drawn on filled reactangles
and filled polygons.
--- 118,138 ----
the "view" button is pressed, a window with current Cut/Paste buffer
will be displayed.
.IP "\fBview:Touchup info\fP"
! This will set the view to the copyright notice for
! .IR Touchup ,
! so that when
the "view" button is pressed, a window with the copyright notice
will appear.
+ .IP "\fB(resize)\fP"
+ When this button is pressed the current value of the "height" and "width"
+ fields will be used to resize the drawing area. For example if you want to
+ change the drawing area to a space of 512 by 512 pixels, you would simple
+ select the "height" field and type in 512 and then select the "width" field
+ and type 512 then press the "resize" button.
+ .IP "\fBHeight: xxx\fP"
+ This field displays the current height of the drawing area in pixels.
+ .IP "\fBWidth: xxx\fP"
+ This field displays the current width of the drawing area in pixels.
.IP "\fBBorders:Yes\fP"
This cycle determines is borders are drawn on filled reactangles
and filled polygons.
***************
*** 117,122 ****
--- 143,157 ----
This is the string that is copied to the bitmap when the TEXT command is used.
.IP "\fBfonts:ABC\fP"
This cycle determines the font for the text when the TEXT command is used.
+ .IP "\fBlasso clear:X\fP"
+ If this option is turned on (it turned on by default),
+ then when a region is selected
+ with the LASSO it will first copy the region to the Cut/Paste
+ buffer and then it will clear the selected region. If you place the
+ mouse on top of the box after "lasso clear" and press the LEFT mouse
+ button you can toggle this
+ option on and off. When this option is turned off the region that
+ selected by LASSO is not cleared.
.IP "\fBMessages\fP"
The bottom line of this window is a message subwindow, which displays
messages, prompts, and warnings.
***************
*** 140,149 ****
mouse button.
.IP "\fBTEXT\fP" 10
First move to the Text string field in the topmost window and type in the
! text that you wish to place on the bitmap. Then use the SELECT POINT mode
! to select a point within the drawing area. Once both of these two things are
! done press the TEXT command icon with "ABC" on it, and the current
! text string will be placed on to the bitmap in the currently selected font.
.IP "\fBMAGNIFY\fP" 10
First use the SELECT POINT mode to select a point within the drawing area that
you wish to look at in detail. Then press the command icon for MAGNIFY
--- 175,185 ----
mouse button.
.IP "\fBTEXT\fP" 10
First move to the Text string field in the topmost window and type in the
! text that you wish to place on the bitmap. Then press the TEXT command icon
! with "ABC" on it, move the cursor to the drawing and hold down the
! RIGHT mouse button. You can then drag the text to the desired location
! on the drawing area, release the RIGHT button when you want to place a copy
! of the text on to the bitmap.
.IP "\fBMAGNIFY\fP" 10
First use the SELECT POINT mode to select a point within the drawing area that
you wish to look at in detail. Then press the command icon for MAGNIFY
***************
*** 227,233 ****
and then release the LEFT mouse button.
.IP "\fBOVAL\fP"
Like \fBCIRCLE\fP except draws a oval.
-
.IP "\fBPOLYGON\fP"
Once this command is selected, move to the drawing area and press the LEFT mouse
button when the cursor is at the first vertex of the polygon that
--- 263,268 ----
***************
*** 257,267 ****
.IP "\fBCOPY\fP"
This command will place a copy of the currently selected region into the
Cut/Paste buffer.
! .IP "\fBPASTE\fP"
! First use the SELECT POINT command to select the upper right hand corner
! of where you wish to place the Cut/Paste buffer. Then press the PASTE
! command icon and the contents of the current Cut/Paste buffer will be copied
! to the drawing area.
.IP "\fBMOVE\fP"
First use either COPY, CUT, or Load:Cut/Paste buffer to put an image into
the current Cut/Paste buffer. Once the MOVE command has been selected,
--- 292,306 ----
.IP "\fBCOPY\fP"
This command will place a copy of the currently selected region into the
Cut/Paste buffer.
! .IP "\fBSCALE\fP"
! First use either COPY, CUT, or Load:Cut/Paste buffer to put an image into
! the current Cut/Paste buffer. Then press SELECT REGION so that you will
! in the correct mode. Now hold down the LEFT mouse button and select
! the destination region for the Cut/Paste buffer. If the size of the
! destination region is different from the size of the original image
! then the image will be SCALED to the fix into the destination area.
! In this way the SCALE command can be used to enlarge, shrink, and stretch
! images.
.IP "\fBMOVE\fP"
First use either COPY, CUT, or Load:Cut/Paste buffer to put an image into
the current Cut/Paste buffer. Once the MOVE command has been selected,
***************
*** 269,278 ****
--- 308,328 ----
As long as the RIGHT mouse button is held down, you can position the image
where you like. Then let go of the RIGHT mouse button to place a copy of
the image on the drawing area.
+ NOTE: If you are using the MOVE command with a color image you will
+ probabilly want to set the "Bitmap OP" to "SRC" so that the colors are
+ not messed up when the Cut/Paste buffer is copied onto the bitmap.
.IP "\fBCUT\fP"
This command will place a copy of the currently selected region into the
Cut/Paste buffer and then it will fill the selected region with the
currently selected pattern.
+ .IP "\fBPASTE\fP"
+ First use the SELECT POINT command to select the upper right hand corner
+ of where you wish to place the Cut/Paste buffer. Then press the PASTE
+ command icon and the contents of the current Cut/Paste buffer will be copied
+ to the drawing area.
+ NOTE: If you are using the PASTE command with a color image you will
+ probabilly want to set the "Bitmap OP" to "SRC" so that the colors are
+ not messed up when the Cut/Paste buffer is copied onto the bitmap.
.IP "5)" 5
The last subwindow is the drawing area, which is in the center of the main
window.
***************
*** 282,304 ****
Save a image out to a file and use the following Unix command to
dump the image to a full page picture on an Apple Laser Writer or any
other PostScript laser printer, where
! file_name is the file name of an image created in Touchup.
!
.LP
When the picture is wider than it is high use the following command:
! % pssun -s 8 10.5 -r file_name | lpr -Plw
!
!
.LP
When the picture is higher than it is wide use this command:
! % pssun -s 8 10.5 file_name | lpr -Plw
!
.LP
When the picture is part of a document use this command:
! % pssun -S 6 -l 1.5 3 file_name | lpr -Plw
.LP
Images can also to sent to a IMPRESS laser printers with a command
similar to the following, where "/u5/sr/local/bin/imPf2" is the location
--- 332,351 ----
Save a image out to a file and use the following Unix command to
dump the image to a full page picture on an Apple Laser Writer or any
other PostScript laser printer, where
! file_name is the file name of an image created in
! .IR Touchup .
.LP
When the picture is wider than it is high use the following command:
! % pssun -s 8 10.5 -r file_name | lpr -Plw
.LP
When the picture is higher than it is wide use this command:
! % pssun -s 8 10.5 file_name | lpr -Plw
.LP
When the picture is part of a document use this command:
! % pssun -S 6 -l 1.5 3 file_name | lpr -Plw
.LP
Images can also to sent to a IMPRESS laser printers with a command
similar to the following, where "/u5/sr/local/bin/imPf2" is the location
***************
*** 320,336 ****
.IP "\fBHow do I merge two different pictures in to one picture ???\fP" 5
.LP
! When booting up Touchup the default drawing area is 1152 x 900,
which is the full screen size of the Sun graphics screen. When
you load a new picture
the drawing area is restricted to the size of the picture that you loaded.
! What you need to do is start up Touchup and load the first picture
into the Cut/Paste buffer by changing the cycle next to the load
button from "Load: Entire image" to "Load: Cut/Paste buffer" and then
press the load button. The file will then be in the cut/paste
buffer and you can PASTE it or MOVE it to where ever you like.
Then load the second picture into the Cut/Paste buffer and PASTE that
! picture where ever you like.
.IP "\fBHow do I make part of a picture into an icon ???\fP" 5
--- 367,387 ----
.IP "\fBHow do I merge two different pictures in to one picture ???\fP" 5
.LP
! When booting up
! .IR Touchup ,
! the default drawing area is 1152 x 900,
which is the full screen size of the Sun graphics screen. When
you load a new picture
the drawing area is restricted to the size of the picture that you loaded.
! What you need to do is start up
! .I Touchup
! and load the first picture
into the Cut/Paste buffer by changing the cycle next to the load
button from "Load: Entire image" to "Load: Cut/Paste buffer" and then
press the load button. The file will then be in the cut/paste
buffer and you can PASTE it or MOVE it to where ever you like.
Then load the second picture into the Cut/Paste buffer and PASTE that
! picture whereever you like.
.IP "\fBHow do I make part of a picture into an icon ???\fP" 5
***************
*** 338,347 ****
.LP
Use a program such as the "The Portable Bitmap Toolkit" by Jef
Poskanzer(jef@lbl-rtsg.arpa)
! This can be ftped from zap.mit.edu, I also have a copy
rolled out on tape if you do not have access to zap.mit.edu.
.IP "\fBHow do I convert other image format to Sun rasterfile format ???\fP" 5
.IP "\fBHow do I convert Sun rasterfile format to other image formats ???\fP" 5
--- 389,414 ----
.LP
Use a program such as the "The Portable Bitmap Toolkit" by Jef
Poskanzer(jef@lbl-rtsg.arpa)
! This can be
! .IR ftp ed
! from zap.mit.edu, I also have a copy
rolled out on tape if you do not have access to zap.mit.edu.
+ .IP "\fBHow do I make my own paint or brush patterns ???\fP" 5
+
+ .LP
+ First find a pattern that you want to change, they are in
+ standard icon format files names 'patternXX.icon'. Then load the pattern
+ file into iconedit and make any modifications (NOTE: the paint patterns
+ only use the upper lefthand quarter of the drawing space in iconedit).
+ After you have changed the pattern file, just type 'touch pattern.c ;
+ strip_icon32x32 ; make' to recompile
+ .IR Touchup .
+ You can do the same thing to change the brush patterns, the brushes
+ are in the files 'brushX.icon'.
+
+
.IP "\fBHow do I convert other image format to Sun rasterfile format ???\fP" 5
.IP "\fBHow do I convert Sun rasterfile format to other image formats ???\fP" 5
***************
*** 348,358 ****
.LP
Use a program such as the "The Portable Bitmap Toolkit" by Jef
Poskanzer(jef@lbl-rtsg.arpa)
! This can be ftped from zap.mit.edu, I also have a copy
rolled out on tape if you do not have access to zap.mit.edu.
! .IP "\fBWhat does SAVE COMPRESSED mean ???\fP" 5
.LP
This means that the image will be saved out in the Sun rasterfile
--- 415,427 ----
.LP
Use a program such as the "The Portable Bitmap Toolkit" by Jef
Poskanzer(jef@lbl-rtsg.arpa)
! This can be
! .IR ftp ed
! from zap.mit.edu, I also have a copy
rolled out on tape if you do not have access to zap.mit.edu.
! .IP "\fBWhat does SAVE Byte_Encoded mean ???\fP" 5
.LP
This means that the image will be saved out in the Sun rasterfile
***************
*** 373,382 ****
.IR rasterfile (5)
.SH BUGS
.LP
! Touchup has not been totally debugged for use with color images.
.LP
If you try to FLOOD FILL an area that has a VERY complex pattern and covers
! a large area it is possible to over flow the stack and cause a core dump.
.SH Author
Ray Kreisel
Computer Science Department
--- 442,452 ----
.IR rasterfile (5)
.SH BUGS
.LP
! .I Touchup
! has not been totally debugged for use with color images.
.LP
If you try to FLOOD FILL an area that has a VERY complex pattern and covers
! a large area it is possible to overflow the stack and cause a core dump.
.SH Author
Ray Kreisel
Computer Science Department
***************
*** 383,390 ****
--- 453,464 ----
SUNY at Stony Brook
Stony Brook NY 11794
.LP
+ PLEASE send comments and bug reports to one of the following addresses:
