github.com/kaydxh/golang@v0.0.131/pkg/gocv/cgo/third_path/graphics-magick/share/doc/GraphicsMagick/www/display.html (about)

     1  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
     2    "http://www.w3.org/TR/html4/loose.dtd">
     3  <html>
     4  <head>
     5  	<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=us-ascii">
     6  	<title>GraphicsMagick GM Utility</title>
     7  	<style type=text/css>
     8  	<!--
     9  		@page { size: 8.5in 11in }
    10  		TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
    11  		P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
    12  		A:link { color: #00B04F }
    13  		A:visited { color: #007B37 }
    14  	-->
    15  	</style>
    16  
    17  </head>
    18  <body LANG="en-US" TEXT="#000000" LINK="#00B04F" VLINK="#007B37" BGCOLOR="#ffffff">
    19  <a name="top"></a>
    20  <table border=0 cellpadding=10 cellspacing=0 style="margin-top:-17px" width="100%"><tr><td>
    21  <br>&nbsp;<br>
    22  <table BORDER=0 WIDTH="100%"> 
    23  <tr> 
    24  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    25  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    26  height=14 width=15><b><font face="Helvetica, Arial"><font 
    27  color="#00B04F"><font size="+1">
    28  <a NAME="display"></a>gm display
    29  </font></font></font></b></td></tr></table>
    30  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    31  <tr><td width="3%"><br></td><td>
    32  <table BORDER=0 WIDTH="100%"> 
    33  <tr> 
    34  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    35  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    36  height=14 width=15><b><font face="Helvetica, Arial"><font 
    37  color="#00B04F"><font size="+1">
    38  <a NAME="disp-top"></a>NAME
    39  </font></font></font></b></td></tr></table>
    40  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    41  <tr><td width="3%"><br></td><td>
    42  <p>
    43  display - display an image on any workstation running X
    44  <br>&nbsp;<br>
    45  </td></tr></table>
    46  <table BORDER=0 WIDTH="100%"> 
    47  <tr> 
    48  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    49  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    50  height=14 width=15><b><font face="Helvetica, Arial"><font 
    51  color="#00B04F"><font size="+1">
    52  <a NAME="disp-contents"></a>Contents
    53  </font></font></font></b></td></tr></table>
    54  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    55  <tr><td width="3%"><br></td><td>
    56  <ul>
    57  <li>
    58  <a href="#disp-syno">Synopsis</a>
    59  <li>
    60  <a href="#disp-desc">Description</a>
    61  <li>
    62  <a href="#disp-exam">Examples</a>
    63  <li>
    64  <a href="#disp-opti">Options</a>
    65  <li>
    66  <a href="#disp-mous">Mouse Buttons</a>
    67  <li>
    68  <a href="#disp-comm">Command Widget</a>
    69  <li>
    70  <a href="#disp-keyb">Keyboard Accelerators</a>
    71  <li>
    72  <a href="#disp-xres">X Resources</a>
    73  <li>
    74  <a href="#disp-imlo">Image Loading</a>
    75  <li>
    76  <a href="#disp-visu">Visual Image Directory</a>
    77  <li>
    78  <a href="#disp-imcu">Image Cutting</a>
    79  <li>
    80  <a href="#disp-imco">Image Copying</a>
    81  <li>
    82  <a href="#disp-impas">Image Pasting</a>
    83  <li>
    84  <a href="#disp-imcr">Image Cropping</a>
    85  <li>
    86  <a href="#disp-imch">Image Chopping</a>
    87  <li>
    88  <a href="#disp-imro">Image Rotation</a>
    89  <li>
    90  <a href="#disp-segm">Image Segmentation</a>
    91  <li>
    92  <a href="#disp-iman">Image Annotation</a>
    93  <li>
    94  <a href="#disp-imcomp">Image Compositing</a>
    95  <li>
    96  <a href="#disp-cole">Color Editing</a>
    97  <li>
    98  <a href="#disp-matt">Matte (Transparent Channel) Editing</a>
    99  <li>
   100  <a href="#disp-imdr">Image Drawing</a>
   101  <li>
   102  <a href="#disp-regi">Region of Interest</a>
   103  <li>
   104  <a href="#disp-impa">Image Panning</a>
   105  <li>
   106  <a href="#disp-impa">User Preferences</a>
   107  </ul>
   108  </td></tr></table>
   109  <table BORDER=0 WIDTH="100%"> 
   110  <tr> 
   111  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
   112  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
   113  height=14 width=15><b><font face="Helvetica, Arial"><font 
   114  color="#00B04F"><font size="+1">
   115  <a NAME="disp-syno"></a>Synopsis
   116  </font></font></font></b></td></tr></table>
   117  <table width="94%" border="0" cellspacing="0" cellpadding="8">
   118  <tr><td width="3%"><br></td><td>
   119  <p>
   120  <strong>gm display</strong> <strong>[</strong> <em>options</em> <strong>...]</strong> <em>file</em>
   121  <strong>[</strong><em>options</em><strong>...]</strong><em>file</em>
   122  </td></tr></table>
   123  <table BORDER=0 WIDTH="100%"> 
   124  <tr> 
   125  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
   126  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
   127  height=14 width=15><b><font face="Helvetica, Arial"><font 
   128  color="#00B04F"><font size="+1">
   129  <a NAME="disp-desc"></a>Description
   130  </font></font></font></b></td></tr></table>
   131  <table width="94%" border="0" cellspacing="0" cellpadding="8">
   132  <tr><td width="3%"><br></td><td>
   133  <p>
   134  Display is a machine architecture independent
   135  image processing and display program. It can display an image on any workstation
   136  screen running an X server. <strong>Display</strong> can read and write
   137  <strong>many</strong>
   138  of the more popular image <a href="formats.html">formats</a> (e.g. <strong>JPEG</strong>,
   139  <strong>TIFF</strong>,
   140  <strong>PNM</strong>,
   141  <strong>Photo
   142  CD</strong>, etc.).
   143  <p>
   144  With <strong>display</strong>, you can perform these functions on an image:
   145  <dl>
   146  <dd><img SRC="images/ball.png" ALT="*">load an image from a file
   147  <dd><img SRC="images/ball.png" ALT="*">display the next image
   148  <dd><img SRC="images/ball.png" ALT="*">display the former image
   149  <dd><img SRC="images/ball.png" ALT="*">display a sequence of images as a slide show
   150  <dd><img SRC="images/ball.png" ALT="*">write the image to a file
   151  <dd><img SRC="images/ball.png" ALT="*">print the image to a <em>PostScript</em> printer
   152  <dd><img SRC="images/ball.png" ALT="*">delete the image file
   153  <dd><img SRC="images/ball.png" ALT="*">create a Visual Image Directory
   154  <dd><img SRC="images/ball.png" ALT="*">select the image to display by its thumbnail rather than name
   155  <dd><img SRC="images/ball.png" ALT="*">undo last image transformation
   156  <dd><img SRC="images/ball.png" ALT="*">copy a region of the image
   157  <dd><img SRC="images/ball.png" ALT="*">paste a region to the image
   158  <dd><img SRC="images/ball.png" ALT="*">restore the image to its original size
   159  <dd><img SRC="images/ball.png" ALT="*">refresh the image
   160  <dd><img SRC="images/ball.png" ALT="*">half the image size
   161  <dd><img SRC="images/ball.png" ALT="*">double the image size
   162  <dd><img SRC="images/ball.png" ALT="*">resize the image
   163  <dd><img SRC="images/ball.png" ALT="*">crop the image
   164  <dd><img SRC="images/ball.png" ALT="*">cut the image
   165  <dd><img SRC="images/ball.png" ALT="*">flop image in the horizontal direction
   166  <dd><img SRC="images/ball.png" ALT="*">flip image in the vertical direction
   167  <dd><img SRC="images/ball.png" ALT="*">rotate the image 90 degrees clockwise
   168  <dd><img SRC="images/ball.png" ALT="*">rotate the image 90 degrees counter-clockwise
   169  <dd><img SRC="images/ball.png" ALT="*">rotate the image
   170  <dd><img SRC="images/ball.png" ALT="*">shear the image
   171  <dd><img SRC="images/ball.png" ALT="*">roll the image
   172  <dd><img SRC="images/ball.png" ALT="*">trim the image edges
   173  <dd><img SRC="images/ball.png" ALT="*">invert the colors of the image
   174  <dd><img SRC="images/ball.png" ALT="*">vary the color brightness
   175  <dd><img SRC="images/ball.png" ALT="*">vary the color saturation
   176  <dd><img SRC="images/ball.png" ALT="*">vary the image hue
   177  <dd><img SRC="images/ball.png" ALT="*">gamma correct the image
   178  <dd><img SRC="images/ball.png" ALT="*">sharpen the image contrast
   179  <dd><img SRC="images/ball.png" ALT="*">dull the image contrast
   180  <dd><img SRC="images/ball.png" ALT="*">perform histogram equalization on the image
   181  <dd><img SRC="images/ball.png" ALT="*">perform histogram normalization on the image
   182  <dd><img SRC="images/ball.png" ALT="*">negate the image colors
   183  <dd><img SRC="images/ball.png" ALT="*">convert the image to grayscale
   184  <dd><img SRC="images/ball.png" ALT="*">set the maximum number of unique colors in the image
   185  <dd><img SRC="images/ball.png" ALT="*">reduce the speckles within an image
   186  <dd><img SRC="images/ball.png" ALT="*">eliminate peak noise from an image
   187  <dd><img SRC="images/ball.png" ALT="*">detect edges within the image
   188  <dd><img SRC="images/ball.png" ALT="*">emboss an image
   189  <dd><img SRC="images/ball.png" ALT="*">segment the image by color
   190  <dd><img SRC="images/ball.png" ALT="*">simulate an oil painting
   191  <dd><img SRC="images/ball.png" ALT="*">simulate a charcoal drawing
   192  <dd><img SRC="images/ball.png" ALT="*">annotate the image with text
   193  <dd><img SRC="images/ball.png" ALT="*">draw on the image
   194  <dd><img SRC="images/ball.png" ALT="*">edit an image pixel color
   195  <dd><img SRC="images/ball.png" ALT="*">edit the image matte information
   196  <dd><img SRC="images/ball.png" ALT="*">composite an image with another
   197  <dd><img SRC="images/ball.png" ALT="*">add a border to the image
   198  <dd><img SRC="images/ball.png" ALT="*">surround image with an ornamental border
   199  <dd><img SRC="images/ball.png" ALT="*">apply image processing techniques to a region of interest
   200  <dd><img SRC="images/ball.png" ALT="*">display information about the image
   201  <dd><img SRC="images/ball.png" ALT="*">zoom a portion of the image
   202  <dd><img SRC="images/ball.png" ALT="*">show a histogram of the image
   203  <dd><img SRC="images/ball.png" ALT="*">display image to background of a window
   204  <dd><img SRC="images/ball.png" ALT="*">set user preferences
   205  <dd><img SRC="images/ball.png" ALT="*">display information about this program
   206  <dd><img SRC="images/ball.png" ALT="*">discard all images and exit program
   207  <dd><img SRC="images/ball.png" ALT="*">change the level of magnification
   208  <dd><img SRC="images/ball.png" ALT="*">display images specified by a World Wide Web (WWW) uniform resource locator (URL)
   209  </dl>
   210  </td></tr></table>
   211       <p>
   212  <i><a href="#top">Back to Contents</a></i> 
   213  &nbsp;</p>
   214  <table BORDER=0 WIDTH="100%"> 
   215  <tr> 
   216  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
   217  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
   218  height=14 width=15><b><font face="Helvetica, Arial"><font 
   219  color="#00B04F"><font size="+1">
   220  <a NAME="disp-exam"></a>Examples
   221  </font></font></font></b></td></tr></table>
   222  <table width="94%" border="0" cellspacing="0" cellpadding="8">
   223  <tr><td width="3%"><br></td><td>
   224  <p>
   225  To scale an image of a cockatoo to exactly 640 pixels in width and 480
   226  pixels in height and position the window at location (200,200), use:
   227  <pre>
   228      gm display -geometry 640x480+200+200! cockatoo.miff
   229  </pre>
   230  <p>
   231  To display an image of a cockatoo without a border centered on a backdrop,
   232  use:
   233  <pre>
   234      gm display +borderwidth -backdrop cockatoo.miff
   235  </pre>
   236  <p>
   237  To tile a slate texture onto the root window, use:
   238  <pre>
   239      gm display -size 1280x1024 -window root slate.png
   240  </pre>
   241  <p>
   242  To display a visual image directory of all your JPEG images, use:
   243  <pre>
   244      gm display 'vid:*.jpg'
   245  </pre>
   246  <p>
   247  To display a MAP image that is 640 pixels in width and 480 pixels in height
   248  with 256 colors, use:
   249  <pre>
   250      gm display -size 640x480+256 cockatoo.map
   251  </pre>
   252  <p>
   253  To display an image of a cockatoo specified with a <strong>World Wide Web (WWW)</strong>
   254  uniform resource locator <strong>(URL)</strong>, use:
   255  <pre>
   256      gm display ftp://wizards.dupont.com/images/cockatoo.jpg
   257  </pre>
   258  <p>
   259  To display histogram of an image, use:
   260  <pre>
   261      gm gm convert file.jpg HISTOGRAM:- | gm display -
   262  </pre>
   263  </td></tr></table>
   264       <p>
   265  <i><a href="#top">Back to Contents</a></i> 
   266  &nbsp;</p>
   267  <table BORDER=0 WIDTH="100%"> 
   268  <tr> 
   269  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
   270  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
   271  height=14 width=15><b><font face="Helvetica, Arial"><font 
   272  color="#00B04F"><font size="+1">
   273  <a NAME="disp-opti"></a>Options
   274  </font></font></font></b></td></tr></table>
   275  <table width="94%" border="0" cellspacing="0" cellpadding="8">
   276  <tr><td width="3%"><br></td><td>
   277  <p>
   278  Options are processed in command line order. Any option you specify on
   279  the command line remains in effect until it is explicitly changed by specifying
   280  the option again with a different effect. For example to display three images,
   281  the first with 32 colors, the second with an unlimited number of colors,
   282  and the third with only 16 colors, use:
   283  <pre>
   284      gm display -colors 32 cockatoo.miff -noop duck.miff -colors 16 macaw.miff
   285  </pre>
   286  <p>
   287  <strong>Display</strong> options can appear on the command line or in your X resources
   288  file. See <em>X(1)</em>. Options on the command line supersede values specified
   289  in your X resources file.
   290  <p>
   291  For a more detailed description of each option, see
   292  Options, above.
   293  <a href="GraphicsMagick.html"><em>GraphicsMagick(1)</em></a>.
   294  <br>&nbsp;<br>
   295  <table BORDER=0 WIDTH="94%">
   296  <tr>
   297  <td width="3%"><br></td> 
   298  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   299  <img SRC="images/right_triangle_option.png"
   300  ALT=">" BORDER=0 height=14
   301  width=15><b><font face="Helvetica, Arial"
   302  ><font color="#00B04F"><font size="+1">
   303      <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i>&lt;string&gt;</i>
   304  </font></font></font></b></td></tr></table>
   305  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>
   306  <table BORDER=0 WIDTH="94%">
   307  <tr>
   308  <td width="3%"><br></td> 
   309  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   310  <img SRC="images/right_triangle_option.png"
   311  ALT=">" BORDER=0 height=14
   312  width=15><b><font face="Helvetica, Arial"
   313  ><font color="#00B04F"><font size="+1">
   314      <a href="GraphicsMagick.html#details-backdrop">-backdrop</a>
   315  </font></font></font></b></td></tr></table>
   316  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>display the image centered on a backdrop.</td></tr></table>
   317  <table BORDER=0 WIDTH="94%">
   318  <tr>
   319  <td width="3%"><br></td> 
   320  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   321  <img SRC="images/right_triangle_option.png"
   322  ALT=">" BORDER=0 height=14
   323  width=15><b><font face="Helvetica, Arial"
   324  ><font color="#00B04F"><font size="+1">
   325      <a href="GraphicsMagick.html#details-background">-background</a> <i>&lt;color&gt;</i>
   326  </font></font></font></b></td></tr></table>
   327  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the background color</td></tr></table>
   328  <table BORDER=0 WIDTH="94%">
   329  <tr>
   330  <td width="3%"><br></td> 
   331  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   332  <img SRC="images/right_triangle_option.png"
   333  ALT=">" BORDER=0 height=14
   334  width=15><b><font face="Helvetica, Arial"
   335  ><font color="#00B04F"><font size="+1">
   336      <a href="GraphicsMagick.html#details-border">-border</a> <i>&lt;width&gt;x&lt;height&gt;</i>
   337  </font></font></font></b></td></tr></table>
   338  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>surround the image with a border of color</td></tr></table>
   339  <table BORDER=0 WIDTH="94%">
   340  <tr>
   341  <td width="3%"><br></td> 
   342  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   343  <img SRC="images/right_triangle_option.png"
   344  ALT=">" BORDER=0 height=14
   345  width=15><b><font face="Helvetica, Arial"
   346  ><font color="#00B04F"><font size="+1">
   347      <a href="GraphicsMagick.html#details-bordercolor">-bordercolor</a> <i>&lt;color&gt;</i>
   348  </font></font></font></b></td></tr></table>
   349  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the border color</td></tr></table>
   350  <table BORDER=0 WIDTH="94%">
   351  <tr>
   352  <td width="3%"><br></td> 
   353  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   354  <img SRC="images/right_triangle_option.png"
   355  ALT=">" BORDER=0 height=14
   356  width=15><b><font face="Helvetica, Arial"
   357  ><font color="#00B04F"><font size="+1">
   358      -borderwidth <i>&lt;geometry&gt;</i>
   359  </font></font></font></b></td></tr></table>
   360  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the border width</td></tr></table>
   361  <table BORDER=0 WIDTH="94%">
   362  <tr>
   363  <td width="3%"><br></td> 
   364  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   365  <img SRC="images/right_triangle_option.png"
   366  ALT=">" BORDER=0 height=14
   367  width=15><b><font face="Helvetica, Arial"
   368  ><font color="#00B04F"><font size="+1">
   369      <a href="GraphicsMagick.html#details-colormap">-colormap</a> <i>&lt;type&gt;</i>
   370  </font></font></font></b></td></tr></table>
   371  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>define the colormap type</td></tr></table>
   372  <table BORDER=0 WIDTH="94%">
   373  <tr>
   374  <td width="3%"><br></td> 
   375  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   376  <img SRC="images/right_triangle_option.png"
   377  ALT=">" BORDER=0 height=14
   378  width=15><b><font face="Helvetica, Arial"
   379  ><font color="#00B04F"><font size="+1">
   380      <a href="GraphicsMagick.html#details-colors">-colors</a> <i>&lt;value&gt;</i>
   381  </font></font></font></b></td></tr></table>
   382  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>preferred number of colors in the image</td></tr></table>
   383  <table BORDER=0 WIDTH="94%">
   384  <tr>
   385  <td width="3%"><br></td> 
   386  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   387  <img SRC="images/right_triangle_option.png"
   388  ALT=">" BORDER=0 height=14
   389  width=15><b><font face="Helvetica, Arial"
   390  ><font color="#00B04F"><font size="+1">
   391      <a href="GraphicsMagick.html#details-colorspace">-colorspace</a> <i>&lt;value&gt;</i>
   392  </font></font></font></b></td></tr></table>
   393  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the type of colorspace</td></tr></table>
   394  <table BORDER=0 WIDTH="94%">
   395  <tr>
   396  <td width="3%"><br></td> 
   397  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   398  <img SRC="images/right_triangle_option.png"
   399  ALT=">" BORDER=0 height=14
   400  width=15><b><font face="Helvetica, Arial"
   401  ><font color="#00B04F"><font size="+1">
   402      <a href="GraphicsMagick.html#details-comment">-comment</a> <i>&lt;string&gt;</i>
   403  </font></font></font></b></td></tr></table>
   404  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>annotate an image with a comment</td></tr></table>
   405  <table BORDER=0 WIDTH="94%">
   406  <tr>
   407  <td width="3%"><br></td> 
   408  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   409  <img SRC="images/right_triangle_option.png"
   410  ALT=">" BORDER=0 height=14
   411  width=15><b><font face="Helvetica, Arial"
   412  ><font color="#00B04F"><font size="+1">
   413      <a href="GraphicsMagick.html#details-compress">-compress</a> <i>&lt;type&gt;</i>
   414  </font></font></font></b></td></tr></table>
   415  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the type of image compression</td></tr></table>
   416  <table BORDER=0 WIDTH="94%">
   417  <tr>
   418  <td width="3%"><br></td> 
   419  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   420  <img SRC="images/right_triangle_option.png"
   421  ALT=">" BORDER=0 height=14
   422  width=15><b><font face="Helvetica, Arial"
   423  ><font color="#00B04F"><font size="+1">
   424      <a href="GraphicsMagick.html#details-contrast">-contrast</a>
   425  </font></font></font></b></td></tr></table>
   426  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>enhance or reduce the image contrast</td></tr></table>
   427  <table BORDER=0 WIDTH="94%">
   428  <tr>
   429  <td width="3%"><br></td> 
   430  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   431  <img SRC="images/right_triangle_option.png"
   432  ALT=">" BORDER=0 height=14
   433  width=15><b><font face="Helvetica, Arial"
   434  ><font color="#00B04F"><font size="+1">
   435      <a href="GraphicsMagick.html#details-crop">-crop</a> <i>&lt;width&gt;x&lt;height&gt;</i>{<i>+-</i>}<i>&lt;x&gt;</i>{<i>+-</i>}<i>&lt;y&gt;</i>{<i>%</i>}<i></i>
   436  </font></font></font></b></td></tr></table>
   437  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>preferred size and location of the cropped image</td></tr></table>
   438  <table BORDER=0 WIDTH="94%">
   439  <tr>
   440  <td width="3%"><br></td> 
   441  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   442  <img SRC="images/right_triangle_option.png"
   443  ALT=">" BORDER=0 height=14
   444  width=15><b><font face="Helvetica, Arial"
   445  ><font color="#00B04F"><font size="+1">
   446      -debug <i>&lt;events&gt;</i>
   447  </font></font></font></b></td></tr></table>
   448  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>
   449  <table BORDER=0 WIDTH="94%">
   450  <tr>
   451  <td width="3%"><br></td> 
   452  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   453  <img SRC="images/right_triangle_option.png"
   454  ALT=">" BORDER=0 height=14
   455  width=15><b><font face="Helvetica, Arial"
   456  ><font color="#00B04F"><font size="+1">
   457      <a href="GraphicsMagick.html#details-define">-define</a> <i>&lt;key&gt;</i>{<i>=&lt;value&gt;</i>}<i>,...</i>
   458  </font></font></font></b></td></tr></table>
   459  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>
   460  <table BORDER=0 WIDTH="94%">
   461  <tr>
   462  <td width="3%"><br></td> 
   463  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   464  <img SRC="images/right_triangle_option.png"
   465  ALT=">" BORDER=0 height=14
   466  width=15><b><font face="Helvetica, Arial"
   467  ><font color="#00B04F"><font size="+1">
   468      <a href="GraphicsMagick.html#details-delay">-delay</a> <i>&lt;1/100ths of a second&gt;</i>
   469  </font></font></font></b></td></tr></table>
   470  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>display the next image after pausing</td></tr></table>
   471  <table BORDER=0 WIDTH="94%">
   472  <tr>
   473  <td width="3%"><br></td> 
   474  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   475  <img SRC="images/right_triangle_option.png"
   476  ALT=">" BORDER=0 height=14
   477  width=15><b><font face="Helvetica, Arial"
   478  ><font color="#00B04F"><font size="+1">
   479      <a href="GraphicsMagick.html#details-density">-density</a> <i>&lt;width&gt;x&lt;height&gt;</i>
   480  </font></font></font></b></td></tr></table>
   481  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>
   482  <table BORDER=0 WIDTH="94%">
   483  <tr>
   484  <td width="3%"><br></td> 
   485  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   486  <img SRC="images/right_triangle_option.png"
   487  ALT=">" BORDER=0 height=14
   488  width=15><b><font face="Helvetica, Arial"
   489  ><font color="#00B04F"><font size="+1">
   490      <a href="GraphicsMagick.html#details-depth">-depth</a> <i>&lt;value&gt;</i>
   491  </font></font></font></b></td></tr></table>
   492  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>
   493  <table BORDER=0 WIDTH="94%">
   494  <tr>
   495  <td width="3%"><br></td> 
   496  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   497  <img SRC="images/right_triangle_option.png"
   498  ALT=">" BORDER=0 height=14
   499  width=15><b><font face="Helvetica, Arial"
   500  ><font color="#00B04F"><font size="+1">
   501      -despeckle
   502  </font></font></font></b></td></tr></table>
   503  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>reduce the speckles within an image</td></tr></table>
   504  <table BORDER=0 WIDTH="94%">
   505  <tr>
   506  <td width="3%"><br></td> 
   507  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   508  <img SRC="images/right_triangle_option.png"
   509  ALT=">" BORDER=0 height=14
   510  width=15><b><font face="Helvetica, Arial"
   511  ><font color="#00B04F"><font size="+1">
   512      <a href="GraphicsMagick.html#details-display">-display</a> <i>&lt;host:display[.screen]&gt;</i>
   513  </font></font></font></b></td></tr></table>
   514  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>specifies the X server to contact</td></tr></table>
   515  <table BORDER=0 WIDTH="94%">
   516  <tr>
   517  <td width="3%"><br></td> 
   518  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   519  <img SRC="images/right_triangle_option.png"
   520  ALT=">" BORDER=0 height=14
   521  width=15><b><font face="Helvetica, Arial"
   522  ><font color="#00B04F"><font size="+1">
   523      <a href="GraphicsMagick.html#details-dispose">-dispose</a> <i>&lt;method&gt;</i>
   524  </font></font></font></b></td></tr></table>
   525  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>GIF disposal method</td></tr></table>
   526  <table BORDER=0 WIDTH="94%">
   527  <tr>
   528  <td width="3%"><br></td> 
   529  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   530  <img SRC="images/right_triangle_option.png"
   531  ALT=">" BORDER=0 height=14
   532  width=15><b><font face="Helvetica, Arial"
   533  ><font color="#00B04F"><font size="+1">
   534      <a href="GraphicsMagick.html#details-dither">-dither</a>
   535  </font></font></font></b></td></tr></table>
   536  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>apply Floyd/Steinberg error diffusion to the image</td></tr></table>
   537  <table BORDER=0 WIDTH="94%">
   538  <tr>
   539  <td width="3%"><br></td> 
   540  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   541  <img SRC="images/right_triangle_option.png"
   542  ALT=">" BORDER=0 height=14
   543  width=15><b><font face="Helvetica, Arial"
   544  ><font color="#00B04F"><font size="+1">
   545      -edge <i>&lt;radius&gt;</i>
   546  </font></font></font></b></td></tr></table>
   547  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>detect edges within an image</td></tr></table>
   548  <table BORDER=0 WIDTH="94%">
   549  <tr>
   550  <td width="3%"><br></td> 
   551  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   552  <img SRC="images/right_triangle_option.png"
   553  ALT=">" BORDER=0 height=14
   554  width=15><b><font face="Helvetica, Arial"
   555  ><font color="#00B04F"><font size="+1">
   556      <a href="GraphicsMagick.html#details-endian">-endian</a> <i>&lt;type&gt;</i>
   557  </font></font></font></b></td></tr></table>
   558  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>specify endianness (MSB, LSB, or Native) of image</td></tr></table>
   559  <table BORDER=0 WIDTH="94%">
   560  <tr>
   561  <td width="3%"><br></td> 
   562  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   563  <img SRC="images/right_triangle_option.png"
   564  ALT=">" BORDER=0 height=14
   565  width=15><b><font face="Helvetica, Arial"
   566  ><font color="#00B04F"><font size="+1">
   567      -enhance
   568  </font></font></font></b></td></tr></table>
   569  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>apply a digital filter to enhance a noisy image</td></tr></table>
   570  <table BORDER=0 WIDTH="94%">
   571  <tr>
   572  <td width="3%"><br></td> 
   573  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   574  <img SRC="images/right_triangle_option.png"
   575  ALT=">" BORDER=0 height=14
   576  width=15><b><font face="Helvetica, Arial"
   577  ><font color="#00B04F"><font size="+1">
   578      <a href="GraphicsMagick.html#details-filter">-filter</a> <i>&lt;type&gt;</i>
   579  </font></font></font></b></td></tr></table>
   580  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>use this type of filter when resizing an image</td></tr></table>
   581  <table BORDER=0 WIDTH="94%">
   582  <tr>
   583  <td width="3%"><br></td> 
   584  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   585  <img SRC="images/right_triangle_option.png"
   586  ALT=">" BORDER=0 height=14
   587  width=15><b><font face="Helvetica, Arial"
   588  ><font color="#00B04F"><font size="+1">
   589      <a href="GraphicsMagick.html#details-flip">-flip</a>
   590  </font></font></font></b></td></tr></table>
   591  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>
   592  <table BORDER=0 WIDTH="94%">
   593  <tr>
   594  <td width="3%"><br></td> 
   595  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   596  <img SRC="images/right_triangle_option.png"
   597  ALT=">" BORDER=0 height=14
   598  width=15><b><font face="Helvetica, Arial"
   599  ><font color="#00B04F"><font size="+1">
   600      <a href="GraphicsMagick.html#details-flop">-flop</a>
   601  </font></font></font></b></td></tr></table>
   602  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>create a "mirror image"</td></tr></table>
   603  <table BORDER=0 WIDTH="94%">
   604  <tr>
   605  <td width="3%"><br></td> 
   606  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   607  <img SRC="images/right_triangle_option.png"
   608  ALT=">" BORDER=0 height=14
   609  width=15><b><font face="Helvetica, Arial"
   610  ><font color="#00B04F"><font size="+1">
   611      <a href="GraphicsMagick.html#details-font">-font</a> <i>&lt;name&gt;</i>
   612  </font></font></font></b></td></tr></table>
   613  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>use this font when annotating the image with text</td></tr></table>
   614  <table BORDER=0 WIDTH="94%">
   615  <tr>
   616  <td width="3%"><br></td> 
   617  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   618  <img SRC="images/right_triangle_option.png"
   619  ALT=">" BORDER=0 height=14
   620  width=15><b><font face="Helvetica, Arial"
   621  ><font color="#00B04F"><font size="+1">
   622      <a href="GraphicsMagick.html#details-foreground">-foreground</a> <i>&lt;color&gt;</i>
   623  </font></font></font></b></td></tr></table>
   624  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>define the foreground color</td></tr></table>
   625  <table BORDER=0 WIDTH="94%">
   626  <tr>
   627  <td width="3%"><br></td> 
   628  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   629  <img SRC="images/right_triangle_option.png"
   630  ALT=">" BORDER=0 height=14
   631  width=15><b><font face="Helvetica, Arial"
   632  ><font color="#00B04F"><font size="+1">
   633      <a href="GraphicsMagick.html#details-frame">-frame</a> <i>&lt;width&gt;x&lt;height&gt;+&lt;outer bevel width&gt;+&lt;inner bevel width&gt;</i>
   634  </font></font></font></b></td></tr></table>
   635  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>surround the image with an ornamental border</td></tr></table>
   636  <table BORDER=0 WIDTH="94%">
   637  <tr>
   638  <td width="3%"><br></td> 
   639  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   640  <img SRC="images/right_triangle_option.png"
   641  ALT=">" BORDER=0 height=14
   642  width=15><b><font face="Helvetica, Arial"
   643  ><font color="#00B04F"><font size="+1">
   644      <a href="GraphicsMagick.html#details-gamma">-gamma</a> <i>&lt;value&gt;</i>
   645  </font></font></font></b></td></tr></table>
   646  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>level of gamma correction</td></tr></table>
   647  <table BORDER=0 WIDTH="94%">
   648  <tr>
   649  <td width="3%"><br></td> 
   650  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   651  <img SRC="images/right_triangle_option.png"
   652  ALT=">" BORDER=0 height=14
   653  width=15><b><font face="Helvetica, Arial"
   654  ><font color="#00B04F"><font size="+1">
   655      <a href="GraphicsMagick.html#details-geometry">-geometry</a> <i>&lt;width&gt;x&lt;height&gt;</i>{<i>+-</i>}<i>&lt;x&gt;</i>{<i>+-</i>}<i>&lt;y&gt;</i>{<i>%</i>}<i></i>{<i>@</i>}<i></i>{<i>!</i>}<i></i>{<i>^</i>}<i></i>{<i>&lt;</i>}<i></i>{<i>&gt;</i>}<i></i>
   656  </font></font></font></b></td></tr></table>
   657  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>Specify dimension, offset, and resize options.</td></tr></table>
   658  <table BORDER=0 WIDTH="94%">
   659  <tr>
   660  <td width="3%"><br></td> 
   661  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   662  <img SRC="images/right_triangle_option.png"
   663  ALT=">" BORDER=0 height=14
   664  width=15><b><font face="Helvetica, Arial"
   665  ><font color="#00B04F"><font size="+1">
   666      -help
   667  </font></font></font></b></td></tr></table>
   668  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>
   669  <table BORDER=0 WIDTH="94%">
   670  <tr>
   671  <td width="3%"><br></td> 
   672  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   673  <img SRC="images/right_triangle_option.png"
   674  ALT=">" BORDER=0 height=14
   675  width=15><b><font face="Helvetica, Arial"
   676  ><font color="#00B04F"><font size="+1">
   677      <a href="GraphicsMagick.html#details-iconGeometry">-iconGeometry</a> <i>&lt;geometry&gt;</i>
   678  </font></font></font></b></td></tr></table>
   679  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>specify the icon geometry</td></tr></table>
   680  <table BORDER=0 WIDTH="94%">
   681  <tr>
   682  <td width="3%"><br></td> 
   683  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   684  <img SRC="images/right_triangle_option.png"
   685  ALT=">" BORDER=0 height=14
   686  width=15><b><font face="Helvetica, Arial"
   687  ><font color="#00B04F"><font size="+1">
   688      -iconic
   689  </font></font></font></b></td></tr></table>
   690  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>iconic animation</td></tr></table>
   691  <table BORDER=0 WIDTH="94%">
   692  <tr>
   693  <td width="3%"><br></td> 
   694  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   695  <img SRC="images/right_triangle_option.png"
   696  ALT=">" BORDER=0 height=14
   697  width=15><b><font face="Helvetica, Arial"
   698  ><font color="#00B04F"><font size="+1">
   699      -immutable
   700  </font></font></font></b></td></tr></table>
   701  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>make image immutable</td></tr></table>
   702  <table BORDER=0 WIDTH="94%">
   703  <tr>
   704  <td width="3%"><br></td> 
   705  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   706  <img SRC="images/right_triangle_option.png"
   707  ALT=">" BORDER=0 height=14
   708  width=15><b><font face="Helvetica, Arial"
   709  ><font color="#00B04F"><font size="+1">
   710      <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i>&lt;type&gt;</i>
   711  </font></font></font></b></td></tr></table>
   712  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>
   713  <table BORDER=0 WIDTH="94%">
   714  <tr>
   715  <td width="3%"><br></td> 
   716  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   717  <img SRC="images/right_triangle_option.png"
   718  ALT=">" BORDER=0 height=14
   719  width=15><b><font face="Helvetica, Arial"
   720  ><font color="#00B04F"><font size="+1">
   721      <a href="GraphicsMagick.html#details-label">-label</a> <i>&lt;name&gt;</i>
   722  </font></font></font></b></td></tr></table>
   723  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>assign a label to an image</td></tr></table>
   724  <table BORDER=0 WIDTH="94%">
   725  <tr>
   726  <td width="3%"><br></td> 
   727  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   728  <img SRC="images/right_triangle_option.png"
   729  ALT=">" BORDER=0 height=14
   730  width=15><b><font face="Helvetica, Arial"
   731  ><font color="#00B04F"><font size="+1">
   732      <a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
   733  </font></font></font></b></td></tr></table>
   734  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
   735  <table BORDER=0 WIDTH="94%">
   736  <tr>
   737  <td width="3%"><br></td> 
   738  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   739  <img SRC="images/right_triangle_option.png"
   740  ALT=">" BORDER=0 height=14
   741  width=15><b><font face="Helvetica, Arial"
   742  ><font color="#00B04F"><font size="+1">
   743      <a href="GraphicsMagick.html#details-log">-log</a> <i>&lt;string&gt;</i>
   744  </font></font></font></b></td></tr></table>
   745  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>
   746  <table BORDER=0 WIDTH="94%">
   747  <tr>
   748  <td width="3%"><br></td> 
   749  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   750  <img SRC="images/right_triangle_option.png"
   751  ALT=">" BORDER=0 height=14
   752  width=15><b><font face="Helvetica, Arial"
   753  ><font color="#00B04F"><font size="+1">
   754      -magnify <i>&lt;factor&gt;</i>
   755  </font></font></font></b></td></tr></table>
   756  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>magnify the image</td></tr></table>
   757  <table BORDER=0 WIDTH="94%">
   758  <tr>
   759  <td width="3%"><br></td> 
   760  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   761  <img SRC="images/right_triangle_option.png"
   762  ALT=">" BORDER=0 height=14
   763  width=15><b><font face="Helvetica, Arial"
   764  ><font color="#00B04F"><font size="+1">
   765      <a href="GraphicsMagick.html#details-map">-map</a> <i>&lt;type&gt;</i>
   766  </font></font></font></b></td></tr></table>
   767  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>display image using this type.</td></tr></table>
   768  <table BORDER=0 WIDTH="94%">
   769  <tr>
   770  <td width="3%"><br></td> 
   771  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   772  <img SRC="images/right_triangle_option.png"
   773  ALT=">" BORDER=0 height=14
   774  width=15><b><font face="Helvetica, Arial"
   775  ><font color="#00B04F"><font size="+1">
   776      <a href="GraphicsMagick.html#details-matte">-matte</a>
   777  </font></font></font></b></td></tr></table>
   778  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>store matte channel if the image has one</td></tr></table>
   779  <table BORDER=0 WIDTH="94%">
   780  <tr>
   781  <td width="3%"><br></td> 
   782  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   783  <img SRC="images/right_triangle_option.png"
   784  ALT=">" BORDER=0 height=14
   785  width=15><b><font face="Helvetica, Arial"
   786  ><font color="#00B04F"><font size="+1">
   787      <a href="GraphicsMagick.html#details-mattecolor">-mattecolor</a> <i>&lt;color&gt;</i>
   788  </font></font></font></b></td></tr></table>
   789  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>specify the color to be used with the <strong>-frame</strong> option</td></tr></table>
   790  <table BORDER=0 WIDTH="94%">
   791  <tr>
   792  <td width="3%"><br></td> 
   793  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   794  <img SRC="images/right_triangle_option.png"
   795  ALT=">" BORDER=0 height=14
   796  width=15><b><font face="Helvetica, Arial"
   797  ><font color="#00B04F"><font size="+1">
   798      -monitor
   799  </font></font></font></b></td></tr></table>
   800  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>show progress indication</td></tr></table>
   801  <table BORDER=0 WIDTH="94%">
   802  <tr>
   803  <td width="3%"><br></td> 
   804  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   805  <img SRC="images/right_triangle_option.png"
   806  ALT=">" BORDER=0 height=14
   807  width=15><b><font face="Helvetica, Arial"
   808  ><font color="#00B04F"><font size="+1">
   809      -monochrome
   810  </font></font></font></b></td></tr></table>
   811  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>transform the image to black and white</td></tr></table>
   812  <table BORDER=0 WIDTH="94%">
   813  <tr>
   814  <td width="3%"><br></td> 
   815  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   816  <img SRC="images/right_triangle_option.png"
   817  ALT=">" BORDER=0 height=14
   818  width=15><b><font face="Helvetica, Arial"
   819  ><font color="#00B04F"><font size="+1">
   820      -name
   821  </font></font></font></b></td></tr></table>
   822  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>name an image</td></tr></table>
   823  <table BORDER=0 WIDTH="94%">
   824  <tr>
   825  <td width="3%"><br></td> 
   826  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   827  <img SRC="images/right_triangle_option.png"
   828  ALT=">" BORDER=0 height=14
   829  width=15><b><font face="Helvetica, Arial"
   830  ><font color="#00B04F"><font size="+1">
   831      <a href="GraphicsMagick.html#details-negate">-negate</a>
   832  </font></font></font></b></td></tr></table>
   833  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>replace every pixel with its complementary color</td></tr></table>
   834  <table BORDER=0 WIDTH="94%">
   835  <tr>
   836  <td width="3%"><br></td> 
   837  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   838  <img SRC="images/right_triangle_option.png"
   839  ALT=">" BORDER=0 height=14
   840  width=15><b><font face="Helvetica, Arial"
   841  ><font color="#00B04F"><font size="+1">
   842      <a href="GraphicsMagick.html#details-noop">-noop</a>
   843  </font></font></font></b></td></tr></table>
   844  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>NOOP (no option)</td></tr></table>
   845  <table BORDER=0 WIDTH="94%">
   846  <tr>
   847  <td width="3%"><br></td> 
   848  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   849  <img SRC="images/right_triangle_option.png"
   850  ALT=">" BORDER=0 height=14
   851  width=15><b><font face="Helvetica, Arial"
   852  ><font color="#00B04F"><font size="+1">
   853      <a href="GraphicsMagick.html#details-page">-page</a> <i>&lt;width&gt;x&lt;height&gt;</i>{<i>+-</i>}<i>&lt;x&gt;</i>{<i>+-</i>}<i>&lt;y&gt;</i>{<i>%</i>}<i></i>{<i>!</i>}<i></i>{<i>&lt;</i>}<i></i>{<i>&gt;</i>}<i></i>
   854  </font></font></font></b></td></tr></table>
   855  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>size and location of an image canvas</td></tr></table>
   856  <table BORDER=0 WIDTH="94%">
   857  <tr>
   858  <td width="3%"><br></td> 
   859  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   860  <img SRC="images/right_triangle_option.png"
   861  ALT=">" BORDER=0 height=14
   862  width=15><b><font face="Helvetica, Arial"
   863  ><font color="#00B04F"><font size="+1">
   864      <a href="GraphicsMagick.html#details+progress">+progress</a>
   865  </font></font></font></b></td></tr></table>
   866  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>disable progress monitor and busy cursor</td></tr></table>
   867  <table BORDER=0 WIDTH="94%">
   868  <tr>
   869  <td width="3%"><br></td> 
   870  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   871  <img SRC="images/right_triangle_option.png"
   872  ALT=">" BORDER=0 height=14
   873  width=15><b><font face="Helvetica, Arial"
   874  ><font color="#00B04F"><font size="+1">
   875      <a href="GraphicsMagick.html#details-quality">-quality</a> <i>&lt;value&gt;</i>
   876  </font></font></font></b></td></tr></table>
   877  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>JPEG/MIFF/PNG/TIFF compression level</td></tr></table>
   878  <table BORDER=0 WIDTH="94%">
   879  <tr>
   880  <td width="3%"><br></td> 
   881  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   882  <img SRC="images/right_triangle_option.png"
   883  ALT=">" BORDER=0 height=14
   884  width=15><b><font face="Helvetica, Arial"
   885  ><font color="#00B04F"><font size="+1">
   886      <a href="GraphicsMagick.html#details-raise">-raise</a> <i>&lt;width&gt;x&lt;height&gt;</i>
   887  </font></font></font></b></td></tr></table>
   888  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>lighten or darken image edges</td></tr></table>
   889  <table BORDER=0 WIDTH="94%">
   890  <tr>
   891  <td width="3%"><br></td> 
   892  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   893  <img SRC="images/right_triangle_option.png"
   894  ALT=">" BORDER=0 height=14
   895  width=15><b><font face="Helvetica, Arial"
   896  ><font color="#00B04F"><font size="+1">
   897      <a href="GraphicsMagick.html#details-remote">-remote</a>
   898  </font></font></font></b></td></tr></table>
   899  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>perform a X11 remote operation</td></tr></table>
   900  <table BORDER=0 WIDTH="94%">
   901  <tr>
   902  <td width="3%"><br></td> 
   903  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   904  <img SRC="images/right_triangle_option.png"
   905  ALT=">" BORDER=0 height=14
   906  width=15><b><font face="Helvetica, Arial"
   907  ><font color="#00B04F"><font size="+1">
   908      <a href="GraphicsMagick.html#details-roll">-roll</a> <i></i>{<i>+-</i>}<i>&lt;x&gt;</i>{<i>+-</i>}<i>&lt;y&gt;</i>
   909  </font></font></font></b></td></tr></table>
   910  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>roll an image vertically or horizontally</td></tr></table>
   911  <table BORDER=0 WIDTH="94%">
   912  <tr>
   913  <td width="3%"><br></td> 
   914  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   915  <img SRC="images/right_triangle_option.png"
   916  ALT=">" BORDER=0 height=14
   917  width=15><b><font face="Helvetica, Arial"
   918  ><font color="#00B04F"><font size="+1">
   919      <a href="GraphicsMagick.html#details-rotate">-rotate</a> <i>&lt;degrees&gt;</i>{<i>&lt;</i>}<i></i>{<i>&gt;</i>}<i></i>
   920  </font></font></font></b></td></tr></table>
   921  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>rotate the image</td></tr></table>
   922  <table BORDER=0 WIDTH="94%">
   923  <tr>
   924  <td width="3%"><br></td> 
   925  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   926  <img SRC="images/right_triangle_option.png"
   927  ALT=">" BORDER=0 height=14
   928  width=15><b><font face="Helvetica, Arial"
   929  ><font color="#00B04F"><font size="+1">
   930      <a href="GraphicsMagick.html#details-sample">-sample</a> <i>&lt;geometry&gt;</i>
   931  </font></font></font></b></td></tr></table>
   932  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>scale image using pixel sampling</td></tr></table>
   933  <table BORDER=0 WIDTH="94%">
   934  <tr>
   935  <td width="3%"><br></td> 
   936  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   937  <img SRC="images/right_triangle_option.png"
   938  ALT=">" BORDER=0 height=14
   939  width=15><b><font face="Helvetica, Arial"
   940  ><font color="#00B04F"><font size="+1">
   941      <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i>&lt;horizontal_factor&gt;x&lt;vertical_factor&gt;</i>
   942  </font></font></font></b></td></tr></table>
   943  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table>
   944  <table BORDER=0 WIDTH="94%">
   945  <tr>
   946  <td width="3%"><br></td> 
   947  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   948  <img SRC="images/right_triangle_option.png"
   949  ALT=">" BORDER=0 height=14
   950  width=15><b><font face="Helvetica, Arial"
   951  ><font color="#00B04F"><font size="+1">
   952      <a href="GraphicsMagick.html#details-scenes">-scenes</a> <i>&lt;value-value&gt;</i>
   953  </font></font></font></b></td></tr></table>
   954  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>range of image scene numbers to read</td></tr></table>
   955  <table BORDER=0 WIDTH="94%">
   956  <tr>
   957  <td width="3%"><br></td> 
   958  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   959  <img SRC="images/right_triangle_option.png"
   960  ALT=">" BORDER=0 height=14
   961  width=15><b><font face="Helvetica, Arial"
   962  ><font color="#00B04F"><font size="+1">
   963      <a href="GraphicsMagick.html#details-set">-set</a> <i>&lt;attribute&gt; &lt;value&gt;</i>
   964  </font></font></font></b></td></tr></table>
   965  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>set an image attribute</td></tr></table>
   966  <table BORDER=0 WIDTH="94%">
   967  <tr>
   968  <td width="3%"><br></td> 
   969  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   970  <img SRC="images/right_triangle_option.png"
   971  ALT=">" BORDER=0 height=14
   972  width=15><b><font face="Helvetica, Arial"
   973  ><font color="#00B04F"><font size="+1">
   974      <a href="GraphicsMagick.html#details+set">+set</a> <i>&lt;attribute&gt;</i>
   975  </font></font></font></b></td></tr></table>
   976  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>unset an image attribute</td></tr></table>
   977  <table BORDER=0 WIDTH="94%">
   978  <tr>
   979  <td width="3%"><br></td> 
   980  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   981  <img SRC="images/right_triangle_option.png"
   982  ALT=">" BORDER=0 height=14
   983  width=15><b><font face="Helvetica, Arial"
   984  ><font color="#00B04F"><font size="+1">
   985      <a href="GraphicsMagick.html#details-segment">-segment</a> <i>&lt;cluster threshold&gt;x&lt;smoothing threshold&gt;</i>
   986  </font></font></font></b></td></tr></table>
   987  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>segment an image</td></tr></table>
   988  <table BORDER=0 WIDTH="94%">
   989  <tr>
   990  <td width="3%"><br></td> 
   991  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   992  <img SRC="images/right_triangle_option.png"
   993  ALT=">" BORDER=0 height=14
   994  width=15><b><font face="Helvetica, Arial"
   995  ><font color="#00B04F"><font size="+1">
   996      <a href="GraphicsMagick.html#details-shared-memory">-shared-memory</a>
   997  </font></font></font></b></td></tr></table>
   998  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>use shared memory</td></tr></table>
   999  <table BORDER=0 WIDTH="94%">
  1000  <tr>
  1001  <td width="3%"><br></td> 
  1002  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1003  <img SRC="images/right_triangle_option.png"
  1004  ALT=">" BORDER=0 height=14
  1005  width=15><b><font face="Helvetica, Arial"
  1006  ><font color="#00B04F"><font size="+1">
  1007      <a href="GraphicsMagick.html#details-sharpen">-sharpen</a> <i>&lt;radius&gt;</i>{<i>x&lt;sigma&gt;</i>}<i></i>
  1008  </font></font></font></b></td></tr></table>
  1009  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>sharpen the image</td></tr></table>
  1010  <table BORDER=0 WIDTH="94%">
  1011  <tr>
  1012  <td width="3%"><br></td> 
  1013  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1014  <img SRC="images/right_triangle_option.png"
  1015  ALT=">" BORDER=0 height=14
  1016  width=15><b><font face="Helvetica, Arial"
  1017  ><font color="#00B04F"><font size="+1">
  1018      <a href="GraphicsMagick.html#details-size">-size</a> <i>&lt;width&gt;x&lt;height&gt;</i>{<i>+offset</i>}<i></i>
  1019  </font></font></font></b></td></tr></table>
  1020  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>
  1021  <table BORDER=0 WIDTH="94%">
  1022  <tr>
  1023  <td width="3%"><br></td> 
  1024  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1025  <img SRC="images/right_triangle_option.png"
  1026  ALT=">" BORDER=0 height=14
  1027  width=15><b><font face="Helvetica, Arial"
  1028  ><font color="#00B04F"><font size="+1">
  1029      <a href="GraphicsMagick.html#details-text-font">-text-font</a> <i>&lt;name&gt;</i>
  1030  </font></font></font></b></td></tr></table>
  1031  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>font for writing fixed-width text</td></tr></table>
  1032  <table BORDER=0 WIDTH="94%">
  1033  <tr>
  1034  <td width="3%"><br></td> 
  1035  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1036  <img SRC="images/right_triangle_option.png"
  1037  ALT=">" BORDER=0 height=14
  1038  width=15><b><font face="Helvetica, Arial"
  1039  ><font color="#00B04F"><font size="+1">
  1040      -texture <i>&lt;filename&gt;</i>
  1041  </font></font></font></b></td></tr></table>
  1042  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>name of texture to tile onto the image background</td></tr></table>
  1043  <table BORDER=0 WIDTH="94%">
  1044  <tr>
  1045  <td width="3%"><br></td> 
  1046  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1047  <img SRC="images/right_triangle_option.png"
  1048  ALT=">" BORDER=0 height=14
  1049  width=15><b><font face="Helvetica, Arial"
  1050  ><font color="#00B04F"><font size="+1">
  1051      <a href="GraphicsMagick.html#details-title">-title</a> <i>&lt;string&gt;</i>
  1052  </font></font></font></b></td></tr></table>
  1053  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>assign title to displayed image [<em>animate, display, montage</em>]</td></tr></table>
  1054  <table BORDER=0 WIDTH="94%">
  1055  <tr>
  1056  <td width="3%"><br></td> 
  1057  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1058  <img SRC="images/right_triangle_option.png"
  1059  ALT=">" BORDER=0 height=14
  1060  width=15><b><font face="Helvetica, Arial"
  1061  ><font color="#00B04F"><font size="+1">
  1062      <a href="GraphicsMagick.html#details-treedepth">-treedepth</a> <i>&lt;value&gt;</i>
  1063  </font></font></font></b></td></tr></table>
  1064  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>tree depth for the color reduction algorithm</td></tr></table>
  1065  <table BORDER=0 WIDTH="94%">
  1066  <tr>
  1067  <td width="3%"><br></td> 
  1068  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1069  <img SRC="images/right_triangle_option.png"
  1070  ALT=">" BORDER=0 height=14
  1071  width=15><b><font face="Helvetica, Arial"
  1072  ><font color="#00B04F"><font size="+1">
  1073      <a href="GraphicsMagick.html#details-trim">-trim</a>
  1074  </font></font></font></b></td></tr></table>
  1075  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>trim an image</td></tr></table>
  1076  <table BORDER=0 WIDTH="94%">
  1077  <tr>
  1078  <td width="3%"><br></td> 
  1079  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1080  <img SRC="images/right_triangle_option.png"
  1081  ALT=">" BORDER=0 height=14
  1082  width=15><b><font face="Helvetica, Arial"
  1083  ><font color="#00B04F"><font size="+1">
  1084      <a href="GraphicsMagick.html#details-type">-type</a> <i>&lt;type&gt;</i>
  1085  </font></font></font></b></td></tr></table>
  1086  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the image type</td></tr></table>
  1087  <table BORDER=0 WIDTH="94%">
  1088  <tr>
  1089  <td width="3%"><br></td> 
  1090  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1091  <img SRC="images/right_triangle_option.png"
  1092  ALT=">" BORDER=0 height=14
  1093  width=15><b><font face="Helvetica, Arial"
  1094  ><font color="#00B04F"><font size="+1">
  1095      <a href="GraphicsMagick.html#details-update">-update</a> <i>&lt;seconds&gt;</i>
  1096  </font></font></font></b></td></tr></table>
  1097  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1098  detect when image file is modified and redisplay.</td></tr></table>
  1099  <table BORDER=0 WIDTH="94%">
  1100  <tr>
  1101  <td width="3%"><br></td> 
  1102  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1103  <img SRC="images/right_triangle_option.png"
  1104  ALT=">" BORDER=0 height=14
  1105  width=15><b><font face="Helvetica, Arial"
  1106  ><font color="#00B04F"><font size="+1">
  1107      -use-pixmap
  1108  </font></font></font></b></td></tr></table>
  1109  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>use the pixmap</td></tr></table>
  1110  <table BORDER=0 WIDTH="94%">
  1111  <tr>
  1112  <td width="3%"><br></td> 
  1113  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1114  <img SRC="images/right_triangle_option.png"
  1115  ALT=">" BORDER=0 height=14
  1116  width=15><b><font face="Helvetica, Arial"
  1117  ><font color="#00B04F"><font size="+1">
  1118      <a href="GraphicsMagick.html#details-verbose">-verbose</a>
  1119  </font></font></font></b></td></tr></table>
  1120  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>
  1121  <table BORDER=0 WIDTH="94%">
  1122  <tr>
  1123  <td width="3%"><br></td> 
  1124  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1125  <img SRC="images/right_triangle_option.png"
  1126  ALT=">" BORDER=0 height=14
  1127  width=15><b><font face="Helvetica, Arial"
  1128  ><font color="#00B04F"><font size="+1">
  1129      <a href="GraphicsMagick.html#details-version">-version</a>
  1130  </font></font></font></b></td></tr></table>
  1131  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>
  1132  <table BORDER=0 WIDTH="94%">
  1133  <tr>
  1134  <td width="3%"><br></td> 
  1135  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1136  <img SRC="images/right_triangle_option.png"
  1137  ALT=">" BORDER=0 height=14
  1138  width=15><b><font face="Helvetica, Arial"
  1139  ><font color="#00B04F"><font size="+1">
  1140      <a href="GraphicsMagick.html#details-visual">-visual</a> <i>&lt;type&gt;</i>
  1141  </font></font></font></b></td></tr></table>
  1142  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>animate images using this X visual type</td></tr></table>
  1143  <table BORDER=0 WIDTH="94%">
  1144  <tr>
  1145  <td width="3%"><br></td> 
  1146  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1147  <img SRC="images/right_triangle_option.png"
  1148  ALT=">" BORDER=0 height=14
  1149  width=15><b><font face="Helvetica, Arial"
  1150  ><font color="#00B04F"><font size="+1">
  1151      <a href="GraphicsMagick.html#details-window">-window</a> <i>&lt;id&gt;</i>
  1152  </font></font></font></b></td></tr></table>
  1153  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>make image the background of a window</td></tr></table>
  1154  <table BORDER=0 WIDTH="94%">
  1155  <tr>
  1156  <td width="3%"><br></td> 
  1157  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1158  <img SRC="images/right_triangle_option.png"
  1159  ALT=">" BORDER=0 height=14
  1160  width=15><b><font face="Helvetica, Arial"
  1161  ><font color="#00B04F"><font size="+1">
  1162      -window-group
  1163  </font></font></font></b></td></tr></table>
  1164  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>specify the window group</td></tr></table>
  1165  <table BORDER=0 WIDTH="94%">
  1166  <tr>
  1167  <td width="3%"><br></td> 
  1168  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1169  <img SRC="images/right_triangle_option.png"
  1170  ALT=">" BORDER=0 height=14
  1171  width=15><b><font face="Helvetica, Arial"
  1172  ><font color="#00B04F"><font size="+1">
  1173      <a href="GraphicsMagick.html#details-write">-write</a> <i>&lt;filename&gt;</i>
  1174  </font></font></font></b></td></tr></table>
  1175  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>write the image to a file [<em>display</em>]</td></tr></table>
  1176  <p>
  1177  For a more detailed description of each option, see
  1178  Options, above.
  1179  <a href="GraphicsMagick.html"><em>GraphicsMagick(1)</em></a>.
  1180  <br>&nbsp;<br>
  1181  </td></tr></table>
  1182       <p>
  1183  <i><a href="#top">Back to Contents</a></i> 
  1184  &nbsp;</p>
  1185  <table BORDER=0 WIDTH="100%"> 
  1186  <tr> 
  1187  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  1188  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  1189  height=14 width=15><b><font face="Helvetica, Arial"><font 
  1190  color="#00B04F"><font size="+1">
  1191  <a NAME="disp-mous"></a>Mouse Buttons
  1192  </font></font></font></b></td></tr></table>
  1193  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  1194  <tr><td width="3%"><br></td><td>
  1195  <p>
  1196  The effects of each button press is described below. Three buttons are
  1197  required. If you have a two button mouse, button 1 and 3 are returned.
  1198  Press <strong>ALT</strong> and button 3 to simulate button 2.
  1199  <table BORDER=0 WIDTH="94%">
  1200  <tr>
  1201  <td width="3%"><br></td> 
  1202  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1203  <img SRC="images/right_triangle_option.png"
  1204  ALT=">" BORDER=0 height=14
  1205  width=15><b><font face="Helvetica, Arial"
  1206  ><font color="#00B04F"><font size="+1">
  1207      1
  1208  </font></font></font></b></td></tr></table>
  1209  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1210  Press this button to map or unmap the <a href="#disp-comm">Command
  1211  widget</a> . See the next section for more information about the Command
  1212  widget.</td></tr></table>
  1213  <table BORDER=0 WIDTH="94%">
  1214  <tr>
  1215  <td width="3%"><br></td> 
  1216  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1217  <img SRC="images/right_triangle_option.png"
  1218  ALT=">" BORDER=0 height=14
  1219  width=15><b><font face="Helvetica, Arial"
  1220  ><font color="#00B04F"><font size="+1">
  1221      2
  1222  </font></font></font></b></td></tr></table>
  1223  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1224  Press and drag to define a region of the image to magnify.</td></tr></table>
  1225  <table BORDER=0 WIDTH="94%">
  1226  <tr>
  1227  <td width="3%"><br></td> 
  1228  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1229  <img SRC="images/right_triangle_option.png"
  1230  ALT=">" BORDER=0 height=14
  1231  width=15><b><font face="Helvetica, Arial"
  1232  ><font color="#00B04F"><font size="+1">
  1233      3
  1234  </font></font></font></b></td></tr></table>
  1235  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1236  Press and drag to choose from a select set of <strong>display(1)</strong>
  1237  commands. This button behaves differently if the image being displayed
  1238  is a visual image directory. Choose a particular tile of the directory
  1239  and press this button and drag to select a command from a pop-up menu.
  1240  Choose from these menu items:</td></tr></table>
  1241  <ul>
  1242  <li>Open
  1243  <li>Next
  1244  <li>Former
  1245  <li>Delete
  1246  <li>Update
  1247  </ul>
  1248  <p>
  1249  If you choose <strong>Open</strong>, the image represented by the tile is displayed.
  1250  To return to the visual image directory, choose <strong>Next</strong> from the Command
  1251  widget (refer to <a href="#disp-comm">Command Widget</a>).
  1252  <strong>Next</strong> and <strong>Former</strong>
  1253  moves to the next or former image respectively. Choose <strong>Delete</strong> to
  1254  delete a particular image tile. Finally, choose <strong>Update</strong> to synchronize
  1255  all the image tiles with their respective images. See
  1256  <a href="montage.html">montage</a>
  1257  and
  1258  <a href="miff.html">miff</a> for more details.
  1259  </td></tr></table>
  1260       <p>
  1261  <i><a href="#top">Back to Contents</a></i> 
  1262  &nbsp;</p>
  1263  <table BORDER=0 WIDTH="100%"> 
  1264  <tr> 
  1265  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  1266  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  1267  height=14 width=15><b><font face="Helvetica, Arial"><font 
  1268  color="#00B04F"><font size="+1">
  1269  <a NAME="disp-comm"></a>Command Widget
  1270  </font></font></font></b></td></tr></table>
  1271  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  1272  <tr><td width="3%"><br></td><td>
  1273  <p>
  1274  The Command widget lists a number of sub-menus and commands. They are
  1275  <ul>
  1276  <li><strong>File</strong>
  1277  <ul>
  1278  <li>Open...
  1279  <li>Next
  1280  <li>Former
  1281  <li>Select...
  1282  <li>Save...
  1283  <li>Print...
  1284  <li>Delete...
  1285  <li>Canvas...
  1286  <li>Visual Directory...
  1287  <li>Quit
  1288  </ul>
  1289  </ul>
  1290  <ul>
  1291  <li><strong>Edit</strong>
  1292  <ul>
  1293  <li>Undo
  1294  <li>Redo
  1295  <li>Cut
  1296  <li>Copy
  1297  <li>Paste
  1298  </ul>
  1299  </ul>
  1300  <ul>
  1301  <li><strong>View</strong>
  1302  <ul>
  1303  <li>Half Size
  1304  <li>Original Size
  1305  <li>Double Size
  1306  <li>Resize...
  1307  <li>Apply
  1308  <li>Refresh
  1309  <li>Restore
  1310  </ul>
  1311  </ul>
  1312  <ul>
  1313  <li><strong>Transform</strong>
  1314  <ul>
  1315  <li>Crop
  1316  <li>Chop
  1317  <li>Flop
  1318  <li>Flip
  1319  <li>Rotate Right
  1320  <li>Rotate Left
  1321  <li>Rotate...
  1322  <li>Shear...
  1323  <li>Roll...
  1324  <li>Trim Edges
  1325  </ul>
  1326  </ul>
  1327  <ul>
  1328  <li><strong>Enhance</strong>
  1329  <ul>
  1330  <li>Hue...
  1331  <li>Saturation...
  1332  <li>Brightness...
  1333  <li>Gamma...
  1334  <li>Spiff...
  1335  <li>Dull
  1336  <li>Equalize
  1337  <li>Normalize
  1338  <li>Negate
  1339  <li>GRAYscale
  1340  <li>Quantize...
  1341  </ul>
  1342  </ul>
  1343  <ul>
  1344  <li><strong>Effects</strong>
  1345  <ul>
  1346  <li>Despeckle
  1347  <li>Emboss
  1348  <li>Reduce Noise
  1349  <li>Add Noise
  1350  <li>Sharpen...
  1351  <li>Blur...
  1352  <li>Threshold...
  1353  <li>Edge Detect...
  1354  <li>Spread...
  1355  <li>Shade...
  1356  <li>Raise...
  1357  <li>Segment...
  1358  </ul>
  1359  </ul>
  1360  <ul>
  1361  <li><strong>F/X</strong>
  1362  <ul>
  1363  <li>Solarize...
  1364  <li>Swirl...
  1365  <li>Implode...
  1366  <li>Wave...
  1367  <li>Oil Paint...
  1368  <li>Charcoal Draw...
  1369  </ul>
  1370  </ul>
  1371  <ul>
  1372  <li><strong>Image Edit</strong>
  1373  <ul>
  1374  <li>Annotate...
  1375  <li>Draw...
  1376  <li>Color...
  1377  <li>Matte...
  1378  <li>Composite...
  1379  <li>Add Border...
  1380  <li>Add Frame...
  1381  <li>Comment...
  1382  <li>Launch...
  1383  <li>Region of Interest...
  1384  </ul>
  1385  </ul>
  1386  <ul>
  1387  <li><strong>Miscellany</strong>
  1388  <ul>
  1389  <li>Image Info
  1390  <li>Zoom Image
  1391  <li>Show Preview...
  1392  <li>Show Histogram
  1393  <li>Show Matte
  1394  <li>Background...
  1395  <li>Slide Show
  1396  <li>Preferences...
  1397  </ul>
  1398  </ul>
  1399  <ul>
  1400  <li><strong>Help</strong>
  1401  <ul>
  1402  <li>Overview
  1403  <li>Browse Documentation
  1404  <li>About Display
  1405  </ul>
  1406  </ul>
  1407  <p>
  1408  Menu items with a indented triangle have a sub-menu. They are represented
  1409  above as the indented items. To access a sub-menu item, move the pointer
  1410  to the appropriate menu and press button 1 and drag. When you find the
  1411  desired sub-menu item, release the button and the command is executed.
  1412  Move the pointer away from the sub-menu if you decide not to execute a
  1413  particular command.
  1414  </td></tr></table>
  1415       <p>
  1416  <i><a href="#top">Back to Contents</a></i> 
  1417  &nbsp;</p>
  1418  <table BORDER=0 WIDTH="100%"> 
  1419  <tr> 
  1420  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  1421  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  1422  height=14 width=15><b><font face="Helvetica, Arial"><font 
  1423  color="#00B04F"><font size="+1">
  1424  <a NAME="disp-keyb"></a>Keyboard Accelerators
  1425  </font></font></font></b></td></tr></table>
  1426  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  1427  <tr><td width="3%"><br></td><td>
  1428  <p>
  1429  Accelerators are one or two key presses that effect a particular command.
  1430  The keyboard accelerators that
  1431  <strong>display</strong> understands is:
  1432  <pre>
  1433      Ctl+O     Press to <a href="#disp-imlo">load</a> an image from a file.
  1434      space     Press to display the next image.
  1435  </pre>
  1436  <p>
  1437  If the image is a multi-paged document such as a
  1438  <em>PostScript</em> document,
  1439  you can skip ahead several pages by preceding this command with a number.
  1440  For example to display the fourth page beyond the current page,
  1441  press <tt>4space</tt>.
  1442  <pre>
  1443      backspace Press to display the former image.
  1444  </pre>
  1445  <p>
  1446  If the image is a multi-paged document such as a
  1447  <em>PostScript</em> document,
  1448  you can skip behind several pages by preceding this command with a number.
  1449  For example to display the fourth page preceding the current page, press
  1450  4n.
  1451  <pre>
  1452      Ctl-S    Press to save the image to a file.
  1453      Ctl-P    Press to print the image to a
  1454               <em>PostScript</em> printer.
  1455      Ctl-D    Press to delete an image file.
  1456      Ctl-N    Press to create a blank canvas.
  1457      Ctl-Q    Press to discard all images and exit program.
  1458      Ctl+Z    Press to undo last image transformation.
  1459      Ctl+R    Press to redo last image transformation.
  1460      Ctl-X    Press to <a href="#disp-imcu">cut</a> a region of
  1461               the image.
  1462      Ctl-C    Press to <a href="#disp-imco">copy</a> a region of
  1463               the image.
  1464      Ctl-V    Press to <a href="#disp-impa">paste</a> a region to
  1465               the image.
  1466      &lt;        Press to halve the image size.
  1467      .        Press to return to the original image size.
  1468      &gt;        Press to double the image size.
  1469      %        Press to resize the image to a width and height
  1470               you specify.
  1471      Cmd-A    Press to make any image transformations
  1472               permanent.
  1473               By default, any image size transformations are
  1474               applied to the original image to create the
  1475               image displayed on the X server.  However, the
  1476               transformations are not permanent (i.e. the
  1477               original image does not change size only the
  1478               X image does). For example, if you press "&gt;"
  1479               the X image will appear to double in size, but
  1480               the original image will in fact remain the same
  1481               size.  To force the original image to double in
  1482               size, press "&gt;" followed by "Cmd-A".
  1483      @        Press to refresh the image window.
  1484      C        Press to <a href="#disp-imcr">crop</a> the image.
  1485      [        Press to <a href="#disp-imch">chop</a> the image.
  1486      H        Press to flop image in the horizontal direction.
  1487      V        Press to flip image in the vertical direction.
  1488      /        Press to rotate the image 90 degrees clockwise.
  1489      \        Press to rotate the image 90 degrees
  1490               counter-clockwise.
  1491      *        Press to <a href="#disp-imro">rotate</a> the image
  1492               the number of degrees you specify.
  1493      S        Press to shear the image the number of degrees
  1494               you specify.
  1495      R        Press to roll the image.
  1496      T        Press to trim the image edges.
  1497      Shft-H   Press to vary the color hue.
  1498      Shft-S   Press to vary the color saturation.
  1499      Shft-L   Press to vary the image brightness.
  1500      Shft-G   Press to gamma correct the image.
  1501      Shft-C   Press to spiff up the image contrast.
  1502      Shft-Z   Press to dull the image contrast.
  1503      =        Press to perform histogram equalization on
  1504               the image.
  1505      Shft-N   Press to perform histogram normalization on
  1506               the image.
  1507      Shft-~   Press to negate the colors of the image.
  1508      .        Press to convert the image colors to gray.
  1509      Shft-#   Press to set the maximum number of unique
  1510               colors in the image.
  1511      F2       Press to reduce the speckles in an image.
  1512      F2       Press to emboss an image.
  1513      F4       Press to eliminate peak noise from an image.
  1514      F5       Press to add noise to an image.
  1515      F6       Press to sharpen an image.
  1516      F7       Press to blur image an image.
  1517      F8       Press to threshold the image.
  1518      F9       Press to detect edges within an image.
  1519      F10      Press to displace pixels by a random amount.
  1520      F11      Press to shade the image using a distant light
  1521               source.
  1522      F12      Press to lighten or darken image edges to
  1523               create a 3-D effect.
  1524      F13      Press to segment the image by color.
  1525      Meta-S   Press to swirl image pixels about the center.
  1526      Meta-I   Press to implode image pixels about the center.
  1527      Meta-W   Press to alter an image along a sine wave.
  1528      Meta-P   Press to simulate an oil painting.
  1529      Meta-C   Press to simulate a charcoal drawing.
  1530      Alt-X    Press to <a href="#disp-imcomp">composite</a> the image
  1531               with another.
  1532      Alt-A    Press to <a href="#disp-iman">annotate</a> the image with text.
  1533      Alt-D    Press to <a href="#disp-imdr">draw</a> a line on the image.
  1534      Alt-P    Press to <a href="#disp-cole">edit an image pixel color</a>.
  1535      Alt-M    Press to <a href="#disp-matt">edit the image matte</a> information.
  1536      Alt-X    Press to <a href="#disp-imcomp">composite</a> the image with another.
  1537      Alt-A    Press to add a border to the image.
  1538      Alt-F    Press to add a ornamental frame to the image.
  1539      Alt-Shft-!   Press to add an image comment.
  1540      Ctl-A    Press to apply image processing techniques to a
  1541               region of interest.
  1542      Shft-?   Press to display information about the image.
  1543      Shft-+   Press to map the zoom image window.
  1544      Shft-P   Press to preview an image enhancement, effect,
  1545               or f/x.
  1546      F1       Press to display helpful information about
  1547               the "display" utility.
  1548      Find     Press to browse documentation about
  1549               GraphicsMagick.
  1550      1-9      Press to change the level of magnification.
  1551  </pre>
  1552  <p>
  1553  Use the arrow keys to move the image one pixel up, down, left, or right
  1554  within the magnify window. Be sure to first map the magnify window by pressing
  1555  button 2.
  1556  <p>
  1557  Press ALT and one of the arrow keys to trim off one pixel from any side
  1558  of the image.
  1559  </td></tr></table>
  1560       <p>
  1561  <i><a href="#top">Back to Contents</a></i> 
  1562  &nbsp;</p>
  1563  <table BORDER=0 WIDTH="100%"> 
  1564  <tr> 
  1565  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  1566  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  1567  height=14 width=15><b><font face="Helvetica, Arial"><font 
  1568  color="#00B04F"><font size="+1">
  1569  <a NAME="disp-xres"></a>X Resources
  1570  </font></font></font></b></td></tr></table>
  1571  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  1572  <tr><td width="3%"><br></td><td>
  1573  <p>
  1574  <strong>Display</strong> options can appear on the command line or in your X resource
  1575  file. Options on the command line supersede values specified in your X
  1576  resource file. See <em>X(1)</em> for more information on X resources.
  1577  <p>
  1578  Most <strong>display</strong> options have a corresponding X resource. In addition,
  1579  <strong>display</strong>
  1580  uses the following X resources:
  1581  <table BORDER=0 WIDTH="94%">
  1582  <tr>
  1583  <td width="3%"><br></td> 
  1584  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1585  <img SRC="images/right_triangle_option.png"
  1586  ALT=">" BORDER=0 height=14
  1587  width=15><b><font face="Helvetica, Arial"
  1588  ><font color="#00B04F"><font size="+1">
  1589      background <i>(class Background)</i>
  1590  </font></font></font></b></td></tr></table>
  1591  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1592  Specifies the preferred color to use for the Image window background. The
  1593  default is #ccc.</td></tr></table>
  1594  <table BORDER=0 WIDTH="94%">
  1595  <tr>
  1596  <td width="3%"><br></td> 
  1597  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1598  <img SRC="images/right_triangle_option.png"
  1599  ALT=">" BORDER=0 height=14
  1600  width=15><b><font face="Helvetica, Arial"
  1601  ><font color="#00B04F"><font size="+1">
  1602      borderColor <i>(class BorderColor)</i>
  1603  </font></font></font></b></td></tr></table>
  1604  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1605  Specifies the preferred color to use for the Image window border. The default
  1606  is #ccc.</td></tr></table>
  1607  <table BORDER=0 WIDTH="94%">
  1608  <tr>
  1609  <td width="3%"><br></td> 
  1610  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1611  <img SRC="images/right_triangle_option.png"
  1612  ALT=">" BORDER=0 height=14
  1613  width=15><b><font face="Helvetica, Arial"
  1614  ><font color="#00B04F"><font size="+1">
  1615      borderWidth <i>(class BorderWidth)</i>
  1616  </font></font></font></b></td></tr></table>
  1617  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1618  Specifies the width in pixels of the image window border. The default is
  1619  2.</td></tr></table>
  1620  <table BORDER=0 WIDTH="94%">
  1621  <tr>
  1622  <td width="3%"><br></td> 
  1623  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1624  <img SRC="images/right_triangle_option.png"
  1625  ALT=">" BORDER=0 height=14
  1626  width=15><b><font face="Helvetica, Arial"
  1627  ><font color="#00B04F"><font size="+1">
  1628      browseCommand <i>(class browseCommand)</i>
  1629  </font></font></font></b></td></tr></table>
  1630  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1631  Specifies the name of the preferred browser when displaying GraphicsMagick
  1632  documentation. The default is <tt>netscape %s</tt>.</td></tr></table>
  1633  <table BORDER=0 WIDTH="94%">
  1634  <tr>
  1635  <td width="3%"><br></td> 
  1636  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1637  <img SRC="images/right_triangle_option.png"
  1638  ALT=">" BORDER=0 height=14
  1639  width=15><b><font face="Helvetica, Arial"
  1640  ><font color="#00B04F"><font size="+1">
  1641      confirmExit <i>(class ConfirmExit)</i>
  1642  </font></font></font></b></td></tr></table>
  1643  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1644  <strong>Display</strong> pops up a dialog box to confirm exiting the program when
  1645  exiting the program. Set this resource to <tt>False</tt> to exit without
  1646  a confirmation.</td></tr></table>
  1647  <table BORDER=0 WIDTH="94%">
  1648  <tr>
  1649  <td width="3%"><br></td> 
  1650  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1651  <img SRC="images/right_triangle_option.png"
  1652  ALT=">" BORDER=0 height=14
  1653  width=15><b><font face="Helvetica, Arial"
  1654  ><font color="#00B04F"><font size="+1">
  1655      displayGamma <i>(class DisplayGamma)</i>
  1656  </font></font></font></b></td></tr></table>
  1657  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1658  Specifies the gamma of the X server.</td></tr></table>
  1659  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1660  You can apply separate gamma values to the red, green, and blue channels
  1661  of the image with a gamma value list delineated with slashes (i.e. 1.7/2.3/1.2).</td></tr></table>
  1662  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1663  The default is 2.2.</td></tr></table>
  1664  <table BORDER=0 WIDTH="94%">
  1665  <tr>
  1666  <td width="3%"><br></td> 
  1667  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1668  <img SRC="images/right_triangle_option.png"
  1669  ALT=">" BORDER=0 height=14
  1670  width=15><b><font face="Helvetica, Arial"
  1671  ><font color="#00B04F"><font size="+1">
  1672      displayWarnings <i>(class DisplayWarnings)</i>
  1673  </font></font></font></b></td></tr></table>
  1674  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1675  <strong>Display</strong> pops up a dialog box whenever a warning message occurs.
  1676  Set this resource to <tt>False</tt> to ignore warning messages.</td></tr></table>
  1677  <table BORDER=0 WIDTH="94%">
  1678  <tr>
  1679  <td width="3%"><br></td> 
  1680  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1681  <img SRC="images/right_triangle_option.png"
  1682  ALT=">" BORDER=0 height=14
  1683  width=15><b><font face="Helvetica, Arial"
  1684  ><font color="#00B04F"><font size="+1">
  1685      font <i>(class FontList)</i>
  1686  </font></font></font></b></td></tr></table>
  1687  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1688  Specifies the name of the preferred font to use in normal formatted text.
  1689  The default is 14 point Helvetica.</td></tr></table>
  1690  <table BORDER=0 WIDTH="94%">
  1691  <tr>
  1692  <td width="3%"><br></td> 
  1693  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1694  <img SRC="images/right_triangle_option.png"
  1695  ALT=">" BORDER=0 height=14
  1696  width=15><b><font face="Helvetica, Arial"
  1697  ><font color="#00B04F"><font size="+1">
  1698      font[1-9] <i>(class Font[1-9])</i>
  1699  </font></font></font></b></td></tr></table>
  1700  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1701  Specifies the name of the preferred font to use when
  1702  <a href="#disp-iman">annotating</a>
  1703  the image window with text. The default fonts are fixed, variable, 5x8,
  1704  6x10, 7x13bold, 8x13bold, 9x15bold, 10x20, and 12x24.</td></tr></table>
  1705  <table BORDER=0 WIDTH="94%">
  1706  <tr>
  1707  <td width="3%"><br></td> 
  1708  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1709  <img SRC="images/right_triangle_option.png"
  1710  ALT=">" BORDER=0 height=14
  1711  width=15><b><font face="Helvetica, Arial"
  1712  ><font color="#00B04F"><font size="+1">
  1713      foreground <i>(class Foreground)</i>
  1714  </font></font></font></b></td></tr></table>
  1715  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1716  Specifies the preferred color to use for text within the image window.
  1717  The default is black.</td></tr></table>
  1718  <table BORDER=0 WIDTH="94%">
  1719  <tr>
  1720  <td width="3%"><br></td> 
  1721  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1722  <img SRC="images/right_triangle_option.png"
  1723  ALT=">" BORDER=0 height=14
  1724  width=15><b><font face="Helvetica, Arial"
  1725  ><font color="#00B04F"><font size="+1">
  1726      gammaCorrect <i>(class gammaCorrect)</i>
  1727  </font></font></font></b></td></tr></table>
  1728  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1729  This resource, if true, will lighten or darken an image of known gamma
  1730  to match the gamma of the display (see resource <strong>displayGamma</strong>). The
  1731  default is True.</td></tr></table>
  1732  <table BORDER=0 WIDTH="94%">
  1733  <tr>
  1734  <td width="3%"><br></td> 
  1735  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1736  <img SRC="images/right_triangle_option.png"
  1737  ALT=">" BORDER=0 height=14
  1738  width=15><b><font face="Helvetica, Arial"
  1739  ><font color="#00B04F"><font size="+1">
  1740      geometry <i>(class Geometry)</i>
  1741  </font></font></font></b></td></tr></table>
  1742  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1743  Specifies the preferred size and position of the image window. It is not
  1744  necessarily obeyed by all window managers.</td></tr></table>
  1745  <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
  1746  Offsets, if present, are handled in <em>X(1)</em> style.  A negative x offset is
  1747  measured from the right edge of the screen to the right edge of the icon,
  1748  and a negative y offset is measured from the bottom edge of the screen
  1749  to the bottom edge of the icon.</font></td></tr></table>
  1750  <table BORDER=0 WIDTH="94%">
  1751  <tr>
  1752  <td width="3%"><br></td> 
  1753  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1754  <img SRC="images/right_triangle_option.png"
  1755  ALT=">" BORDER=0 height=14
  1756  width=15><b><font face="Helvetica, Arial"
  1757  ><font color="#00B04F"><font size="+1">
  1758      iconGeometry <i>(class IconGeometry)</i>
  1759  </font></font></font></b></td></tr></table>
  1760  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1761  Specifies the preferred size and position of the application when iconified.
  1762  It is not necessarily obeyed by all window managers.</td></tr></table>
  1763  <table width="90%" border="0" cellspacing="0"             cellpadding="8">             <tr><td width="6%"><br></td><td><font size="-1">
  1764  Offsets, if present, are handled in the same manner as in class Geometry.</font></td></tr></table>
  1765  <table BORDER=0 WIDTH="94%">
  1766  <tr>
  1767  <td width="3%"><br></td> 
  1768  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1769  <img SRC="images/right_triangle_option.png"
  1770  ALT=">" BORDER=0 height=14
  1771  width=15><b><font face="Helvetica, Arial"
  1772  ><font color="#00B04F"><font size="+1">
  1773      iconic <i>(class Iconic)</i>
  1774  </font></font></font></b></td></tr></table>
  1775  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1776  This resource indicates that you would prefer that the application's windows
  1777  initially not be visible as if the windows had be immediately iconified
  1778  by you. Window managers may choose not to honor the application's request.</td></tr></table>
  1779  <table BORDER=0 WIDTH="94%">
  1780  <tr>
  1781  <td width="3%"><br></td> 
  1782  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1783  <img SRC="images/right_triangle_option.png"
  1784  ALT=">" BORDER=0 height=14
  1785  width=15><b><font face="Helvetica, Arial"
  1786  ><font color="#00B04F"><font size="+1">
  1787      magnify <i>(class Magnify)</i>
  1788  </font></font></font></b></td></tr></table>
  1789  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1790  specifies an integral factor by which the image should be enlarged. The
  1791  default is 3.</td></tr></table>
  1792  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1793  This value only affects the magnification window which is invoked with
  1794  <a href="#disp-mous">button</a>
  1795  number 3 after the image is displayed.</td></tr></table>
  1796  <table BORDER=0 WIDTH="94%">
  1797  <tr>
  1798  <td width="3%"><br></td> 
  1799  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1800  <img SRC="images/right_triangle_option.png"
  1801  ALT=">" BORDER=0 height=14
  1802  width=15><b><font face="Helvetica, Arial"
  1803  ><font color="#00B04F"><font size="+1">
  1804      matteColor <i>(class MatteColor)</i>
  1805  </font></font></font></b></td></tr></table>
  1806  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1807  Specify the color of windows. It is used for the backgrounds of windows,
  1808  menus, and notices. A 3D effect is achieved by using highlight and shadow
  1809  colors derived from this color. Default value: #697B8F.</td></tr></table>
  1810  <table BORDER=0 WIDTH="94%">
  1811  <tr>
  1812  <td width="3%"><br></td> 
  1813  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1814  <img SRC="images/right_triangle_option.png"
  1815  ALT=">" BORDER=0 height=14
  1816  width=15><b><font face="Helvetica, Arial"
  1817  ><font color="#00B04F"><font size="+1">
  1818      name <i>(class Name)</i>
  1819  </font></font></font></b></td></tr></table>
  1820  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1821  This resource specifies the name under which resources for the application
  1822  should be found. This resource is useful in shell aliases to distinguish
  1823  between invocations of an application, without resorting to creating links
  1824  to alter the executable file name. The default is the application name.</td></tr></table>
  1825  <table BORDER=0 WIDTH="94%">
  1826  <tr>
  1827  <td width="3%"><br></td> 
  1828  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1829  <img SRC="images/right_triangle_option.png"
  1830  ALT=">" BORDER=0 height=14
  1831  width=15><b><font face="Helvetica, Arial"
  1832  ><font color="#00B04F"><font size="+1">
  1833      pen[1-9] <i>(class Pen[1-9])</i>
  1834  </font></font></font></b></td></tr></table>
  1835  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1836  Specifies the color of the preferred font to use when
  1837  <a href="#disp-iman">annotating</a>
  1838  the image window with text. The default colors are black, blue, green,
  1839  cyan, gray, red, magenta, yellow, and white.</td></tr></table>
  1840  <table BORDER=0 WIDTH="94%">
  1841  <tr>
  1842  <td width="3%"><br></td> 
  1843  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1844  <img SRC="images/right_triangle_option.png"
  1845  ALT=">" BORDER=0 height=14
  1846  width=15><b><font face="Helvetica, Arial"
  1847  ><font color="#00B04F"><font size="+1">
  1848      printCommand <i>(class PrintCommand)</i>
  1849  </font></font></font></b></td></tr></table>
  1850  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1851  This command is executed whenever Print is issued.  In general, it is the
  1852  command to print <em>PostScript</em> to your printer. Default value: <tt>lp
  1853  -c -s %i</tt>.</td></tr></table>
  1854  <table BORDER=0 WIDTH="94%">
  1855  <tr>
  1856  <td width="3%"><br></td> 
  1857  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1858  <img SRC="images/right_triangle_option.png"
  1859  ALT=">" BORDER=0 height=14
  1860  width=15><b><font face="Helvetica, Arial"
  1861  ><font color="#00B04F"><font size="+1">
  1862      sharedMemory <i>(class SharedMemory)</i>
  1863  </font></font></font></b></td></tr></table>
  1864  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1865  This resource specifies whether display should attempt use shared memory
  1866  for pixmaps. GraphicsMagick must be compiled with shared memory support,
  1867  and the display must support the MIT-SHM extension. Otherwise, this
  1868  resource is ignored. The default is True.</td></tr></table>
  1869  <table BORDER=0 WIDTH="94%">
  1870  <tr>
  1871  <td width="3%"><br></td> 
  1872  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1873  <img SRC="images/right_triangle_option.png"
  1874  ALT=">" BORDER=0 height=14
  1875  width=15><b><font face="Helvetica, Arial"
  1876  ><font color="#00B04F"><font size="+1">
  1877      textFont <i>(class textFont)</i>
  1878  </font></font></font></b></td></tr></table>
  1879  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1880  Specifies the name of the preferred font to use in fixed (typewriter style)
  1881  formatted text. The default is 14 point Courier.</td></tr></table>
  1882  <table BORDER=0 WIDTH="94%">
  1883  <tr>
  1884  <td width="3%"><br></td> 
  1885  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1886  <img SRC="images/right_triangle_option.png"
  1887  ALT=">" BORDER=0 height=14
  1888  width=15><b><font face="Helvetica, Arial"
  1889  ><font color="#00B04F"><font size="+1">
  1890      title <i>(class Title)</i>
  1891  </font></font></font></b></td></tr></table>
  1892  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1893  This resource specifies the title to be used for the image window. This
  1894  information is sometimes used by a window manager to provide a header identifying
  1895  the window. The default is the image file name.</td></tr></table>
  1896  <table BORDER=0 WIDTH="94%">
  1897  <tr>
  1898  <td width="3%"><br></td> 
  1899  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1900  <img SRC="images/right_triangle_option.png"
  1901  ALT=">" BORDER=0 height=14
  1902  width=15><b><font face="Helvetica, Arial"
  1903  ><font color="#00B04F"><font size="+1">
  1904      undoCache <i>(class UndoCache)</i>
  1905  </font></font></font></b></td></tr></table>
  1906  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1907  Specifies, in mega-bytes, the amount of memory in the undo edit cache.
  1908  Each time you modify the image it is saved in the undo edit cache as long
  1909  as memory is available. You can subsequently <em>undo</em> one or more of
  1910  these transformations. The default is 16 Megabytes.</td></tr></table>
  1911  <table BORDER=0 WIDTH="94%">
  1912  <tr>
  1913  <td width="3%"><br></td> 
  1914  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  1915  <img SRC="images/right_triangle_option.png"
  1916  ALT=">" BORDER=0 height=14
  1917  width=15><b><font face="Helvetica, Arial"
  1918  ><font color="#00B04F"><font size="+1">
  1919      usePixmap <i>(class UsePixmap)</i>
  1920  </font></font></font></b></td></tr></table>
  1921  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  1922  Images are maintained as a XImage by default. Set this resource to True
  1923  to utilize a server Pixmap instead. This option is useful if your image
  1924  exceeds the dimensions of your server screen and you intend to pan the
  1925  image. Panning is much faster with Pixmaps than with a XImage. Pixmaps
  1926  are considered a precious resource, use them with discretion.</td></tr></table>
  1927  <p>
  1928  To set the geometry of the Magnify or Pan or window, use the geometry resource.
  1929  For example, to set the Pan window geometry to 256x256, use:
  1930  <pre>
  1931      gm display.pan.geometry: 256x256
  1932  </pre>
  1933  </td></tr></table>
  1934       <p>
  1935  <i><a href="#top">Back to Contents</a></i> 
  1936  &nbsp;</p>
  1937  <table BORDER=0 WIDTH="100%"> 
  1938  <tr> 
  1939  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  1940  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  1941  height=14 width=15><b><font face="Helvetica, Arial"><font 
  1942  color="#00B04F"><font size="+1">
  1943  <a NAME="disp-imlo"></a>Image Loading
  1944  </font></font></font></b></td></tr></table>
  1945  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  1946  <tr><td width="3%"><br></td><td>
  1947  <p>
  1948  To select an image to display, choose <strong>Open</strong> of the <strong>File</strong> sub-menu
  1949  from the <a href="#disp-comm">Command widget</a>. A file browser is displayed.
  1950  To choose a particular image file, move the pointer to the filename and
  1951  press any button. The filename is copied to the text window. Next, press
  1952  <strong>Open</strong>
  1953  or press the <strong>RETURN</strong> key. Alternatively, you can type the image file
  1954  name directly into the text window. To descend directories, choose a directory
  1955  name and press the button twice quickly. A scrollbar allows a large list
  1956  of filenames to be moved through the viewing area if it exceeds the size
  1957  of the list area.
  1958  <p>
  1959  You can trim the list of file names by using shell globbing characters.
  1960  For example, type <tt>*.jpg</tt> to list only files that end
  1961  with <tt>.jpg</tt>.
  1962  <p>
  1963  To select your image from the X server screen instead of from a file, Choose
  1964  <strong>Grab</strong> of the <strong>Open</strong> widget.
  1965  </td></tr></table>
  1966       <p>
  1967  <i><a href="#top">Back to Contents</a></i> 
  1968  &nbsp;</p>
  1969  <table BORDER=0 WIDTH="100%"> 
  1970  <tr> 
  1971  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  1972  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  1973  height=14 width=15><b><font face="Helvetica, Arial"><font 
  1974  color="#00B04F"><font size="+1">
  1975  <a NAME="disp-visu"></a>Visual Image Directory
  1976  </font></font></font></b></td></tr></table>
  1977  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  1978  <tr><td width="3%"><br></td><td>
  1979  <p>
  1980  To create a Visual Image Directory, choose Visual Directory of the <strong>File</strong>
  1981  sub-menu from the <a href="#disp-comm">Command widget</a> . A file browser is
  1982  displayed. To create a Visual Image Directory from all the images in the
  1983  current directory, press <strong>Directory</strong> or press the <strong>RETURN key</strong>.
  1984  Alternatively, you can select a set of image names by using shell globbing
  1985  characters. For example, type <tt>*.jpg</tt> to include only files that
  1986  end with <tt>.jpg</tt>. To descend directories, choose a directory name
  1987  and press the button twice quickly. A scrollbar allows a large list of
  1988  filenames to be moved through the viewing area if it exceeds the size of
  1989  the list area.
  1990  <p>
  1991  After you select a set of files, they are turned into thumbnails and tiled
  1992  onto a single image. Now move the pointer to a particular thumbnail and
  1993  press <strong>button 3</strong> and drag. Finally, select Open. The image represented
  1994  by the thumbnail is displayed at its full size. Choose <strong>Next</strong> from
  1995  the <strong>File</strong> sub-menu of the Command widget to return to the Visual
  1996  Image Directory.
  1997  </td></tr></table>
  1998       <p>
  1999  <i><a href="#top">Back to Contents</a></i> 
  2000  &nbsp;</p>
  2001  <table BORDER=0 WIDTH="100%"> 
  2002  <tr> 
  2003  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2004  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2005  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2006  color="#00B04F"><font size="+1">
  2007  <a NAME="disp-imcu"></a>Image Cutting
  2008  </font></font></font></b></td></tr></table>
  2009  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2010  <tr><td width="3%"><br></td><td>
  2011  <p>
  2012  Note that cut information for image window is not retained for colormapped
  2013  X server visuals (e.g. <em>StaticColor</em>,
  2014  <em>StaticColor</em>, <em>GRAYScale</em>,
  2015  <em>PseudoColor</em>).
  2016  Correct cutting behavior may require a <em>TrueColor</em> or <em>DirectColor</em>
  2017  visual or a <em>Standard Colormap</em>.
  2018  <p>
  2019  To begin, press choose <strong>Cut</strong> of the <strong>Edit</strong> sub-menu from the
  2020  <a href="#disp-comm">Command
  2021  widget</a>. Alternatively, press
  2022  <strong>F3</strong> in the image window.
  2023  <p>
  2024  A small window appears showing the location of the cursor in the image
  2025  window. You are now in cut mode. In cut mode, the Command widget has these
  2026  options:
  2027  <ul>
  2028  <li><strong>Help</strong>
  2029  <li><strong>Dismiss</strong>
  2030  </ul>
  2031  <p>
  2032  To define a cut region, press button 1 and drag. The cut region is defined
  2033  by a highlighted rectangle that expands or contracts as it follows the
  2034  pointer. Once you are satisfied with the cut region, release the button.
  2035  You are now in rectify mode. In rectify mode, the Command widget has these
  2036  options:
  2037  <ul>
  2038  <li><strong>Cut</strong>
  2039  <li><strong>Help</strong>
  2040  <li><strong>Dismiss</strong>
  2041  </ul>
  2042  <p>
  2043  You can make adjustments by moving the pointer to one of the cut rectangle
  2044  corners, pressing a button, and dragging. Finally, press Cut to commit
  2045  your copy region. To exit without cutting the image, press Dismiss.
  2046  </td></tr></table>
  2047       <p>
  2048  <i><a href="#top">Back to Contents</a></i> 
  2049  &nbsp;</p>
  2050  <table BORDER=0 WIDTH="100%"> 
  2051  <tr> 
  2052  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2053  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2054  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2055  color="#00B04F"><font size="+1">
  2056  <a NAME="disp-imco"></a>Image Copying
  2057  </font></font></font></b></td></tr></table>
  2058  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2059  <tr><td width="3%"><br></td><td>
  2060  <p>
  2061  To begin, press choose <strong>Copy</strong> of the <strong>Edit</strong> sub-menu from the
  2062  <a href="#disp-comm">Command
  2063  widget</a>. Alternatively, press
  2064  <strong>F4</strong> in the image window.
  2065  <p>
  2066  A small window appears showing the location of the cursor in the image
  2067  window. You are now in copy mode. In copy mode, the Command widget has
  2068  these options:
  2069  <ul>
  2070  <li>Help
  2071  <li>Dismiss
  2072  </ul>
  2073  <p>
  2074  To define a copy region, press button 1 and drag. The copy region is defined
  2075  by a highlighted rectangle that expands or contracts as it follows the
  2076  pointer. Once you are satisfied with the copy region, release the button.
  2077  You are now in rectify mode. In rectify mode, the Command widget has these
  2078  options:
  2079  <ul>
  2080  <li>Copy
  2081  <li>Help
  2082  <li>Dismiss
  2083  </ul>
  2084  <p>
  2085  You can make adjustments by moving the pointer to one of the copy rectangle
  2086  corners, pressing a button, and dragging. Finally, press Copy to commit
  2087  your copy region. To exit without copying the image, press Dismiss.
  2088  </td></tr></table>
  2089       <p>
  2090  <i><a href="#top">Back to Contents</a></i> 
  2091  &nbsp;</p>
  2092  <table BORDER=0 WIDTH="100%"> 
  2093  <tr> 
  2094  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2095  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2096  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2097  color="#00B04F"><font size="+1">
  2098  <a NAME="disp-impas"></a>Image Pasting
  2099  </font></font></font></b></td></tr></table>
  2100  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2101  <tr><td width="3%"><br></td><td>
  2102  <p>
  2103  To begin, press choose <strong>Paste</strong> of the <strong>Edit</strong> sub-menu from the
  2104  <a href="#disp-comm">Command
  2105  widget</a>. Alternatively, press
  2106  <strong>F5</strong> in the image window.
  2107  <p>
  2108  A small window appears showing the location of the cursor in the image
  2109  window. You are now in Paste mode. To exit immediately, press Dismiss.
  2110  In Paste mode, the Command widget has these options:
  2111  <ul>
  2112  <li><strong>Operators</strong>
  2113  <ul>
  2114  <li>over
  2115  <li>in
  2116  <li>out
  2117  <li>atop
  2118  <li>xor
  2119  <li>plus
  2120  <li>minus
  2121  <li>add
  2122  <li>subtract
  2123  <li>difference
  2124  <li>multiply
  2125  <li>bumpmap
  2126  <li>replace
  2127  </ul>
  2128  <li><strong>Help</strong>
  2129  <li><strong>Dismiss</strong>
  2130  </ul>
  2131  <p>
  2132  Choose a composite operation from the <strong>Operators</strong> sub-menu of the
  2133  <a href="#disp-comm">Command
  2134  widget</a>. How each operator behaves is described below. <em>image window</em>
  2135  is the image currently displayed on your X server and <em>image</em> is the
  2136  image obtained with the File Browser widget.
  2137  <table BORDER=0 WIDTH="94%">
  2138  <tr>
  2139  <td width="3%"><br></td> 
  2140  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2141  <img SRC="images/right_triangle_option.png"
  2142  ALT=">" BORDER=0 height=14
  2143  width=15><b><font face="Helvetica, Arial"
  2144  ><font color="#00B04F"><font size="+1">
  2145      over
  2146  </font></font></font></b></td></tr></table>
  2147  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2148  The result is the union of the two image shapes, with <em>image</em> obscuring
  2149  <em>image
  2150  window</em> in the region of overlap.</td></tr></table>
  2151  <table BORDER=0 WIDTH="94%">
  2152  <tr>
  2153  <td width="3%"><br></td> 
  2154  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2155  <img SRC="images/right_triangle_option.png"
  2156  ALT=">" BORDER=0 height=14
  2157  width=15><b><font face="Helvetica, Arial"
  2158  ><font color="#00B04F"><font size="+1">
  2159      in
  2160  </font></font></font></b></td></tr></table>
  2161  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2162  The result is simply <em>image</em> cut by the shape of
  2163  <em>image window</em>.
  2164  None of the image data of image window is in the result.</td></tr></table>
  2165  <table BORDER=0 WIDTH="94%">
  2166  <tr>
  2167  <td width="3%"><br></td> 
  2168  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2169  <img SRC="images/right_triangle_option.png"
  2170  ALT=">" BORDER=0 height=14
  2171  width=15><b><font face="Helvetica, Arial"
  2172  ><font color="#00B04F"><font size="+1">
  2173      out
  2174  </font></font></font></b></td></tr></table>
  2175  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2176  The resulting image is <em>image</em> with the shape of
  2177  <em>image window</em>
  2178  cut out.</td></tr></table>
  2179  <table BORDER=0 WIDTH="94%">
  2180  <tr>
  2181  <td width="3%"><br></td> 
  2182  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2183  <img SRC="images/right_triangle_option.png"
  2184  ALT=">" BORDER=0 height=14
  2185  width=15><b><font face="Helvetica, Arial"
  2186  ><font color="#00B04F"><font size="+1">
  2187      atop
  2188  </font></font></font></b></td></tr></table>
  2189  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2190  The result is the same shape as <em>image window</em>, with
  2191  <em>image</em>
  2192  obscuring <em>image window</em> where the image shapes overlap. Note this
  2193  differs from over because the portion of image outside
  2194  <em>image window</em>'s
  2195  shape does not appear in the result.</td></tr></table>
  2196  <table BORDER=0 WIDTH="94%">
  2197  <tr>
  2198  <td width="3%"><br></td> 
  2199  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2200  <img SRC="images/right_triangle_option.png"
  2201  ALT=">" BORDER=0 height=14
  2202  width=15><b><font face="Helvetica, Arial"
  2203  ><font color="#00B04F"><font size="+1">
  2204      xor
  2205  </font></font></font></b></td></tr></table>
  2206  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2207  The result is the image data from both <em>image</em> and
  2208  <em>image window</em>
  2209  that is outside the overlap region. The overlap region is blank.</td></tr></table>
  2210  <table BORDER=0 WIDTH="94%">
  2211  <tr>
  2212  <td width="3%"><br></td> 
  2213  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2214  <img SRC="images/right_triangle_option.png"
  2215  ALT=">" BORDER=0 height=14
  2216  width=15><b><font face="Helvetica, Arial"
  2217  ><font color="#00B04F"><font size="+1">
  2218      plus
  2219  </font></font></font></b></td></tr></table>
  2220  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2221  The result is just the sum of the image data. Output values are cropped
  2222  to the maximum value (no overflow). This operation is independent of the
  2223  matte channels.</td></tr></table>
  2224  <table BORDER=0 WIDTH="94%">
  2225  <tr>
  2226  <td width="3%"><br></td> 
  2227  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2228  <img SRC="images/right_triangle_option.png"
  2229  ALT=">" BORDER=0 height=14
  2230  width=15><b><font face="Helvetica, Arial"
  2231  ><font color="#00B04F"><font size="+1">
  2232      minus
  2233  </font></font></font></b></td></tr></table>
  2234  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2235  The result of <em>image</em> - <em>image window</em>, with underflow cropped
  2236  to zero. The matte channel is ignored (set to opaque, full coverage).</td></tr></table>
  2237  <table BORDER=0 WIDTH="94%">
  2238  <tr>
  2239  <td width="3%"><br></td> 
  2240  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2241  <img SRC="images/right_triangle_option.png"
  2242  ALT=">" BORDER=0 height=14
  2243  width=15><b><font face="Helvetica, Arial"
  2244  ><font color="#00B04F"><font size="+1">
  2245      add
  2246  </font></font></font></b></td></tr></table>
  2247  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2248  The result of <em>image</em> + <em>image window</em>, with overflow wrapping
  2249  around (mod MaxRGB+1).</td></tr></table>
  2250  <table BORDER=0 WIDTH="94%">
  2251  <tr>
  2252  <td width="3%"><br></td> 
  2253  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2254  <img SRC="images/right_triangle_option.png"
  2255  ALT=">" BORDER=0 height=14
  2256  width=15><b><font face="Helvetica, Arial"
  2257  ><font color="#00B04F"><font size="+1">
  2258      subtract
  2259  </font></font></font></b></td></tr></table>
  2260  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2261  The result of <em>image</em> - <em>image window</em>, with underflow wrapping
  2262  around (mod MaxRGB+1). The add and subtract operators can be used to perform
  2263  reversible transformations.</td></tr></table>
  2264  <table BORDER=0 WIDTH="94%">
  2265  <tr>
  2266  <td width="3%"><br></td> 
  2267  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2268  <img SRC="images/right_triangle_option.png"
  2269  ALT=">" BORDER=0 height=14
  2270  width=15><b><font face="Helvetica, Arial"
  2271  ><font color="#00B04F"><font size="+1">
  2272      difference
  2273  </font></font></font></b></td></tr></table>
  2274  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2275  The result of abs(<em>image</em> - <em>image window</em>). This is useful for
  2276  comparing two very similar images.</td></tr></table>
  2277  <table BORDER=0 WIDTH="94%">
  2278  <tr>
  2279  <td width="3%"><br></td> 
  2280  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2281  <img SRC="images/right_triangle_option.png"
  2282  ALT=">" BORDER=0 height=14
  2283  width=15><b><font face="Helvetica, Arial"
  2284  ><font color="#00B04F"><font size="+1">
  2285      multiply
  2286  </font></font></font></b></td></tr></table>
  2287  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2288  The result of <em>image</em> * <em>image window</em>. This is useful for
  2289  the creation of drop-shadows.</td></tr></table>
  2290  <table BORDER=0 WIDTH="94%">
  2291  <tr>
  2292  <td width="3%"><br></td> 
  2293  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2294  <img SRC="images/right_triangle_option.png"
  2295  ALT=">" BORDER=0 height=14
  2296  width=15><b><font face="Helvetica, Arial"
  2297  ><font color="#00B04F"><font size="+1">
  2298      bumpmap
  2299  </font></font></font></b></td></tr></table>
  2300  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2301  The result of <em>image window</em> shaded by <em>window</em>.</td></tr></table>
  2302  <table BORDER=0 WIDTH="94%">
  2303  <tr>
  2304  <td width="3%"><br></td> 
  2305  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2306  <img SRC="images/right_triangle_option.png"
  2307  ALT=">" BORDER=0 height=14
  2308  width=15><b><font face="Helvetica, Arial"
  2309  ><font color="#00B04F"><font size="+1">
  2310      replace
  2311  </font></font></font></b></td></tr></table>
  2312  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>The resulting image is <em>image window</em> replaced with
  2313  <em>image</em>.
  2314  Here the matte information is ignored.</td></tr></table>
  2315  <p>
  2316  The image compositor requires a matte, or alpha channel in the image for
  2317  some operations. This extra channel usually defines a mask which represents
  2318  a sort of a cookie-cutter for the image. This is the case when matte is
  2319  255 (full coverage) for pixels inside the shape, zero outside, and between
  2320  zero and 255 on the boundary. If image does not have a matte channel, it
  2321  is initialized with 0 for any pixel matching in color to pixel location
  2322  (0,0), otherwise 255. See <a href="#disp-matt">Matte Editing</a> for a method
  2323  of defining a matte channel.
  2324  <p>
  2325  Note that matte information for image window is not retained for colormapped
  2326  X server visuals (e.g. <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>).
  2327  Correct compositing behavior may require a
  2328  <em>TrueColor</em> or <em>DirectColor</em>
  2329  visual or a <em>Standard Colormap</em>.
  2330  <p>
  2331  Choosing a composite operator is optional. The default operator is replace.
  2332  However, you must choose a location to composite your image and press button
  2333  1. Press and hold the button before releasing and an outline of the image
  2334  will appear to help you identify your location.
  2335  <p>
  2336  The actual colors of the pasted image is saved. However, the color that
  2337  appears in image window may be different. For example, on a monochrome
  2338  screen image window will appear black or white even though your pasted
  2339  image may have many colors. If the image is saved to a file it is written
  2340  with the correct colors. To assure the correct colors are saved in the
  2341  final image, any <em>PseudoClass</em> image is promoted to <em>DirectClass</em>.
  2342  To force a
  2343  <em>PseudoClass</em> image to remain <em>PseudoClass</em>,
  2344  use <strong>-colors</strong>.
  2345  </td></tr></table>
  2346       <p>
  2347  <i><a href="#top">Back to Contents</a></i> 
  2348  &nbsp;</p>
  2349  <table BORDER=0 WIDTH="100%"> 
  2350  <tr> 
  2351  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2352  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2353  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2354  color="#00B04F"><font size="+1">
  2355  <a NAME="disp-imcr"></a>Image Cropping
  2356  </font></font></font></b></td></tr></table>
  2357  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2358  <tr><td width="3%"><br></td><td>
  2359  <p>
  2360  To begin, press choose <strong>Crop</strong> of the <strong>Transform</strong> submenu from
  2361  the <a href="#disp-comm">Command widget</a>. Alternatively,
  2362  <a href="#disp-keyb">press</a> C in the image window.
  2363  <p>
  2364  A small window appears showing the location of the cursor in the image
  2365  window. You are now in crop mode. In crop mode, the Command widget has
  2366  these options:
  2367  <ul>
  2368  <li><strong>Help</strong>
  2369  <li><strong>Dismiss</strong>
  2370  </ul>
  2371  <p>
  2372  To define a cropping region, press button 1 and drag. The cropping region
  2373  is defined by a highlighted rectangle that expands or contracts as it follows
  2374  the pointer. Once you are satisfied with the cropping region, release the
  2375  button. You are now in rectify mode. In rectify mode, the Command widget
  2376  has these options:
  2377  <ul>
  2378  <li><strong>Crop</strong>
  2379  <li><strong>Help</strong>
  2380  <li><strong>Dismiss</strong>
  2381  </ul>
  2382  <p>
  2383  You can make adjustments by moving the pointer to one of the cropping rectangle
  2384  corners, pressing a button, and dragging. Finally, press Crop to commit
  2385  your cropping region. To exit without cropping the image, press Dismiss.
  2386  </td></tr></table>
  2387       <p>
  2388  <i><a href="#top">Back to Contents</a></i> 
  2389  &nbsp;</p>
  2390  <table BORDER=0 WIDTH="100%"> 
  2391  <tr> 
  2392  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2393  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2394  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2395  color="#00B04F"><font size="+1">
  2396  <a NAME="disp-imch"></a>Image Chopping
  2397  </font></font></font></b></td></tr></table>
  2398  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2399  <tr><td width="3%"><br></td><td>
  2400  <p>
  2401  An image is chopped interactively. There is no command line argument to
  2402  chop an image. To begin, choose <strong>Chop</strong> of the <strong>Transform</strong> sub-menu
  2403  from the <a href="#disp-comm">Command widget</a>. Alternatively,
  2404  <a href="#disp-keyb">press</a> [ in the Image window.
  2405  <p>
  2406  You are now in <strong>Chop</strong> mode. To exit immediately, press
  2407  <strong>Dismiss</strong>.
  2408  In Chop mode, the Command widget has these options:
  2409  <ul>
  2410  <li><strong>Direction</strong>
  2411  <ul>
  2412  <li>horizontal
  2413  <li>vertical
  2414  </ul>
  2415  <li><strong>Help</strong>
  2416  <li><strong>Dismiss</strong>
  2417  </ul>
  2418  <p>
  2419  If the you choose the horizontal direction (this is the default), the area
  2420  of the image between the two horizontal endpoints of the chop line is removed.
  2421  Otherwise, the area of the image between the two vertical endpoints of
  2422  the chop line is removed.
  2423  <p>
  2424  Select a location within the image window to begin your chop, press and
  2425  hold any button. Next, move the pointer to another location in the image.
  2426  As you move a line will connect the initial location and the pointer. When
  2427  you release the button, the area within the image to chop is determined
  2428  by which direction you choose from the Command widget.
  2429  <p>
  2430  To cancel the image chopping, move the pointer back to the starting point
  2431  of the line and release the button.
  2432  </td></tr></table>
  2433       <p>
  2434  <i><a href="#top">Back to Contents</a></i> 
  2435  &nbsp;</p>
  2436  <table BORDER=0 WIDTH="100%"> 
  2437  <tr> 
  2438  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2439  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2440  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2441  color="#00B04F"><font size="+1">
  2442  <a NAME="disp-imro"></a>Image Rotation
  2443  </font></font></font></b></td></tr></table>
  2444  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2445  <tr><td width="3%"><br></td><td>
  2446  <p>
  2447  Press the / key to rotate the image 90 degrees or \ to rotate -90 degrees.
  2448  To interactively choose the degree of rotation, choose
  2449  <strong>Rotate...</strong>
  2450  of the <strong>Transform</strong> submenu from the <a href="#disp-comm">Command Widget</a>.
  2451  Alternatively, <a href="#disp-keyb">press</a> * in the image window.
  2452  <p>
  2453  A small horizontal line is drawn next to the pointer. You are now in rotate
  2454  mode. To exit immediately, press Dismiss. In rotate mode, the Command widget
  2455  has these options:
  2456  <ul>
  2457  <li><strong>Pixel Color</strong>
  2458  <ul>
  2459  <li>black
  2460  <li>blue
  2461  <li>cyan
  2462  <li>green
  2463  <li>gray
  2464  <li>red
  2465  <li>magenta
  2466  <li>yellow
  2467  <li>white
  2468  <li>Browser...
  2469  </ul>
  2470  <li><strong>Direction</strong>
  2471  <ul>
  2472  <li>horizontal
  2473  <li>vertical
  2474  </ul>
  2475  <li><strong>Help</strong>
  2476  <li><strong>Dismiss</strong>
  2477  </ul>
  2478  <p>
  2479  Choose a background color from the Pixel Color sub-menu. Additional background
  2480  colors can be specified with the color browser. You can change the menu
  2481  colors by setting the <a href="#disp-xres">X resources</a> pen1 through pen9.
  2482  <p>
  2483  If you choose the color browser and press <strong>Grab</strong>, you can select the
  2484  background color by moving the pointer to the desired color on the screen
  2485  and press any button.
  2486  <p>
  2487  Choose a point in the image window and press this button and hold. Next,
  2488  move the pointer to another location in the image. As you move a line connects
  2489  the initial location and the pointer. When you release the button, the
  2490  degree of image rotation is determined by the slope of the line you just
  2491  drew. The slope is relative to the direction you choose from the Direction
  2492  sub-menu of the Command widget.
  2493  <p>
  2494  To cancel the image rotation, move the pointer back to the starting point
  2495  of the line and release the button.
  2496  </td></tr></table>
  2497       <p>
  2498  <i><a href="#top">Back to Contents</a></i> 
  2499  &nbsp;</p>
  2500  <table BORDER=0 WIDTH="100%"> 
  2501  <tr> 
  2502  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2503  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2504  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2505  color="#00B04F"><font size="+1">
  2506  <a NAME="disp-segm"></a>Image Segmentation
  2507  </font></font></font></b></td></tr></table>
  2508  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2509  <tr><td width="3%"><br></td><td>
  2510  <p>
  2511  Choose <strong>Effects-&gt;Segment</strong> to segment an image by analyzing the histograms
  2512  of the color components and identifying units that are homogeneous with
  2513  the fuzzy c-means technique. The scale-space filter analyzes the histograms
  2514  of the three color components of the image and identifies a set of classes.
  2515  The extents of each class is used to coarsely segment the image with thresholding.
  2516  The color associated with each class is determined by the mean color of
  2517  all pixels within the extents of a particular class. Finally, any unclassified
  2518  pixels are assigned to the closest class with the fuzzy c-means technique.
  2519  <p>The fuzzy c-Means algorithm can be summarized as follows:
  2520  <ul>
  2521  <li>
  2522  Build a histogram, one for each color component of the image.
  2523  <li>
  2524  For each histogram, successively apply the scale-space filter and build
  2525  an interval tree of zero crossings in the second derivative at each scale.
  2526  Analyze this scale-space "fingerprint" to determine which peaks or valleys
  2527  in the histogram are most predominant.
  2528  <li>
  2529  The fingerprint defines intervals on the axis of the histogram. Each interval
  2530  contains either a minima or a maxima in the original signal. If each color
  2531  component lies within the maxima interval, that pixel is considered "classified"
  2532  and is assigned an unique class number.
  2533  <li>
  2534  Any pixel that fails to be classified in the above thresholding pass is
  2535  classified using the fuzzy c-Means technique. It is assigned to one of
  2536  the classes discovered in the histogram analysis phase.
  2537  </ul>
  2538  <p>
  2539  The fuzzy c-Means technique attempts to cluster a pixel by finding the
  2540  local minima of the generalized within group sum of squared error objective
  2541  function. A pixel is assigned to the closest class of which the fuzzy membership
  2542  has a maximum value.
  2543  <p>
  2544  For additional information see:
  2545  <blockquote><em>Young Won Lim, Sang Uk Lee</em>, "<strong>On The Color Image Segmentation
  2546  Algorithm Based on the Thresholding and the Fuzzy c-Means Techniques</strong>",
  2547  Pattern Recognition, Volume 23, Number 9, pages 935-952, 1990.</blockquote>
  2548  <br>&nbsp;<br>
  2549  </td></tr></table>
  2550       <p>
  2551  <i><a href="#top">Back to Contents</a></i> 
  2552  &nbsp;</p>
  2553  <table BORDER=0 WIDTH="100%"> 
  2554  <tr> 
  2555  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2556  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2557  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2558  color="#00B04F"><font size="+1">
  2559  <a NAME="disp-iman"></a>Image Annotation
  2560  </font></font></font></b></td></tr></table>
  2561  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2562  <tr><td width="3%"><br></td><td>
  2563  <p>
  2564  An image is annotated interactively. There is no command line argument
  2565  to annotate an image. To begin, choose
  2566  <strong>Annotate</strong> of the <strong>Image
  2567  Edit</strong> sub-menu from the <a href="#disp-comm">Command widget</a>. Alternatively,
  2568  <a href="#disp-keyb">press</a> a in the image window.
  2569  <p>
  2570  A small window appears showing the location of the cursor in the image
  2571  window. You are now in annotate mode. To exit immediately, press Dismiss.
  2572  In annotate mode, the Command widget has these options:
  2573  <ul>
  2574  <li>
  2575  <strong>Font Name</strong>
  2576  <ul>
  2577  <li>
  2578  fixed
  2579  <li>
  2580  variable
  2581  <li>
  2582  5x8
  2583  <li>
  2584  6x10
  2585  <li>
  2586  7x13bold
  2587  <li>
  2588  8x13bold
  2589  <li>
  2590  9x15bold
  2591  <li>
  2592  10x20
  2593  <li>
  2594  12x24
  2595  <li>
  2596  Browser...
  2597  </ul>
  2598  <li>
  2599  <strong>Font Color</strong>
  2600  <ul>
  2601  <li>
  2602  black
  2603  <li>
  2604  blue
  2605  <li>
  2606  cyan
  2607  <li>
  2608  green
  2609  <li>
  2610  gray
  2611  <li>
  2612  red
  2613  <li>
  2614  magenta
  2615  <li>
  2616  yellow
  2617  <li>
  2618  white
  2619  <li>
  2620  transparent
  2621  <li>
  2622  Browser...
  2623  </ul>
  2624  <li>
  2625  <strong>Box Color</strong>
  2626  <ul>
  2627  <li>
  2628  black
  2629  <li>
  2630  blue
  2631  <li>
  2632  cyan
  2633  <li>
  2634  green
  2635  <li>
  2636  gray
  2637  <li>
  2638  red
  2639  <li>
  2640  magenta
  2641  <li>
  2642  yellow
  2643  <li>
  2644  white
  2645  <li>
  2646  transparent
  2647  <li>
  2648  Browser...
  2649  </ul>
  2650  <li>
  2651  <strong>Rotate Text</strong>
  2652  <ul>
  2653  <li>
  2654  -90
  2655  <li>
  2656  -45
  2657  <li>
  2658  -30
  2659  <li>
  2660  0
  2661  <li>
  2662  30
  2663  <li>
  2664  45
  2665  <li>
  2666  90
  2667  <li>
  2668  180
  2669  <li>
  2670  Dialog...
  2671  </ul>
  2672  <li>
  2673  <strong>Help</strong>
  2674  <li>
  2675  <strong>Dismiss</strong>
  2676  </ul>
  2677  <p>
  2678  Choose a font name from the <strong>Font Name</strong> sub-menu. Additional font
  2679  names can be specified with the font browser. You can change the menu names
  2680  by setting the <a href="#disp-xres">X resources</a> font1 through font9.
  2681  <p>
  2682  Choose a font color from the <strong>Font Color</strong> sub-menu. Additional font
  2683  colors can be specified with the color browser. You can change the menu
  2684  colors by setting the <a href="#disp-xres">X resources</a> pen1 through pen9.
  2685  <p>
  2686  If you select the color browser and press <strong>Grab</strong>, you can choose the
  2687  font color by moving the pointer to the desired color on the screen and
  2688  press any button.
  2689  <p>
  2690  If you choose to rotate the text, choose <strong>Rotate Text</strong> from the menu
  2691  and select an angle. Typically you will only want to rotate one line of
  2692  text at a time. Depending on the angle you choose, subsequent lines may
  2693  end up overwriting each other.
  2694  <p>
  2695  Choosing a font and its color is optional. The default font is fixed and
  2696  the default color is black. However, you must choose a location to begin
  2697  entering text and press a button. An underscore character will appear at
  2698  the location of the pointer. The cursor changes to a pencil to indicate
  2699  you are in text mode. To exit immediately, press Dismiss.
  2700  <p>
  2701  In text mode, any key presses will display the character at the location
  2702  of the underscore and advance the underscore cursor. Enter your text and
  2703  once completed press Apply to finish your image annotation. To correct
  2704  errors press <strong>BACK SPACE</strong>. To delete an entire line of text, press
  2705  <strong>DELETE</strong>.
  2706  Any text that exceeds the boundaries of the image window is automatically
  2707  continued onto the next line.
  2708  <p>
  2709  The actual color you request for the font is saved in the image. However,
  2710  the color that appears in your Image window may be different. For example,
  2711  on a monochrome screen the text will appear black or white even if you
  2712  choose the color red as the font color. However, the image saved to a file
  2713  with <strong>-write</strong> is written with red lettering. To assure the correct
  2714  color text in the final image, any <em>PseudoClass</em> image is promoted
  2715  to <em>DirectClass</em> (see miff(5)). To force a <em>PseudoClass</em> image
  2716  to remain
  2717  <em>PseudoClass</em>, use <strong>-colors</strong>.
  2718  </td></tr></table>
  2719       <p>
  2720  <i><a href="#top">Back to Contents</a></i> 
  2721  &nbsp;</p>
  2722  <table BORDER=0 WIDTH="100%"> 
  2723  <tr> 
  2724  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  2725  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  2726  height=14 width=15><b><font face="Helvetica, Arial"><font 
  2727  color="#00B04F"><font size="+1">
  2728  <a NAME="disp-imcomp"></a>Image Compositing
  2729  </font></font></font></b></td></tr></table>
  2730  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  2731  <tr><td width="3%"><br></td><td>
  2732  <p>
  2733  An image composite is created interactively. <strong>There is no command line
  2734  argument to composite an image</strong>. To begin, choose <strong>Composite</strong> of
  2735  the <strong>Image Edit</strong> from the <a href="#disp-comm">Command widget</a>. Alternatively,
  2736  <a href="#disp-keyb">press</a> x in the Image window.
  2737  <p>
  2738  First a popup window is displayed requesting you to enter an image name.
  2739  Press <strong>Composite</strong>, <strong>Grab</strong> or type a file name. Press <strong>Cancel</strong>
  2740  if you choose not to create a composite image. When you choose <strong>Grab</strong>,
  2741  move the pointer to the desired window and press any button.
  2742  <p>
  2743  If the <strong>Composite</strong> image does not have any matte information, you
  2744  are informed and the file browser is displayed again. Enter the name of
  2745  a mask image. The image is typically grayscale and the same size as the
  2746  composite image. If the image is not grayscale, it is converted to grayscale
  2747  and the resulting intensities are used as matte information.
  2748  <p>
  2749  A small window appears showing the location of the cursor in the image
  2750  window. You are now in composite mode. To exit immediately, press Dismiss.
  2751  In composite mode, the Command widget has these options:
  2752  <ul>
  2753  <li>
  2754  <strong>Operators</strong>
  2755  <ul>
  2756  <li>
  2757  over
  2758  <li>
  2759  in
  2760  <li>
  2761  out
  2762  <li>
  2763  atop
  2764  <li>
  2765  xor
  2766  <li>
  2767  plus
  2768  <li>
  2769  minus
  2770  <li>
  2771  add
  2772  <li>
  2773  subtract
  2774  <li>
  2775  difference
  2776  <li>
  2777  bumpmap
  2778  <li>
  2779  replace
  2780  </ul>
  2781  <li>
  2782  <strong>Blend</strong>
  2783  <li>
  2784  <strong>Displace</strong>
  2785  <li>
  2786  <strong>Help</strong>
  2787  <li>
  2788  <strong>Dismiss</strong>
  2789  </ul>
  2790  <p>
  2791  Choose a composite operation from the Operators sub-menu of the Command
  2792  widget. How each operator behaves is described below. image window is the
  2793  image currently displayed on your X server and image is the image obtained
  2794  <table BORDER=0 WIDTH="94%">
  2795  <tr>
  2796  <td width="3%"><br></td> 
  2797  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2798  <img SRC="images/right_triangle_option.png"
  2799  ALT=">" BORDER=0 height=14
  2800  width=15><b><font face="Helvetica, Arial"
  2801  ><font color="#00B04F"><font size="+1">
  2802      over
  2803  </font></font></font></b></td></tr></table>
  2804  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2805  The result is the union of the two image shapes, with <em>image</em> obscuring
  2806  <em>image
  2807  window</em> in the region of overlap.</td></tr></table>
  2808  <table BORDER=0 WIDTH="94%">
  2809  <tr>
  2810  <td width="3%"><br></td> 
  2811  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2812  <img SRC="images/right_triangle_option.png"
  2813  ALT=">" BORDER=0 height=14
  2814  width=15><b><font face="Helvetica, Arial"
  2815  ><font color="#00B04F"><font size="+1">
  2816      in
  2817  </font></font></font></b></td></tr></table>
  2818  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2819  The result is simply <em>image</em> cut by the shape of
  2820  <em>image window</em>.
  2821  None of the image data of image window is in the result.</td></tr></table>
  2822  <table BORDER=0 WIDTH="94%">
  2823  <tr>
  2824  <td width="3%"><br></td> 
  2825  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2826  <img SRC="images/right_triangle_option.png"
  2827  ALT=">" BORDER=0 height=14
  2828  width=15><b><font face="Helvetica, Arial"
  2829  ><font color="#00B04F"><font size="+1">
  2830      out
  2831  </font></font></font></b></td></tr></table>
  2832  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2833  The resulting image is <em>image</em> with the shape of
  2834  <em>image window</em>
  2835  cut out.</td></tr></table>
  2836  <table BORDER=0 WIDTH="94%">
  2837  <tr>
  2838  <td width="3%"><br></td> 
  2839  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2840  <img SRC="images/right_triangle_option.png"
  2841  ALT=">" BORDER=0 height=14
  2842  width=15><b><font face="Helvetica, Arial"
  2843  ><font color="#00B04F"><font size="+1">
  2844      atop
  2845  </font></font></font></b></td></tr></table>
  2846  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2847  The result is the same shape as <em>image window</em>, with
  2848  <em>image</em>
  2849  obscuring <em>image window</em> where the image shapes overlap. Note this
  2850  differs from over because the portion of image outside
  2851  <em>image window</em>'s
  2852  shape does not appear in the result.</td></tr></table>
  2853  <table BORDER=0 WIDTH="94%">
  2854  <tr>
  2855  <td width="3%"><br></td> 
  2856  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2857  <img SRC="images/right_triangle_option.png"
  2858  ALT=">" BORDER=0 height=14
  2859  width=15><b><font face="Helvetica, Arial"
  2860  ><font color="#00B04F"><font size="+1">
  2861      xor
  2862  </font></font></font></b></td></tr></table>
  2863  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2864  The result is the image data from both <em>image</em> and
  2865  <em>image window</em>
  2866  that is outside the overlap region. The overlap region is blank.</td></tr></table>
  2867  <table BORDER=0 WIDTH="94%">
  2868  <tr>
  2869  <td width="3%"><br></td> 
  2870  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2871  <img SRC="images/right_triangle_option.png"
  2872  ALT=">" BORDER=0 height=14
  2873  width=15><b><font face="Helvetica, Arial"
  2874  ><font color="#00B04F"><font size="+1">
  2875      plus
  2876  </font></font></font></b></td></tr></table>
  2877  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2878  The result is just the sum of the image data. Output values are cropped
  2879  to 255 (no overflow). This operation is independent of the matte channels.</td></tr></table>
  2880  <table BORDER=0 WIDTH="94%">
  2881  <tr>
  2882  <td width="3%"><br></td> 
  2883  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2884  <img SRC="images/right_triangle_option.png"
  2885  ALT=">" BORDER=0 height=14
  2886  width=15><b><font face="Helvetica, Arial"
  2887  ><font color="#00B04F"><font size="+1">
  2888      minus
  2889  </font></font></font></b></td></tr></table>
  2890  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2891  The result of <em>image</em> - <em>image window</em>, with underflow cropped
  2892  to zero. The matte channel is ignored (set to 255, full coverage).</td></tr></table>
  2893  <table BORDER=0 WIDTH="94%">
  2894  <tr>
  2895  <td width="3%"><br></td> 
  2896  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2897  <img SRC="images/right_triangle_option.png"
  2898  ALT=">" BORDER=0 height=14
  2899  width=15><b><font face="Helvetica, Arial"
  2900  ><font color="#00B04F"><font size="+1">
  2901      add
  2902  </font></font></font></b></td></tr></table>
  2903  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2904  The result of <em>image</em> + <em>image window</em>, with overflow wrapping
  2905  around (mod 256).</td></tr></table>
  2906  <table BORDER=0 WIDTH="94%">
  2907  <tr>
  2908  <td width="3%"><br></td> 
  2909  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2910  <img SRC="images/right_triangle_option.png"
  2911  ALT=">" BORDER=0 height=14
  2912  width=15><b><font face="Helvetica, Arial"
  2913  ><font color="#00B04F"><font size="+1">
  2914      subtract
  2915  </font></font></font></b></td></tr></table>
  2916  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2917  The result of <em>image</em> - <em>image window</em>, with underflow wrapping
  2918  around (mod 256). The add and subtract operators can be used to perform
  2919  reversible transformations.</td></tr></table>
  2920  <table BORDER=0 WIDTH="94%">
  2921  <tr>
  2922  <td width="3%"><br></td> 
  2923  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2924  <img SRC="images/right_triangle_option.png"
  2925  ALT=">" BORDER=0 height=14
  2926  width=15><b><font face="Helvetica, Arial"
  2927  ><font color="#00B04F"><font size="+1">
  2928      difference
  2929  </font></font></font></b></td></tr></table>
  2930  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2931  The result of abs(<em>image</em> - <em>image window</em>). This is useful for
  2932  comparing two very similar images.</td></tr></table>
  2933  <table BORDER=0 WIDTH="94%">
  2934  <tr>
  2935  <td width="3%"><br></td> 
  2936  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2937  <img SRC="images/right_triangle_option.png"
  2938  ALT=">" BORDER=0 height=14
  2939  width=15><b><font face="Helvetica, Arial"
  2940  ><font color="#00B04F"><font size="+1">
  2941      bumpmap
  2942  </font></font></font></b></td></tr></table>
  2943  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2944  The result of <em>image window</em> shaded by <em>window</em>.</td></tr></table>
  2945  <table BORDER=0 WIDTH="94%">
  2946  <tr>
  2947  <td width="3%"><br></td> 
  2948  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
  2949  <img SRC="images/right_triangle_option.png"
  2950  ALT=">" BORDER=0 height=14
  2951  width=15><b><font face="Helvetica, Arial"
  2952  ><font color="#00B04F"><font size="+1">
  2953      replace
  2954  </font></font></font></b></td></tr></table>
  2955  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>
  2956  The resulting image is <em>image window</em> replaced with
  2957  <em>image</em>.
  2958  Here the matte information is ignored.</td></tr></table>
  2959  <p>
  2960  The image compositor requires a matte, or alpha channel in the image for
  2961  some operations. This extra channel usually defines a mask which represents
  2962  a sort of a cookie-cutter for the image. This is the case when matte is
  2963  255 (full coverage) for pixels inside the shape, zero outside, and between
  2964  zero and 255 on the boundary. If image does not have a matte channel, it
  2965  is initialized with 0 for any pixel matching in color to pixel location
  2966  (0,0), otherwise 255. See <a href="#disp-matt">Matte Editing</a> for a method
  2967  of defining a matte channel.
  2968  <p>
  2969  If you choose <strong>blend</strong>, the composite operator becomes <strong>over</strong>.
  2970  The image matte channel percent transparency is initialized to factor.
  2971  The image window is initialized to (100-factor). Where factor is the value
  2972  you specify in the Dialog widget.
  2973  <p>
  2974  <strong>Displace</strong> shifts the image pixels as defined by a displacement map.
  2975  With this option, <em>image</em> is used as a displacement map. Black, within
  2976  the displacement map, is a maximum positive displacement. White is a maximum
  2977  negative displacement and middle gray is neutral. The displacement is scaled
  2978  to determine the pixel shift. By default, the displacement applies in both
  2979  the horizontal and vertical directions. However, if you specify
  2980  <em>mask</em>,
  2981  <em>image</em>
  2982  is the horizontal X displacement and
  2983  <em>mask</em> the vertical Y displacement.
  2984  <p>
  2985  Note that matte information for image window is not retained for colormapped
  2986  X server visuals (e.g.
  2987  <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>).
  2988  Correct compositing behavior may require a <em>TrueColor</em> or
  2989  <em>DirectColor</em>
  2990  visual or a <em>Standard Colormap</em>.
  2991  <p>
  2992  Choosing a composite operator is optional. The default operator is replace.
  2993  However, you must choose a location to composite your image and press button
  2994  1. Press and hold the button before releasing and an outline of the image
  2995  will appear to help you identify your location.
  2996  <p>
  2997  The actual colors of the composite image is saved. However, the color that
  2998  appears in image window may be different. For example, on a monochrome
  2999  screen Image window will appear black or white even though your composited
  3000  image may have many colors. If the image is saved to a file it is written
  3001  with the correct colors. To assure the correct colors are saved in the
  3002  final image, any PseudoClass image is promoted to <em>DirectClass</em> (see
  3003  <a href="miff.html">miff</a>).
  3004  To force a <em>PseudoClass</em> image to remain <em>PseudoClass</em>,
  3005  use <strong>-colors</strong>.
  3006  </td></tr></table>
  3007       <p>
  3008  <i><a href="#top">Back to Contents</a></i> 
  3009  &nbsp;</p>
  3010  <table BORDER=0 WIDTH="100%"> 
  3011  <tr> 
  3012  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  3013  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  3014  height=14 width=15><b><font face="Helvetica, Arial"><font 
  3015  color="#00B04F"><font size="+1">
  3016  <a NAME="disp-cole"></a>Color Editing
  3017  </font></font></font></b></td></tr></table>
  3018  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  3019  <tr><td width="3%"><br></td><td>
  3020  <p>
  3021  Changing the the color of a set of pixels is performed interactively. There
  3022  is no command line argument to edit a pixel. To begin, choose <strong>Color</strong>
  3023  from the <strong>Image Edit</strong> submenu of the <a href="#disp-comm">Command widget</a>.
  3024  Alternatively, <a href="#disp-keyb">press</a> c in the image window.
  3025  <p>
  3026  A small window appears showing the location of the cursor in the image
  3027  window. You are now in color edit mode. To exit immediately, press <strong>Dismiss</strong>.
  3028  In color edit mode, the
  3029  <strong>Command widget</strong> has these options:
  3030  <ul>
  3031  <li>
  3032  <strong>Method</strong>
  3033  <ul>
  3034  <li>
  3035  point
  3036  <li>
  3037  replace
  3038  <li>
  3039  floodfill
  3040  <li>
  3041  reset
  3042  </ul>
  3043  <li>
  3044  <strong>Pixel Color</strong>
  3045  <ul>
  3046  <li>
  3047  black
  3048  <li>
  3049  blue
  3050  <li>
  3051  cyan
  3052  <li>
  3053  green
  3054  <li>
  3055  gray
  3056  <li>
  3057  red
  3058  <li>
  3059  magenta
  3060  <li>
  3061  yellow
  3062  <li>
  3063  white
  3064  <li>
  3065  Browser...
  3066  </ul>
  3067  <li>
  3068  <strong>Border Color</strong>
  3069  <ul>
  3070  <li>
  3071  black
  3072  <li>
  3073  blue
  3074  <li>
  3075  cyan
  3076  <li>
  3077  green
  3078  <li>
  3079  gray
  3080  <li>
  3081  red
  3082  <li>
  3083  magenta
  3084  <li>
  3085  yellow
  3086  <li>
  3087  white
  3088  <li>
  3089  Browser...
  3090  </ul>
  3091  <li>
  3092  <strong>Fuzz</strong>
  3093  <ul>
  3094  <li>
  3095  0
  3096  <li>
  3097  2
  3098  <li>
  3099  4
  3100  <li>
  3101  8
  3102  <li>
  3103  16
  3104  <li>Dialog...
  3105  </ul>
  3106  <li>
  3107  <strong>Undo</strong>
  3108  <li>
  3109  <strong>Help</strong>
  3110  <li>
  3111  <strong>Dismiss</strong>
  3112  </ul>
  3113  <p>
  3114  Choose a color editing method from the <strong>Method</strong> sub-menu of
  3115  the <a href="#disp-comm">Command
  3116  widget</a>. The <strong>point method</strong> recolors any pixel selected with the
  3117  pointer unless the button is released. The <strong>replace method</strong> recolors
  3118  any pixel that matches the color of the pixel you select with a button
  3119  press. <strong>Floodfill</strong> recolors any pixel that matches the color of the
  3120  pixel you select with a button press and is a neighbor.
  3121  Whereas <strong>filltoborder</strong>
  3122  changes the matte value of any neighbor pixel that is not the border color.
  3123  Finally <strong>reset</strong> changes the entire image to the designated color.
  3124  <p>
  3125  Next, choose a pixel color from the <strong>Pixel Color</strong> sub-menu. Additional
  3126  pixel colors can be specified with the color browser. You can change the
  3127  menu colors by setting the <a href="#disp-xres">X resources</a> pen1 through
  3128  pen9.
  3129  <p>
  3130  Now press button 1 to select a pixel within the Image window to change
  3131  its color. Additional pixels may be recolored as prescribed by the method
  3132  you choose. additional pixels by increasing the Delta value.
  3133  <p>
  3134  If the <strong>Magnify widget</strong> is mapped, it can be helpful in positioning
  3135  your pointer within the image (refer to button 2). Alternatively you can
  3136  select a pixel to recolor from within the <strong>Magnify widget</strong>. Move the
  3137  pointer to the <strong>Magnify widget</strong> and position the pixel with the cursor
  3138  control keys. Finally, press a button to recolor the selected pixel (or
  3139  pixels).
  3140  <p>
  3141  The actual color you request for the pixels is saved in the image. However,
  3142  the color that appears in your Image window may be different. For example,
  3143  on a monochrome screen the pixel will appear black or white even if you
  3144  choose the color red as the pixel color. However, the image saved to a
  3145  file with -write is written with red pixels. To assure the correct color
  3146  text in the final image, any <em>PseudoClass</em> image is promoted
  3147  to <em>DirectClass</em>
  3148  To force a <em>PseudoClass</em> image to remain
  3149  <em>PseudoClass</em>, use <strong>-colors</strong>.
  3150  </td></tr></table>
  3151       <p>
  3152  <i><a href="#top">Back to Contents</a></i> 
  3153  &nbsp;</p>
  3154  <table BORDER=0 WIDTH="100%"> 
  3155  <tr> 
  3156  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  3157  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  3158  height=14 width=15><b><font face="Helvetica, Arial"><font 
  3159  color="#00B04F"><font size="+1">
  3160  <a NAME="disp-matt"></a>Matte Editing
  3161  </font></font></font></b></td></tr></table>
  3162  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  3163  <tr><td width="3%"><br></td><td>
  3164  <p>
  3165  Matte information within an image is useful for some operations such as
  3166  image <a href="#disp-imcomp">compositing</a>. This extra channel usually defines
  3167  a mask which represents a sort of a cookie-cutter for the image. This is
  3168  the case when matte is 255 (full coverage) for pixels inside the shape,
  3169  zero outside, and between zero and 255 on the boundary.
  3170  <p>
  3171  Setting the matte information in an image is done interactively. There
  3172  is no command line argument to edit a pixel. To begin, and choose <strong>Matte</strong>
  3173  of the <strong>Image Edit</strong> sub-menu from the <a href="#disp-comm">Command widget</a>.
  3174  <p>
  3175  Alternatively, <a href="#disp-keyb">press</a> m in the image window.
  3176  <p>
  3177  A small window appears showing the location of the cursor in the image
  3178  window. You are now in matte edit mode. To exit immediately, press Dismiss.
  3179  In matte edit mode, the Command widget has these options:
  3180  <ul>
  3181  <li>
  3182  <strong>Method</strong>
  3183  <ul>
  3184  <li>
  3185  point
  3186  <li>
  3187  replace
  3188  <li>
  3189  floodfill
  3190  <li>
  3191  reset
  3192  </ul>
  3193  <li>
  3194  <strong>Border Color</strong>
  3195  <ul>
  3196  <li>
  3197  black
  3198  <li>
  3199  blue
  3200  <li>
  3201  cyan
  3202  <li>
  3203  green
  3204  <li>
  3205  gray
  3206  <li>
  3207  red
  3208  <li>
  3209  magenta
  3210  <li>
  3211  yellow
  3212  <li>
  3213  white
  3214  <li>
  3215  Browser...
  3216  </ul>
  3217  <li>
  3218  <strong>Fuzz</strong>
  3219  <ul>
  3220  <li>
  3221  0
  3222  <li>
  3223  2
  3224  <li>
  3225  4
  3226  <li>
  3227  8
  3228  <li>
  3229  16
  3230  <li>Dialog...
  3231  </ul>
  3232  <li>
  3233  <strong>Matte</strong>
  3234  <li>
  3235  <strong>Undo</strong>
  3236  <li>
  3237  <strong>Help</strong>
  3238  <li>
  3239  <strong>Dismiss</strong>
  3240  </ul>
  3241  Choose a matte editing method from the <strong>Method</strong> sub-menu of the <a href="#disp-comm">Command
  3242  widget</a>. The <strong>point method</strong> changes the matte value of the any
  3243  pixel selected with the pointer until the button is released. The <strong>replace
  3244  method</strong> changes the matte value of any pixel that matches the color
  3245  of the pixel you select with a button press. <strong>Floodfill</strong> changes the
  3246  matte value of any pixel that matches the color of the pixel you select
  3247  with a button press and is a neighbor. Whereas
  3248  <strong>filltoborder</strong> recolors
  3249  any neighbor pixel that is not the border color. Finally <strong>reset</strong> changes
  3250  the entire image to the designated matte value.
  3251  <p>Choose <strong>Matte Value</strong> and a dialog appears requesting a matte value.
  3252  Enter a value between <strong>0 and 255</strong>. This value is assigned as the matte
  3253  value of the selected pixel or pixels.
  3254  <p>Now, press any button to select a pixel within the Image window to change
  3255  its matte value. You can change the matte value of additional pixels by
  3256  increasing the Delta value. The Delta value is first added then subtracted
  3257  from the red, green, and blue of the target color. Any pixels within the
  3258  range also have their matte value updated.
  3259  <p>If the <strong>Magnify widget</strong> is mapped, it can be helpful in positioning
  3260  your pointer within the image (refer to button 2). Alternatively you can
  3261  select a pixel to change the matte value from within the
  3262  <strong>Magnify widget</strong>.
  3263  Move the pointer to the <strong>Magnify widget</strong> and position the pixel with
  3264  the cursor control keys. Finally, press a button to change the matte value
  3265  of the selected pixel (or pixels).
  3266  <p>Matte information is only valid in a <em>DirectClass image</em>. Therefore,
  3267  any <em>PseudoClass</em> image is promoted to
  3268  <em>DirectClass</em>. Note that
  3269  matte information for <em>PseudoClass</em> is not retained for colormapped
  3270  X server visuals (e.g. <em>StaticColor, StaticColor, GrayScale, PseudoColor</em>)
  3271  unless you immediately save your image to a file (refer to Write). Correct
  3272  matte editing behavior may require a <em>TrueColor</em> or <em>DirectColor</em>
  3273  visual or a <em>Standard Colormap</em>.
  3274  </td></tr></table>
  3275       <p>
  3276  <i><a href="#top">Back to Contents</a></i> 
  3277  &nbsp;</p>
  3278  <table BORDER=0 WIDTH="100%"> 
  3279  <tr> 
  3280  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  3281  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  3282  height=14 width=15><b><font face="Helvetica, Arial"><font 
  3283  color="#00B04F"><font size="+1">
  3284  <a NAME="disp-imdr"></a>Image Drawing
  3285  </font></font></font></b></td></tr></table>
  3286  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  3287  <tr><td width="3%"><br></td><td>
  3288  <p>
  3289  An image is drawn upon interactively. <strong>There is no command line argument
  3290  to draw on an image</strong>. To begin, choose <strong>Draw</strong> of the Image <strong>Edit</strong>
  3291  sub-menu from the <a href="#disp-comm">Command widget</a>.
  3292  Alternatively, <a href="#disp-keyb">press</a> d in the image window.
  3293  <p>
  3294  The cursor changes to a crosshair to indicate you are in draw mode. To
  3295  exit immediately, press Dismiss. In draw mode, the Command widget has these
  3296  options:
  3297  <ul>
  3298  <li>
  3299  <strong>Primitive</strong>
  3300  <ul>
  3301  <li>
  3302  point
  3303  <li>
  3304  line
  3305  <li>
  3306  rectangle
  3307  <li>
  3308  fill rectangle
  3309  <li>
  3310  circle
  3311  <li>
  3312  fill circle
  3313  <li>
  3314  ellipse
  3315  <li>
  3316  fill ellipse
  3317  <li>
  3318  polygon
  3319  <li>
  3320  fill polygon
  3321  </ul>
  3322  <li>
  3323  <strong>Color</strong>
  3324  <ul>
  3325  <li>
  3326  black
  3327  <li>
  3328  blue
  3329  <li>
  3330  cyan
  3331  <li>
  3332  green
  3333  <li>
  3334  gray
  3335  <li>
  3336  red
  3337  <li>
  3338  magenta
  3339  <li>
  3340  yellow
  3341  <li>
  3342  white
  3343  <li>
  3344  transparent
  3345  <li>
  3346  Browser...
  3347  </ul>
  3348  <li>
  3349  <strong>Stipple</strong>
  3350  <ul>
  3351  <li>
  3352  Brick
  3353  <li>
  3354  Diagonal
  3355  <li>
  3356  Scales
  3357  <li>
  3358  Vertical
  3359  <li>
  3360  Wavy
  3361  <li>
  3362  Translucent
  3363  <li>
  3364  Opaque
  3365  <li>
  3366  Open...
  3367  </ul>
  3368  <li>
  3369  <strong>Width</strong>
  3370  <ul>
  3371  <li>
  3372  1
  3373  <li>
  3374  2
  3375  <li>
  3376  4
  3377  <li>
  3378  8
  3379  <li>
  3380  16
  3381  <li>Dialog...
  3382  </ul>
  3383  <li>
  3384  <strong>Undo</strong>
  3385  <li>
  3386  <strong>Help</strong>
  3387  <li>
  3388  <strong>Dismiss</strong>
  3389  </ul>
  3390  Choose a drawing primitive from the <strong>Primitive</strong> sub-menu.
  3391  <p>
  3392  Next, choose a color from the <strong>Color</strong> sub-menu. Additional colors
  3393  can be specified with the color browser. You can change the menu colors
  3394  by setting the <a href="#disp-xres">X resources</a> pen1 through pen9. The transparent
  3395  color updates the image matte channel and is useful for image compositing.
  3396  <p>
  3397  If you choose the color browser and press <strong>Grab</strong>, you can select the
  3398  primitive color by moving the pointer to the desired color on the screen
  3399  and press any button. The transparent color updates the image matte channel
  3400  and is useful for image compositing.
  3401  <p>
  3402  Choose a stipple, if appropriate, from the <strong>Stipple</strong> sub-menu. Additional
  3403  stipples can be specified with the file browser. Stipples obtained from
  3404  the file browser must be on disk in the X11 bitmap format.
  3405  <p>
  3406  Choose a line width, if appropriate, from the <strong>Width</strong> sub-menu. To
  3407  choose a specific width select the <strong>Dialog</strong> widget.
  3408  <p>
  3409  Choose a point in the image window and press button 1 and hold. Next, move
  3410  the pointer to another location in the image. As you move, a line connects
  3411  the initial location and the pointer. When you release the button, the
  3412  image is updated with the primitive you just drew. For polygons, the image
  3413  is updated when you press and release the button without moving the pointer.
  3414  <p>
  3415  To cancel image drawing, move the pointer back to the starting point of
  3416  the line and release the button.
  3417  </td></tr></table>
  3418       <p>
  3419  <i><a href="#top">Back to Contents</a></i> 
  3420  &nbsp;</p>
  3421  <table BORDER=0 WIDTH="100%"> 
  3422  <tr> 
  3423  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  3424  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  3425  height=14 width=15><b><font face="Helvetica, Arial"><font 
  3426  color="#00B04F"><font size="+1">
  3427  <a NAME="disp-regi"></a>Region of Interest
  3428  </font></font></font></b></td></tr></table>
  3429  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  3430  <tr><td width="3%"><br></td><td>
  3431  <p>
  3432  To begin, press choose Region of Interest of the Pixel Transform sub-menu
  3433  from the <a href="#disp-comm">Command widget</a>.
  3434  Alternatively, <a href="#disp-keyb">press</a> R in the image window.
  3435  <p>
  3436  A small window appears showing the location of the cursor in the image
  3437  window. You are now in region of interest mode. In region of interest mode,
  3438  the Command widget has these options:
  3439  <ul>
  3440  <li>
  3441  <strong>Help</strong>
  3442  <li>
  3443  <strong>Dismiss</strong>
  3444  </ul>
  3445  <p>
  3446  To define a region of interest, press button 1 and drag. The region of
  3447  interest is defined by a highlighted rectangle that expands or contracts
  3448  as it follows the pointer. Once you are satisfied with the region of interest,
  3449  release the button. You are now in apply mode. In apply mode the Command
  3450  widget has these options:
  3451  <ul>
  3452  <li>
  3453  <strong>File</strong>
  3454  <ul>
  3455  <li>
  3456  Save...
  3457  <li>
  3458  Print...
  3459  </ul>
  3460  <li>
  3461  <strong>Edit</strong>
  3462  <ul>
  3463  <li>
  3464  Undo
  3465  <li>
  3466  Redo
  3467  </ul>
  3468  <li>
  3469  <strong>Transform</strong>
  3470  <ul>
  3471  <li>
  3472  Flip
  3473  <li>
  3474  Flop
  3475  <li>
  3476  Rotate Right
  3477  <li>
  3478  Rotate Left
  3479  </ul>
  3480  <li>
  3481  <strong>Enhance</strong>
  3482  <ul>
  3483  <li>
  3484  Hue...
  3485  <li>
  3486  Saturation...
  3487  <li>
  3488  Brightness...
  3489  <li>
  3490  Gamma...
  3491  <li>
  3492  Spiff
  3493  <li>
  3494  Dull
  3495  <li>
  3496  Equalize
  3497  <li>
  3498  Normalize
  3499  <li>
  3500  Negate
  3501  <li>
  3502  GRAYscale
  3503  <li>
  3504  Quantize...
  3505  </ul>
  3506  <li>
  3507  <strong>Effects</strong>
  3508  <ul>
  3509  <li>
  3510  Despeckle
  3511  <li>
  3512  Emboss
  3513  <li>
  3514  Reduce Noise
  3515  <li>
  3516  Add Noise
  3517  <li>
  3518  Sharpen...
  3519  <li>
  3520  Blur...
  3521  <li>
  3522  Threshold...
  3523  <li>
  3524  Edge Detect...
  3525  <li>
  3526  Spread...
  3527  <li>
  3528  Shade...
  3529  <li>
  3530  Raise...
  3531  <li>
  3532  Segment...
  3533  </ul>
  3534  </ul>
  3535  <ul>
  3536  <li>
  3537  <strong>F/X</strong>
  3538  <ul>
  3539  <li>
  3540  Solarize...
  3541  <li>
  3542  Swirl...
  3543  <li>
  3544  Implode...
  3545  <li>
  3546  Wave...
  3547  <li>
  3548  Oil Paint
  3549  <li>
  3550  Charcoal Draw...
  3551  </ul>
  3552  </ul>
  3553  <ul>
  3554  <li>
  3555  <strong>Miscellany</strong>
  3556  <ul>
  3557  <li>
  3558  Image Info
  3559  <li>
  3560  Zoom Image
  3561  <li>
  3562  Show Preview...
  3563  <li>
  3564  Show Histogram
  3565  <li>
  3566  Show Matte
  3567  </ul>
  3568  <li>
  3569  <strong>Help</strong>
  3570  <li>
  3571  <strong>Dismiss</strong>
  3572  </ul>
  3573  <p>
  3574  You can make adjustments to the region of interest by moving the pointer
  3575  to one of the rectangle corners, pressing a button, and dragging. Finally,
  3576  choose an image processing technique from the Command widget. You can choose
  3577  more than one image processing technique to apply to an area. Alternatively,
  3578  you can move the region of interest before applying another image processing
  3579  technique. To exit, press Dismiss.
  3580  </td></tr></table>
  3581       <p>
  3582  <i><a href="#top">Back to Contents</a></i> 
  3583  &nbsp;</p>
  3584  <table BORDER=0 WIDTH="100%"> 
  3585  <tr> 
  3586  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  3587  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  3588  height=14 width=15><b><font face="Helvetica, Arial"><font 
  3589  color="#00B04F"><font size="+1">
  3590  <a NAME="disp-impa"></a>Image Panning
  3591  </font></font></font></b></td></tr></table>
  3592  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  3593  <tr><td width="3%"><br></td><td>
  3594  <p>
  3595  When an image exceeds the width or height of the X server screen, display
  3596  maps a small panning icon. The rectangle within the panning icon shows
  3597  the area that is currently displayed in the the image window. To pan about
  3598  the image, press any button and drag the pointer within the panning icon.
  3599  The pan rectangle moves with the pointer and the image window is updated
  3600  to reflect the location of the rectangle within the panning icon. When
  3601  you have selected the area of the image you wish to view, release the button.
  3602  <p>
  3603  Use the arrow keys to pan the image one pixel up, down, left, or right
  3604  within the image window.
  3605  <p>
  3606  The panning icon is withdrawn if the image becomes smaller than the dimensions
  3607  of the X server screen.
  3608  </td></tr></table>
  3609       <p>
  3610  <i><a href="#top">Back to Contents</a></i> 
  3611  &nbsp;</p>
  3612  <table BORDER=0 WIDTH="100%"> 
  3613  <tr> 
  3614  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
  3615  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
  3616  height=14 width=15><b><font face="Helvetica, Arial"><font 
  3617  color="#00B04F"><font size="+1">
  3618  <a NAME="disp-pref"></a>User Preferences
  3619  </font></font></font></b></td></tr></table>
  3620  <table width="94%" border="0" cellspacing="0" cellpadding="8">
  3621  <tr><td width="3%"><br></td><td>
  3622  <p>
  3623  Preferences affect the default behavior of <strong>display(1)</strong>. The preferences
  3624  are either true or false and are stored in your home directory
  3625  as <tt>.displayrc</tt>:
  3626  <dl>
  3627  <dt>
  3628  <strong>display image centered on a backdrop</strong></dt>
  3629  <dd>
  3630  This backdrop covers the entire workstation screen and is useful for hiding
  3631  other X window activity while viewing the image. The color of the backdrop
  3632  is specified as the background color. Refer to <a href="#disp-xres">X Resources</a>
  3633  for details.</dd>
  3634  <dt>
  3635  <strong>confirm on program exit</strong></dt>
  3636  <dd>
  3637  Ask for a confirmation before exiting the <strong>display(1)</strong> program.</dd>
  3638  <dt>
  3639  <strong>correct image for display gamma</strong></dt>
  3640  <dd>
  3641  If the image has a known gamma, the gamma is corrected to match that of
  3642  the X server (see the <a href="#disp-xres">X Resource</a><strong> displayGamma</strong>).</dd>
  3643  <dt>
  3644  <strong>display warning messages</strong></dt>
  3645  <dd>
  3646  Display any warning messages.</dd>
  3647  <dt>
  3648  <strong>apply Floyd/Steinberg error diffusion to image</strong></dt>
  3649  <dd>
  3650  The basic strategy of dithering is to trade intensity resolution for spatial
  3651  resolution by averaging the intensities of several neighboring pixels.
  3652  Images which suffer from severe contouring when reducing colors can be
  3653  improved with this preference.</dd>
  3654  <dt>
  3655  <strong>use a shared colormap for colormapped X visuals</strong></dt>
  3656  <dd>
  3657  This option only applies when the default X server visual is
  3658  <em>PseudoColor</em>
  3659  or <em>GRAYScale</em>. Refer to <strong>-visual</strong> for more details. By default,
  3660  a shared colormap is allocated. The image shares colors with other X clients.
  3661  Some image colors could be approximated, therefore your image may look
  3662  very different than intended. Otherwise the image colors appear exactly
  3663  as they are defined. However, other clients may go technicolor when the
  3664  image colormap is installed.</dd>
  3665  <dt>
  3666  <strong>display images as an X server pixmap</strong></dt>
  3667  <dd>
  3668  Images are maintained as a XImage by default. Set this resource to True
  3669  to utilize a server Pixmap instead. This option is useful if your image
  3670  exceeds the dimensions of your server screen and you intend to pan the
  3671  image. Panning is much faster with Pixmaps than with a XImage. Pixmaps
  3672  are considered a precious resource, use them with discretion.</dd>
  3673  </dl>
  3674  </td></tr></table>
  3675       <p>
  3676  <i><a href="#top">Back to Contents</a></i> 
  3677  &nbsp;</p>