Inote Help Documentation

version 2.1

Introduction Glossary Menu Options

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