| <head> |
| <title>tweak(1) - Plan 9 from User Space</title> |
| <meta content="text/html; charset=utf-8" http-equiv=Content-Type> |
| </head> |
| <body bgcolor=#ffffff> |
| <table border=0 cellpadding=0 cellspacing=0 width=100%> |
| <tr height=10><td> |
| <tr><td width=20><td> |
| <tr><td width=20><td><b>TWEAK(1)</b><td align=right><b>TWEAK(1)</b> |
| <tr><td width=20><td colspan=2> |
| <br> |
| <p><font size=+1><b>NAME </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| tweak – edit image files, subfont files, face files, etc.<br> |
| |
| </table> |
| <p><font size=+1><b>SYNOPSIS </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>tweak</font></tt> [ <i>file ...</i> ]<br> |
| |
| </table> |
| <p><font size=+1><b>DESCRIPTION </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <i>Tweak</i> edits existing files holding various forms of images. To |
| create original images, start from an existing image, subfont, |
| etc. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| <i>Tweak</i> reads its argument <i>files</i> and displays the resulting images |
| in a vertical column. If the image is too wide to fit across the |
| display, it is folded much like a long line of text in an <i>rio</i> |
| window. Under each image is displayed one or two lines of text |
| presenting its parameters. The first line shows the image’s <tt><font size=+1>depth</font></tt>, |
| the number of bits per pixel; <tt><font size=+1>r</font></tt>, the rectangle covered by the |
| image; and the name of the <tt><font size=+1>file</font></tt> from which it was read. If the |
| file is a subfont, a second line presents a hexadecimal 16-bit |
| <tt><font size=+1>offset</font></tt> to be applied to character values from the subfont (typically |
| as stored in a font file; see <a href="../man7/font.html"><i>font</i>(7)</a>); and the subfont’s <tt><font size=+1>n</font></tt>, |
| <tt><font size=+1>height</font></tt>, and <tt><font size=+1>ascent</font></tt> as defined in <a href="../man3/cachechars.html"><i>cachechars</i>(3)</a>. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| By means described below, magnified views of portions of the images |
| may be displayed. The text associated with such a view includes |
| <tt><font size=+1>mag</font></tt>, the magnification. If the view is of a single character from |
| a subfont, the second line of text shows the character’s value |
| (including the subfont’s offset) in hexadecimal and as a |
| character in <i>tweak’s</i> default font; the character’s <tt><font size=+1>x</font></tt>, <tt><font size=+1>top</font></tt>, <tt><font size=+1>bottom</font></tt>, |
| <tt><font size=+1>left</font></tt>, and <tt><font size=+1>width</font></tt> as defined in <a href="../man3/cachechars.html"><i>cachechars</i>(3)</a>; and <tt><font size=+1>iwidth</font></tt>, the physical |
| width of the image in the subfont’s image. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| There are two methods to obtain a magnified view of a character |
| from a subfont. The first is to click mouse button 1 over the |
| image of the character in the subfont. The second is to select |
| the <tt><font size=+1>char</font></tt> entry on the button 3 menu, point the resulting gunsight |
| cursor at the desired subfont and click button 3, and then type |
| at the text prompt at the bottom of the screen the character value, |
| either as a multi-digit hexadecimal number or as a single rune |
| representing the character. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| To magnify a portion of other types of image files, click button |
| 1 over the unmagnified file. The cursor will switch to a cross. |
| Still with button 1, sweep a rectangle, as in <tt><font size=+1>rio</font></tt>, that encloses |
| the portion of the image to be magnified. (If the file is 16x16 |
| or smaller, <i>tweak</i> will just magnify the entire file; no sweeping |
| is |
| necessary.) |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| Pressing buttons 1 and 2 within magnified images changes pixel |
| values. By default, button 1 sets the pixel to all zeros and button |
| 2 sets the pixel to all ones. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| Across the top of the screen is a textual display of global parameters. |
| These values, as well as many of the textual values associated |
| with the images, may be edited by clicking button 1 on the displayed |
| value and typing a new value. The values along the top of the |
| screen are:<br> |
| <tt><font size=+1>mag</font></tt> Default magnification.<br> |
| <tt><font size=+1>val(hex)<br> |
| </font></tt> |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| The value used to modify pixels within magnified images. The value |
| must be in hexadecimal, optionally preceded by a tilde for bitwise |
| negation.<br> |
| |
| </table> |
| <tt><font size=+1>but1<br> |
| but2</font></tt>The pixel value written when the corresponding button is pressed |
| over a pixel.<br> |
| <tt><font size=+1>invert−on−copy<br> |
| </font></tt> |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| Whether the pixel values are inverted when a <tt><font size=+1>copy</font></tt> operation is |
| performed. |
| <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> |
| |
| |
| </table> |
| Under button 3 is a menu holding a variety of functions. Many |
| of these functions prompt for the image upon which to act by switching |
| to a gunsight cursor; click button 3 over the selection, or click |
| a different button to cancel the action.<br> |
| <tt><font size=+1>open</font></tt>Read and display a file. The name of the file is typed to |
| the prompt on the bottom line.<br> |
| <tt><font size=+1>read</font></tt>Reread a file.<br> |
| <tt><font size=+1>write<br> |
| </font></tt> |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| Write a file.<br> |
| |
| </table> |
| <tt><font size=+1>copy</font></tt>Use the copy function, default <tt><font size=+1>S</font></tt>, to transfer a rectangle |
| of pixels from one image to another. The program prompts with |
| a cross cursor; sweep out a rectangle in one image or just click |
| button 3 to select the whole image. The program will leave that |
| rectangle in place and attach another one to the cursor. Move |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| that rectangle to the desired place in any image and click button |
| 3, or another button to cancel the action.<br> |
| |
| </table> |
| <tt><font size=+1>char</font></tt>As described above, open a magnified view of a character image |
| in a subfont.<br> |
| <tt><font size=+1>pixels<br> |
| </font></tt> |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| Report the coordinate and value of individual pixels indicated |
| by pressing button 3. This is a mode of operation canceled by |
| pressing button 1 or 2.<br> |
| |
| </table> |
| <tt><font size=+1>close<br> |
| </font></tt> |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| Close the specified image. If the image is the unmagnified file, |
| also close any magnified views of that file.<br> |
| |
| </table> |
| <tt><font size=+1>exit</font></tt>Quit <i>tweak</i>. The program will complain once about modified |
| but unwritten files.<br> |
| |
| </table> |
| <p><font size=+1><b>SOURCE </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <tt><font size=+1>/usr/local/plan9/src/cmd/draw/tweak.c<br> |
| </font></tt> |
| </table> |
| <p><font size=+1><b>SEE ALSO </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| <a href="../man3/cachechars.html"><i>cachechars</i>(3)</a>, <a href="../man7/image.html"><i>image</i>(7)</a>, <a href="../man7/font.html"><i>font</i>(7)</a><br> |
| |
| </table> |
| <p><font size=+1><b>BUGS </b></font><br> |
| |
| <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> |
| |
| For a program written to adjust width tables in fonts, <i>tweak</i> has |
| been pushed unreasonably far.<br> |
| |
| </table> |
| |
| <td width=20> |
| <tr height=20><td> |
| </table> |
| <!-- TRAILER --> |
| <table border=0 cellpadding=0 cellspacing=0 width=100%> |
| <tr height=15><td width=10><td><td width=10> |
| <tr><td><td> |
| <center> |
| <a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a> |
| </center> |
| </table> |
| <!-- TRAILER --> |
| </body></html> |
