				    

NAME 
     waview  - WAveform VIEWer

SYNOPSIS
     waview [file]

DESCRIPTION
     Waview is a graphical waveform viewer for files generated by Alliance's
     behavioral simulator asimut. It is capable of displaying as well as
     printing a graphical representation of files generated by asimut. 

OPTIONS

    file  
	  A pattern file to be loaded at startup.


WINDOW REGIONS
    There are three regions from which  the program will accept
    commands. From the menu region, all commands are accessible, the other
    two have a limited number of active commands.

MENU REGION
    File 
       Open File: Brings up a window from which all filtered files could
	    be seen. The current directory is changed by right click on the
	    bar next to the Directory bar. This action creates another window
	    that allows for directory structure edit. Also the filter pattern
	    could be changed in much the same way. 
       
	    Once a file has been selected with the mouse or the file name has
	    been typed in the rectangle under "Open File" the Ready button or
	    the Return key is depressed to load the file. 

	    If a new file appears in the current directory after the program
	    has been running, the Rescan button must be depressed to acquire
	    the new contents of the directory.

        Save File: Saves a copy of the working file.

	Write Postscript: Writes a postscript file of the windows current
	    view. A window to select the output file name will be
	    activated.

	Exit: Terminate current session. A window will pop up to confirm 
	    that you really want to quit.

    Edit
        Undo:

	Cut: Remove the selected waveform from the wave window. The last
	     wave that was removed with the cut command is saved on a
	     temporary buffer, thus it could be recovered with the paste
	     command.  

	Copy: Copy the selected signal on to the temporary buffer. This
	     will allow a copy of the signal to be dropped on another 
	     location in the wave window.

	Paste: Place the contents of the temporary buffer below the
	     selected signal. If no signal is selected the operation is 
	     not done. The paste command exhausts the contents of the
	     temporary buffer.

	Signal Properties: A window with the following options will
	     appear

	     Signal Name: Change the name of the signal.

	     Signal Type: The base in which to display the  signal. 
		    Dual level signals can only be represents with
		    binary base. Multilevel signals can be represented
		    with either octal, decimal or hexadecimal base.
	     OK Button: Applies changes to the signal and destroys the
		    Signal properties window.
	     Apply Button: Applies the properties to the selected signal
		    but does not destroy the window. If another signal is
		    selected in the signal name window, the Signal
		    Properties window is updated with the current
		    signals properties. 
	     Cancel: Do not change the selected signal properties and
		    destroy the current Signal Properties window.

	Program Properties: This will create a window with the following
	     options 

	     Display Hierarchy: If this button is active, the full
	     	     hierarchical name of the signal is displayed. 
		     If not, only the signal name without the
		     hierarchy is displayed.

	     Signal Type: Base in which to display signals. This affects
		    all signals. Binary signals will be displayed as
		    binary but all multilevel signals will be displayed
		    in accordance with the base selected.

	     OK Button: Apply changes and destroy the Program Properties
		    window. 

	     Apply Button: Apply changes but don't destroy the Program
		    Properties window.

	     Cancel Button: Destroy the Program Properties window without
		    changing the current settings.


    Zoom
	Out:  Zoom out by a factor of 2x
	In:   Zoom in by a factor of 2x 
	Last: Go to the last zoom view
	Full: View all the contents of the pattern file.


SIGNAL NAME REGION

       Left Mouse Button: Actively select a signal. The signal that
	     remains selected is the last signal to be pointed at by
	     the mouse when the button was released.

WAVE REGION

       Left Mouse Button: This button controls the position of the
	     cursor and selects the active signal at the same time.
	     While the button is pressed and the mouse is moving, the 
	     cursor will follow the mouse. The cursor is sensitive to 
	     signal edges. It will lock on to the selected signal's 
	     edge based on proximity. Else, the cursor will fall where
	     the button is pressed. 

       Middle Mouse Button: Selects an area to zoom to. Pressing the
              middle mouse button and dragging the mouse across the
              window will open a rectangle that will enclose the the
              area that will be displayed. Waview does not support
              vertical zoom, therefore only the horizontal part of the
              rectangle will be used.

DIVIDING BAR 

ENVIRONMENT
    
    WAVIEW_HOME  Location of waview program, init.pp and waview.ini.
   
FILES 

    init.pp : Postscrip header for printing to a postscript capable
              printer.

    waview.ini : File containing display variables for the program. This
              file could exist in one of two places: In the directory
              pointed to by the environment variable WAVIEW_HOME and in the 
	      current directory. Each time the file is read the values are
              replaced.

	      File Variables:
	      MainWindowXPosition: Number of pixels from the left of the
	               screen to display the program
	      MainWindowYPosition: Number of pixels from the top of the
	               screen to display the program
	      MainWindowWidth: Width in pixels from the leftmost X coordinate
	      MainWindowHeight: Height in pixels from the topmost Y coordinate
	      SignalWidth: Width in pixels of the SIGNAL NAME REGION
	      DefaultRadix: Base to display signal vectors in. 
			0 = default
			2 = binary
			8 = octal
			10 = decimal
			16 = hexadecimal
	      DisplayHierarchy: Display the hierarchy of the signal name
	      BackgroundColor: R G B color of the background (hex)
	      FontColor: R G B color for signal names (hex)
	      SignalColor:  R G B color for binary signal waves (hex)
	      BusColor:  R G B color for vectored signal waves (hex)
	      CursorColor: R G B color for the cursor line (hex)
ERRATA







