Inote Help Documentation
version 2.1
Glossary
frame: the window border that encloses the image, menu bar
and message window. This can be adjusted by using one of the options from
the Frame menu on the menu bar.
menu bar: the area across the top of the image annotation
viewer, on which the words "File", "Frame", "Image", Overlays", "Colors",
"Drawing Mode" and "Help" appear. Clicking on one of the buttons that is not
grayed out will show a pull-down menu (except "Help" which brings up the
help window). Clicking on one of the options listed in the pull-down menu
selects that option. Holding the mouse button down over one of the buttons
on the menu bar will cause its pull-down menu to appear for as long as the
mouse button is held down. Releasing the mouse button over one of the
options in the pull-down menu will select that option. Some of the menu
buttons may be grayed out in which case they cannot be used. The Overlay
menu can only be used if an image has been opened. The Colors and Drawing
Mode menus can only be used when in the Overlay Edit mode.
message window: the line appearing at the bottom of the window.
It contains information about the overlay mode (Edit/Browse/Off) and when in
edit mode it shows the drawing mode and overlay color. It also shows the
state of the overlays (Save needed/Save complete).
overlay: can be thought of as a clear "sheet" over the image
on which to draw annotation figures (points, circles or rectangles). Drawing
on the overlays does not alter the image. You may create more than one
overlay (the current maximum is 30) and set t he visibility and color
individually. All the figures on the overlay appear together (or are made
invisible together) and setting the color for an overlay changes the color
of all figures on that overlay.
panner: a small window with a rectangle representing the
portion of the image being shown by the viewer. The window represents the
image available to view. The panner appears automatically when the frame is
too small to allow the entire image to be displayed. To use the panner,
first place the mouse pointer on the rectangle within the panner window.
Now, by holding down the button and moving the mouse, you can move the
framed viewing area back and forth over the image.
RETURN TO TOP
Menu Options
File Pull-down Menu
- Open image: will bring up a file browser to allow you to select
an image file if there is not an image currently being viewed. To change
directories in the file browser, either double click on the directory you
want to transfer to, or single click on the directory and then click on the
"Filter" button. Sometimes the double click method does not register with
the browser. To select a file, double click on the file, or single click on
the file and then click on the "OK" button. You may open either image files
or overlay files. If you open an image file and an overlay file exists with
the standard name for that image, this overlay file will be opened. If you
do not want this to happen, you need to move the overlay file to another
name or remove it.
- Close image: will blank out the current image, so that you may
open a new image file.
- Save overlays: will save the overlay
information into a file.
When you save a new overlay, you will be prompted for a file name. The
standard file name will appear in the type-in box so you may hit the OK
button, unless you need the file stored under a different name. If you want
Inote to be able to open your overlay file automatically when you open the
image, you need to use the standard name. If you do not use the standard
name, you can still open your overlay file by using the full overlay file
name on the command line or choosing it from the file browser. After the
name has been chosen, Inote assumes that you wish to save to this file
whenever you you use the Save overlay option. If you do not want to save to
the existing file name, you should choose the Save as option from the File
menu. If this was not a new overlay file, then Inote creates a backup file
with .bak appended to the file name. This is done only the first time you
save so the backup file will contain the overlay as it was before you s
tarted this editing session.
- Save as: will prompt for the file name to save under before
saving the overlay information.
- Import overlay: will prompt for the file name that you wish to
import the overlay from. It then brings up a list of the overlays within
that file so that you may click on the name of the overlay you wish to
import. If the overlay you are importing has t he same name as one of the
your existing overlays, you will be asked to rename the overlay you are
importing.
- Exit: allows you to exit the application.
RETURN TO TOP
Frame Pull-down Menu
- Choosing "Frame" on the menu bar allows you to choose four different
options for the size of the frame. If the new frame size is not large
enough to view the entire image, the panner will appear. The frame can also
be resized by "dragging" the corners of the frame.
- Full screen: allows the user to expand the frame of the image
tool so that it takes up the entire screen. This will be useful for very
large images.
- Half screen(portrait): uses half the horizontal dimension of
the screen and all of the vertical dimension.
- Half screen(landscape): uses all the horizontal dimension of
the screen and half of the vertical dimension.
- Quarter screen: uses half of the horizontal and half of the
vertical dimension of the screen.
- Fit frame to image: sizes the frame to fit around the borders
of the image at natural size, unless one of the dimensions of the image is
larger than the screen in which case the frame is screen size in that
direction.
RETURN TO TOP
Image Pull-down Menu
- Choosing "Image" allows you to select six different options for the
image currently being viewed. These options scale both the dimensions of
the image by the indicated amounts, but do not change the size of the frame.
If the frame is not large enough to display the new size of the image, the
panner will appear. It is possible to select a scale before an image is
loaded, in which case the image will first appear scaled to the size chosen.
The natural size is still the size the image has in the file, however.
- Double size: actually makes the image four times as large since
it doubles both dimensions.
- Half Size: actually make the image a quarter of its previous
size, since it halves both dimensions.
- Increase 10%: increases each dimension by 10%.
- Shrink 10%: decreases each dimension by 10%
- Fit to frame: scales the image so that the image fits as
closely as possible in the current frame border.
- Natural size: returns the image to its original size. This is
the size that the image is defined to be in the image file.
RETURN TO TOP
Overlay Pull-down Menu
- The Overlay menu button will be grayed out until an image is loaded. Then
there are four options:
- Overlay attributes ... this brings up a window in which you may
set the attributes of the active overlay (name, color and visibility) and
the current drawing mode. You can also select an active overlay from a list
of your overlays, create new overlays, and delete existing overlays. If you
only want one overlay and the default name (Overlay1) is acceptable, you do
not need this window as you can set color and drawing mode from the main
menu. There is also a help button
on the window for help specific to the overlay attributes.
- Activate -- Edit mode: makes the overlay visible and allows the
user to edit the overlay. If there is not an existing overlay, one is
created for you with the default values (name - Overlay1, visibility - ON,
color - Black). In this mode, clicking on an existing figure with mouse
button 1 will bring up the editor, if the figure is linked to a text
annotation. If the figure is linked to another image, a file browser is
brought up to choose an image file name. Clicking outside of a figure with
mouse button 1 will cause a beep. To draw a figure on the image, choose a
drawing mode (default is rectangle) and a color for the overlay (default is
black) and, if the mode is point, click with mouse button 2 where you want
the point. If the mode is rectangle, press mouse button 2 down where you
want one corner of the rectangle to be, then drag the other corner to the
desired location and release the mouse button. If the mode is circle, press
mouse button 2 where you want the center to be and then drag the perimeter
until it is where you want it and release the mouse button. A window will
then appear to fill in the annotation name and link type (to text or image).
Enter a unique annotation name, choose a link type or accept the default
choice and hit the OK button. If the annotation name is not unique the
window will not go away. You may also cancel the window, in which case the
annotation figure will be erased. After you choose a name, a window will
appear with an editor, if the link is to text, or a file browser, if the
link is to an image. To delete an annotation, click mouse button 3 within
the figure. If you click within more than one figure, if one figure is
contained inside the other, you will delete the innermost figure. Otherwise
Inote will arbitrarily choose one of the figures to delete. However, there
will be a dialog box asking if you want to delete that figure (giving its
name). To avoid confusion, click in an area of the figure that does not
overlap another figure. Clicking outside of a figure with mouse button 3
will cause a beep.
- Activate -- Browse mode: makes the overlay visible and allows
the user to browse the overlay. Click within a figure with any mouse button.
If the link is to text, a window will appear that will allow you to view but
not edit the text. If the link is to another image, then another instance
of Inote will be opened with that image. Clicking outside of a figure will
cause a beep.
- Deactivate overlays: makes all overlays invisible. The image is
not sensitive to mouse clicks in this state.
RETURN TO TOP
Color Pull-down Menu
- The Color menu button will be grayed out unless you are in Overlay Edit
mode. Selecting a color from the menu sets the color that the active overlay
will be drawn in. There are six colors (black, white, red, blue, green,
yellow) or inverse. Inverse, because of the way colormaps are set up, is
not truly opposite colors, but the colors are usually different from the
background colors. This option does not seem to work with differing versions
of Motif in the server and client (it has always been black in the cases I
have seen). If your image uses a lot of colors, Inote may not be able to
allocate all the possible colors. Usually black or white is a good choice in
these cases. In the extreme case where it can't allocate any of them,
inverse is the only choice, because it uses whatever is in the colormap.
RETURN TO TOP
Drawing Mode Pull-down Menu
- The Drawing Mode menu button will be grayed out unless you are in
Overlay Edit mode. Then you may choose one of three options. You do not need
to reselect the option every time you draw a figure.
- Point: draws a short vertical line crossed by a short horizontal
line. Click with mouse button 2 where you want the point.
- Circle: press mouse button 2 where you want the center to be,
then drag the perimeter to where you want it and release the mouse button.
- Rectangle: press mouse button 2 down where you want one corner
of the rectangle to be, then drag the other corner to the desired location
and release the mouse button.
RETURN TO TOP
- Help Button
- Choosing "Help" from the menu bar presents this help document. To exit this
window, click on the "Dismiss" button. You can move this window by dragging
the title bar (where it says Help).
- For information on the command-line options see the user documentation.
For help in setting resource values see the sample resource file, Inote.
RETURN TO TOP
Last Modified: Thursday, 14-May-2009 15:01:29 EDT