ZTACH(1)                                                 ZTACH(1)




NNAAMMEE
       Ztach - Ztach Widget 
               (A configurable tachometer styled widget.)


DDEESSCCRRIIPPTTIIOONN
       #include "Ztach.h"

       The  Ztach  widget is  an X toolkit compatible widget that
       displays a 3/4  dial, has  two  styles of  indicator  arms 
       available, a label indicating it's current  value, an opt- 
       ional user specified label, and the ability to  rotate the
       arm clockwise or  counter-clockwise.  The  widget  can  be
       configured for a variety of different looks.	

WWIIDDGGEETT CCLLAASSSS
       _z_t_a_c_h_W_i_d_g_e_t_C_l_a_s_s


RREESSOOUURRCCEESS
       _X_t_N_f_o_r_e_g_r_o_u_n_d
              foreground  pixel  of  the widget, default is XtDe-
              faultForeground.

       _X_t_N_l_a_b_e_l_F_o_r_e_g_r_o_u_n_d
              foreground pixel of the  label,  default  is  XtDe-
              faultForeground.

       _X_t_N_m_i_n_i_m_u_m
              minimum value of dial (int), default is 0.

       _X_t_N_m_a_x_i_m_u_m
              maximum value of dial (int), default is 1000.

       _X_t_N_v_a_l_u_e
              value of dial (int), default is 0.

       _X_t_N_f_o_n_t
              font  of label (XFontStruct), default is XtDefault-
              Font.

       _X_t_N_m_a_r_g_i_n
              minimum margin around widget (int), default is 5.

       _X_t_N_i_n_c_r_e_m_e_n_t_C_a_l_l_b_a_c_k
              increment callback, default is NULL.

       _X_t_N_d_e_c_r_e_m_e_n_t_C_a_l_l_b_a_c_k
              decrement callback, default is NULL.

       _X_t_N_v_a_l_u_e_C_h_a_n_g_e_C_a_l_l_b_a_c_k
              value change callback, default is NULL.

       _X_t_N_U_l_a_b_e_l_F_o_r_e_g_r_o_u_n_d 
              foreground   pixel  of  the  user  specfied  label,     
              default is XtDefaultForeground.




                          29 January 1994                1
ZTACH(1)                                                 ZTACH(1)



       _X_t_N_u_f_o_n_t
              font of user specified label (XFontStruct), default  
              is XtDefaultFont.	

       _X_t_N_U_l_a_b_e_l
              The text for the user specified label.  Default is
              "".

       _X_t_N_d_r_a_w_T_a_c_h_A_r_m
              TRUE to draw  standard  tach  style  arm.  FALSE to 
              draw Hdial widget style arm.  	
      
       _X_t_N_r_o_t_a_t_e_C_W
              TRUE to rotate  the arm  clockwise, FALSE to rotate 
              counter-clockwise.		

       _X_t_N_t_h_i_c_k_B_i_t_s
              TRUE to draw the arc  around the tach  double wide, 
              and the alternate  arm ( if selected ) triple wide.  
              False  to leave the arc and the arm single wide.	

       _X_t_N_d_r_a_w_A_r_c
              TRUE to darw the arc around the tach,  FALSE to not 
              draw the arc.
 
       _X_t_N_d_r_a_w_M_a_r_k_e_r_s
              TRUE to draw the scale  tick  marks around the tach 
              face.  FALSE to not draw the marks.

       _X_t_N_d_r_a_w_A_h_e_a_d
              TRUE to draw the arrowhead  on the alternate  indi-
              cator arm.  FALSE to leave the arrowhead off. 

       _X_t_N_d_r_a_w_H_o_l_e
              TRUE to draw the hole at the base of the  indicator
              arm, FALSE to not draw the hole.

       _X_t_N_d_r_a_w_N_u_m_s_t_r_i_n_g
              TRUE to draw the label indicating the numeric value 
              of the indicator  arms  present value. FALSE to not 
              draw the label.
		 	

AACCTTIIOONNSS
       _i_n_c_r_e_m_e_n_t_(_)
              will receive a key/button event  to  increment  the
              value  of the dial, can send an integer as an incr-
              mental value.

       _d_e_c_r_e_m_e_n_t_(_)
              will receive a key/button event  to  decrement  the
              value  of the dial, can send an integer as a decre-
              mental value.

       _s_e_t_(_)  will receive a key/button event to set the dial arm
              to the current pointer position.

       _d_r_a_g_(_) will  receive a motion event to set the dial arm to
              the current pointer position.


                          29 January 1994                2
ZTACH(1)                                                 ZTACH(1)




DDEEFFAAUULLTT TTRRAANNSSLLAATTIIOONNSS
       <key>+: increment(1)
       Shift<key>+: increment(100)
       <key>-: decrement(1)
       Shift<key>-: decrement(100)
       <Btn1Down>: set()
       <Btn1Motion>: set() drag()

CCAALLLLBBAACCKK SSTTRRUUCCTTUURREE
       typedef struct _ZtachCallbackStruct
       {
         int reason;
         XEvent *event;
         int value;
       } ZtachCallbackStruct, *ZtachCallbackPtr;

RREEAASSOONNSS
       ZTACH_INCREMENT
       ZTACH_DECREMENT
       ZTACH_SET

AAUUTTHHOORRSS
       Zman, 1994
       Loganville Technical Resources, Incorporated	
       John L. Cwikla, 1992
       Materials Research Laboratory Center for Computation
       University of Illinois, Champaign
































                          29 January 1994                3