$Id: README,v 1.2 1992/05/04 03:54:57 alan Exp $

This file briefly describes some widget utility procedures contributed
by Francois Briandet of the PVI Paris Professional Support Group.

The procedures are all contained in the file pm_set_plot.pro.

The main procedure is PM_SET_PLOT, which displays a panel of widgets
which can be used to control the attributes (color, linestyle, font, ...)
of the current plot.


PLOT CONTROLS FOR GRAPHICAL ATTRIBUTES

I Theory of Operation

	This screen allows for an easier control and manipulation of graphical
  attributes used by default in functions such as plot, surface, etc ...

  A !PLT type structure describes these attributes.  The user can either
  set a variable of that type, or directly set the !P system variable.

  Graphical attributes are grouped by three functional sub-sets: colors, 
  line, and fonts.  

  For each group, the left part of the screen displays current values, and
  the right side shows graphically how these attributes would translate in
  a plot.

  These values can be modified by clicking the mouse in the widgets placed
  left and right of the display zone.  A sound signal indicates when the
  limit values have been reached.

  At the end of the editing session, it is possible to click on the OK
  button, to validate the modification, or the CANCEL button.


II Function PM_SET_PLOT

  Arguments:
	- action (int): bit mask of what to display.
;                               1 : Colors			(00000001)
;                               2 : Plot attributs		(00000010)
;                               3 : (1+2) Colors+Plots		(00000011)
;                               4 : Fonts			(00000100)
;                               5 : (1+4) Colors+Fonts		(00000101)
;                               6 : (2+4) Plot+Fonts		(00000110)
;                               7 : (1+2+4) Colors++Plot+Fonts	(00000111)


	(the following arguments are optional)
        - plot_st (!PLT): variable describing the graphical attributes.
			(Modified when OK is pressed)
 
	- xpos=,ypos= : coordinates of the bottom left part of the screen.
                        (def: xpos=10,ypos=100)
	- back_col=   : background color (def: !D.N_COLORS/2)
    	- on_col=     :  active fields color
    	- off_col=    :  inactive fields color
        - font=       :  menu fonts

     Returns:
        the functions returns an error status:
                     0 : 'OK'
                     1 : 'CANCEL'

     Note:
        This function requires the following files:

               $WAVE_DIR/lib/user/button/*.pro
               $WAVE_DIR/lib/paris/pm_button_menu.pro
               $WAVE_DIR/lib/paris/pm_plot_but.pro
               $WAVE_DIR/lib/paris/plot_font.pro

