home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / plotting / imagetoo / imagetl1.lha / Imagetool / imagetool.help / imagetool_basics next >
Encoding:
Text File  |  1990-09-20  |  8.1 KB  |  180 lines
  1.  
  2.  
  3.             Imagetool_basics                               February 1988
  4.  
  5.  
  6.  
  7.  
  8.             CONTENTS
  9.  
  10.  
  11.             Start Imagetool
  12.             Inputs To Imagetool
  13.             Error Messages
  14.             Basic Operations
  15.                  Changing Current Directory
  16.                  Basic Editing On Canvas
  17.                  Panel Button Usage
  18.                  Picking Positions And Quick Load
  19.                  Text Item Accelerators
  20.  
  21.  
  22.  
  23.             START IMAGETOOL
  24.  
  25.             To start up Imagetool, simply type imagetool  (or  the  full
  26.             path  name  of Imagetool) at the command line. Better if you
  27.             include  the  path  name  of  the  directory  that  contains
  28.             Imagetool  executable  in your .login file.  Since Imagetool
  29.             is base  on  the  Sunview  Window  System,  you  must  first
  30.             activate suntools environment by typing suntools.
  31.  
  32.             When Imagetool windows come up  on  your  screen,   you  may
  33.             start loading and editing images and palettes, or go to menu
  34.             HELP to read a help file if you have no idea where to start.
  35.  
  36.             Imagetool allows a user to set up some default  paths  in  a
  37.             default  file.  See  details in the following section on the
  38.             menu options.  If you do not know how to set up the defaults
  39.             the first time, answer "No" to the prompt.
  40.  
  41.  
  42.  
  43.             INPUTS TO IMAGETOOL
  44.  
  45.             The Imagetool window consists of four separate areas:  a tty
  46.             subwindow  running  a  csh,  a control panel that holds text
  47.             items and buttons to take user  input,  a  menu  panel  that
  48.             contains  eight main menus, and a canvas on which images are
  49.             displayed.
  50.  
  51.             The tty subwindow runs a csh. The user can use all kinds  of
  52.             C-shell commands in it.
  53.  
  54.             On the control panel, the user may enter the  current  image
  55.             directory  path,  the image file name, the dimensions (x and
  56.             y) of the image, and the palette file name. To enter a  name
  57.             string  on  a  certain text item, first move the cursor into
  58.             the control panel area, click the left mouse button  on  the
  59.             text  item  (such  as the item labelled Image) --- make sure
  60.             you see the caret blinking on that item, then  type  in  the
  61.             name  string.  The  return  key brings the caret to the next
  62.             text item in a circular fashion.
  63.  
  64.             The panel below the control panel is the  menu  panel  which
  65.             holds  eight  main  menus To select an option from the menus
  66.             (IMAGE, EDIT, PALETTE, ZOOM, GRAPH, FTP, HELP, and OPTIONS),
  67.             hold  down  the right mouse button on a particular menu item
  68.             (for instance, IMAGE), slide down the cursor to  choose  the
  69.             desired operation. The user may also slide to the right of a
  70.             selection to get a sub-menu which are indicated by a  right-
  71.             pointing  arrow  adjacent to the item name.  Note: hold down
  72.             the mouse button all the way through, and  release  it  when
  73.             you  make  a  selection.  If  you  do not want to select any
  74.             option, simply move the cursor out  of  the  menu  and  then
  75.             release  the button. A detailed description of functionality
  76.             and usage of the main menu items is given in the  Main  Menu
  77.             help file.
  78.  
  79.  
  80.  
  81.             ERROR MESSAGES
  82.  
  83.             All error messages will appear in  the  tty  subwindow.  The
  84.             meaning  of each error message is explained in the help file
  85.             imagetool_errors.
  86.  
  87.  
  88.  
  89.             BASIC OPERATIONS
  90.  
  91.             This section introduces the basic operations  without  using
  92.             menus.   It  describes  how  to  change  the current working
  93.             directory within Imagetool,  how  to  load  an  image  at  a
  94.             specified  location,  how to move or copy a part of an image
  95.             on the canvas, and so on.  The more sophisticated operations
  96.             would be selected from the main menus.
  97.  
  98.  
  99.             Changing Current Directory
  100.  
  101.             Enter the path name of the directory you want to  change  to
  102.             at  the  item  labelled Directory, type Ctrl-C at the end of
  103.             the name string, or click on the  Directory  item  with  the
  104.             right  mouse button to select Change directory.  The current
  105.             directory path is displayed on the Imagetool  window  frame.
  106.             Note  that  this  directory,  which is the working directory
  107.             from which images are loaded, is not the same as the current
  108.             directory  of  the  tty subwindow.  In this way, one can use
  109.             the tty subwindow to "look around"  without  disturbing  the
  110.             working directory.
  111.  
  112.  
  113.             Basic Editing On Canvas
  114.  
  115.             Imagetool provides you with basic  editing  capabilities  on
  116.             the  canvas  without using any menus. Once you have an image
  117.             displayed on the canvas, you may  cut  (copy)  a  particular
  118.             region of the image and move it to other part of the canvas.
  119.             First, select a region by  holding  down  the  middle  mouse
  120.             button and drag toward the lower right corner (a box will be
  121.             "dragged out" on the image). To move this region, place  the
  122.             cursor  inside  the  box,  hold down the middle mouse button
  123.             again, and drag the cutout image  to  wherever  you  choose,
  124.             then  release  the  mouse button. To copy the region, do the
  125.             same operations described above except pressing the  control
  126.             key while moving.
  127.  
  128.  
  129.             Panel Button Usage
  130.  
  131.             There are four permanent buttons on the control panel:
  132.  
  133.             CLEAR  Clear the previously loaded/selected image/region  on
  134.                    the  first  click, and clear the entire canvas on the
  135.                    second click.
  136.  
  137.             PRINT  Hard copy of color images. Not supported with version
  138.                    1.0.
  139.  
  140.             CANCEL Cancel animation and stack operations, if any.  Clear
  141.                    the canvas.
  142.  
  143.  
  144.             Picking Positions And Quick Load
  145.  
  146.             When assembling a composite image, you may need  to  specify
  147.             precise  positions to load images. To pick a position on the
  148.             canvas, press the left mouse button at where  you  want  the
  149.             upper left-hand corner of the image to be. Imagetool reports
  150.             the coordinates of the location you just picked in  the  tty
  151.             subwindow.  Use  the right mouse button to undo this effect.
  152.             Double clicking with the left  mouse  button  will  load  an
  153.             image to the specified location.
  154.  
  155.  
  156.             Text Item Accelerators
  157.  
  158.             Each  text  item  on  the  Imagetool  control  panel  (i.e.,
  159.             Directory,  Image,  Palette,  Xdim,  Ydim) has a pop-up menu
  160.             associated with  it  containing  text  item  "accelerators".
  161.             These  accelerators for the most part constitute a subset of
  162.             the  operations  contained  in  the  main  menus,  and   are
  163.             duplicated  here for ease of operation.  There are two modes
  164.             of usage. The first is to simply choose the accelerator with
  165.             the  mouse  in  the  usual  way.  The  second is to type the
  166.             control key equivalent of each accelerator, as indicated  in
  167.             the  menus,  after  entering  the  text  item  string.   For
  168.             example, the item labelled "Image" holds  the  name  of  the
  169.             current  image.  After entering the image name to be loaded,
  170.             the user can type Ctrl-L to load image, Ctrl-A  to  animate,
  171.             Ctrl-C  to clear image,  or Ctrl-S to scale a floating-point
  172.             format image file.  Such items as Directory and Palette also
  173.             have menus containing accelerators.
  174.  
  175.             NOTE:  Using  accelerators   only   performs   the   default
  176.             operations  (for instance, loading a raw format raster file,
  177.             and animate on  regular  sized  image).  If  you  want  more
  178.             complicated operations, you must select from the main menus.
  179.  
  180.