Identifier     set_usersym

 Purpose        set user defined symbols generated with symgen.pro

 Synopsis       set_usersym, symbol [,/fill]

 Arguments      Name      I/O  Type      Description
                -----------------------------------------------------
                symbol     I   integer   The number of the symbol
                fill       I   key       Set this keyword to fill the symbol
                
 Returns        ---

 Description    The SET_USERSYM procedure sets user defined symbols
                generated by SYMGEN: 
                1 =  square
                2 =  diamond
                3 =  circle
                4 =  triangle down
                5 =  triangle up
                6 =  star
                7 =  "bow tie"
                8 =  "hour glass"
                9 =  hexagon
                10 =  hexagon with cross

 Comment      

 Example        To show you all of the user symbols, enter:

                PLOT, INDGEN(10)+1, INTARR(10), PSYM=3, XR=[0,12], $
                      YR=[-1,1]                           ;plots 10 points
                FOR I=1,10 DO BEGIN & SET_USERSYM,I & 
                      PLOTS,I,0,PSYM=8,SYMSIZE=7 & ENDFOR

 Dependencies   CALLS: symgen.pro, sap_keyword_set
                CALLED FROM: disp_aar, (general auxillary routine)

 Category       ISAP

 Filename       set_usersym.pro

 Author         A. Fiedler (--> AF)

 Version        1.0

 History        1.0   July 1993  AF