NAME

Xaw - X Athena Widgets

DESCRIPTION

Xaw is a widget set based on the X Toolkit Intrinsics (Xt) Library. This manual page describes the additions and modifications to the Xaw library made by XFree86 (Xaw7), as well as some of the common interfaces between its version and the previous X Consortium release (Xaw6).

ACTIONS

All of the _X_a_w widgets now have the additional translations call-proc, declare, get-values and sseett--vvaalluueess. The syntax for these actions is:

action-name ((_b_o_o_l_e_a_n_-_e_x_p_r_e_s_s_i_o_n,, _a_r_g_u_m_e_n_t_s))<> <> AAccttiioonn--nnaammee iiss oonnee ooff _c_a_l_l_-_p_r_o_c,, _d_e_c_l_a_r_e,, _g_e_t_-_v_a_l_u_e_s oorr _s_e_t_-_v_a_l_u_e_s.. <> BBoooolleeaann--eexxpprreessssiioonn iiss ccoommppoosseedd wwiitthh tthhee ooppeerraattoorrss _| (or), _& (and), _^ (xor), and _~ (not). The operands can be a variable name, which starts with a _$; a resource name without the bindings _. or _*; or a constant name, including _m_i_n_e (event->xany.window == XtWindow(widget)), _f_a_k_e_d (event->xany.send_event != 0), _t_r_u_e (1) and _f_a_l_s_e (0).

AArrgguummeennttss are self-explanatory; when starting with a _$ they name a variable, otherwise, they indicate a resource name.

call-proc _(_b_o_o_l_e_a_n_-_e_x_p_r_e_s_s_i_o_n_, _p_r_o_c_e_d_u_r_e_-_n_a_m_e_)_<_/_b_> _<_d_d_> _T_h_i_s _a_c_t_i_o_n _a_l_l_o_w_s _t_h_e _e_v_a_l_u_a_t_i_o_n _o_f _a _b_o_o_l_e_a_n _e_x_p_r_e_s_s_i_o_n _i_n _t_h_e _f_i_r_s_t _p_a_r_a_m_e_t_e_r _b_e_f_o_r_e _c_a_l_l_i_n_g _a _a_c_t_i_o_n _p_r_o_c_e_d_u_r_e_. _T_h_e _p_r_o_c_e_d_u_r_e _i_s _o_n_l_y _c_a_l_l_e_d _i_f _t_h_e _e_x_p_r_e_s_s_i_o_n _e_v_a_l_u_a_t_e_s _a_s _t_r_u_e_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_c_a_l_l_-_p_r_o_c_(_"_$_i_n_s_i_d_e _& _$_p_r_e_s_s_e_d_"_, _n_o_t_i_f_y_)_<_/_i_> _<_d_t_> _<_b_>_d_e_c_l_a_r_e _(_b_o_o_l_e_a_n_-_e_x_p_r_e_s_s_i_o_n_, _v_a_r_i_a_b_l_e_, _v_a_l_u_e_, _._._._)_<_/_b_> _<_d_d_> _T_h_i_s _a_c_t_i_o_n _i_s _u_s_e_d _t_o _c_r_e_a_t_e _n_e_w _v_a_r_i_a_b_l_e_s _o_r _c_h_a_n_g_e _t_h_e_i_r _v_a_l_u_e_s_. _A_n_y _n_u_m_b_e_r _o_f _v_a_r_i_a_b_l_e_-_v_a_l_u_e _t_u_p_l_e_s _m_a_y _b_e _s_p_e_c_i_f_i_e_d_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_d_e_c_l_a_r_e_(_1_, _$_p_r_e_s_s_e_d_, _1_)_<_/_i_> _<_d_t_> _<_b_>_g_e_t_-_v_a_l_u_e_s _(_b_o_o_l_e_a_n_-_e_x_p_r_e_s_s_i_o_n_, _v_a_r_i_a_b_l_e_, _v_a_l_u_e_, _._._._)_<_/_b_> _<_d_d_> _T_h_i_s _a_c_t_i_o_n _r_e_a_d_s _a _w_i_d_g_e_t _r_e_s_o_u_r_c_e _v_a_l_u_e _i_n_t_o _a _v_a_r_i_a_b_l_e_. _A_n_y _n_u_m_b_e_r _o_f _v_a_r_i_a_b_l_e_-_v_a_l_u_e _t_u_p_l_e_s _m_a_y _b_e _s_p_e_c_i_f_i_e_d_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_g_e_t_-_v_a_l_u_e_s_(_1_, _$_f_g_, _f_o_r_e_g_r_o_u_n_d_, _$_b_g_, _b_a_c_k_g_r_o_u_n_d_)_<_/_i_> _<_d_t_> _<_b_>_s_e_t_-_v_a_l_u_e_s _(_b_o_o_l_e_a_n_-_e_x_p_r_e_s_s_i_o_n_, _v_a_r_i_a_b_l_e_, _v_a_l_u_e_, _._._._)_<_/_b_> _<_d_d_> _T_h_i_s _a_c_t_i_o_n _s_e_t_s _a _w_i_d_g_e_t _r_e_s_o_u_r_c_e _t_o _t_h_e _g_i_v_e_n _v_a_l_u_e_, _w_h_i_c_h _m_a_y _b_e _a _v_a_r_i_a_b_l_e_. _A_n_y _n_u_m_b_e_r _o_f _v_a_r_i_a_b_l_e_-_v_a_l_u_e _t_u_p_l_e_s _m_a_y _b_e _s_p_e_c_i_f_i_e_d_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_s_e_t_-_v_a_l_u_e_s_(_1_, _f_o_r_e_g_r_o_u_n_d_, _$_b_g_, _b_a_c_k_g_r_o_u_n_d_, _$_f_g_)_<_/_i_> _<_/_d_l_> _<_p_> _H_e_r_e _i_s _a _s_a_m_p_l_e _t_r_a_n_s_l_a_t_i_o_n _t_o _m_a_k_e _a _l_a_b_e_l _w_i_d_g_e_t _b_e_h_a_v_e _l_i_k_e _a _b_u_t_t_o_n_: _<_p_> _<_b_r_> _<_p_r_e_> _<_M_a_p_>_: _g_e_t_-_v_a_l_u_e_s_(_1_, _$_f_g_, _f_o_r_e_g_r_o_u_n_d_, _$_b_g_, _b_a_c_k_g_r_o_u_n_d_)_\_n_\ _<_B_t_n_1_D_o_w_n_>_: _s_e_t_-_v_a_l_u_e_s_(_1_, _f_o_r_e_g_r_o_u_n_d_, _y_e_l_l_o_w_, _b_a_c_k_g_r_o_u_n_d_, _g_r_a_y_3_0_)_\_n_\ _<_B_t_n_1_U_p_>_: _s_e_t_-_v_a_l_u_e_s_(_1_, _f_o_r_e_g_r_o_u_n_d_, _$_f_g_, _b_a_c_k_g_r_o_u_n_d_, _$_b_g_) _<_/_p_r_e_> _<_h_3 _i_d_=_"_D_I_S_P_L_A_Y _L_I_S_T_S_"_> _D_I_S_P_L_A_Y _L_I_S_T_S _<_/_h_3_> _A_l_l _o_f _t_h_e XXaaww _w_i_d_g_e_t_s _h_a_v_e _n_o_w _t_h_e _a_d_d_i_t_i_o_n_a_l _r_e_s_o_u_r_c_e _d_i_s_p_l_a_y_L_i_s_t_. _T_h_i_s _r_e_s_o_u_r_c_e _a_l_l_o_w_s _d_r_a_w_i_n_g _t_h_e _w_i_d_g_e_t _d_e_c_o_r_a_t_i_o_n_s _u_s_i_n_g _c_o_m_m_a_n_d_s _e_m_b_e_d_d_e_d _i_n _a _r_e_s_o_u_r_c_e _s_t_r_i_n_g_. _T_h_e _d_i_s_p_l_a_y_L_i_s_t _r_e_s_o_u_r_c_e _h_a_s _t_h_e _s_y_n_t_a_x_: _<_p_> _[_c_l_a_s_s_-_n_a_m_e_:_]_f_u_n_c_t_i_o_n_-_n_a_m_e _a_r_g_u_m_e_n_t_s_[_[_{_;_\_n_}_]_._._._] _<_p_> CCllaassss--nnaammee _i_s _a_n_y _r_e_g_i_s_t_e_r_e_d _s_e_t _o_f _f_u_n_c_t_i_o_n_s _t_o _d_r_a_w _i_n _t_h_e _w_i_d_g_e_t_. _C_u_r_r_e_n_t_l_y _t_h_e _o_n_l_y _e_x_i_s_t_i_n_g _c_l_a_s_s _i_s _x_l_i_b_, _w_h_i_c_h _p_r_o_v_i_d_e_s _a_c_c_e_s_s _t_o _t_h_e _X_l_i_b _d_r_a_w_i_n_g _p_r_i_m_i_t_i_v_e_s_. _<_p_> FFuunnccttiioonn--nnaammee _i_s _t_h_e _d_r_a_w_i_n_g _o_r _c_o_n_f_i_g_u_r_a_t_i_o_n _f_u_n_c_t_i_o_n _t_o _b_e _c_a_l_l_e_d_, _d_e_s_c_r_i_b_e_d _b_e_l_l_o_w_. _<_p_> AArrgguummeennttss _m_a_y _b_e _a_n_y_t_h_i_n_g _s_u_i_t_a_b_l_e _t_o _t_h_e _d_i_s_p_l_a_y_L_i_s_t _f_u_n_c_t_i_o_n _b_e_i_n_g _c_a_l_l_e_d_. _W_h_e_n _t_h_e _f_u_n_c_t_i_o_n _r_e_q_u_i_r_e_s _a _c_o_o_r_d_i_n_a_t_e_, _t_h_e _s_y_n_t_a_x _i_s _{_+_-_}_<_i_n_t_e_g_e_r_> _o_r _<_i_n_t_e_g_e_r_>_/_<_i_n_t_e_g_e_r_>_. _E_x_a_m_p_l_e_s_: _<_b_r_> _<_p_r_e_> _+_0_,_+_0 _t_o_p_, _l_e_f_t _-_0_,_-_0 _b_o_t_t_o_m_, _r_i_g_h_t _-_+_1_0_,_-_+_1_0 _b_o_t_t_o_m_+_1_0_, _r_i_g_h_t_+_1_0 _+_0_,_1_/_2 _l_e_f_t_, _v_e_r_t_i_c_a_l_-_c_e_n_t_e_r _<_/_p_r_e_> _<_d_l _c_o_m_p_a_c_t_> _<_d_t_> _<_b_>_a_r_c_-_m_o_d_e _m_o_d_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _a_r_c _m_o_d_e_. _A_c_c_e_p_t_e_d _m_o_d_e_s _a_r_e _"_p_i_e_s_l_i_c_e_" _a_n_d _"_c_h_o_r_d_"_, _w_h_i_c_h _s_e_t _t_h_e _a_r_c _t_o _A_r_c_P_i_e_S_l_i_c_e _o_r _A_r_c_C_h_o_r_d_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_a_r_c_-_m_o_d_e _c_h_o_r_d_<_/_i_> _<_d_t_> _<_b_>_b_g _c_o_l_o_r_-_s_p_e_c_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_b_a_c_k_g_r_o_u_n_d _c_o_l_o_r_-_s_p_e_c_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _b_a_c_k_g_r_o_u_n_d _c_o_l_o_r_. _c_o_l_o_r_-_s_p_e_c _m_u_s_t _a _v_a_l_i_d _c_o_l_o_r _s_p_e_c_i_f_i_c_a_t_i_o_n_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_b_a_c_k_g_r_o_u_n_d _r_e_d_<_/_i_> _<_d_t_> _<_b_>_c_a_p_-_s_t_y_l_e _s_t_y_l_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _c_a_p _s_t_y_l_e_. _A_c_c_e_p_t_e_d _s_t_y_l_e_s _a_r_e _"_n_o_t_l_a_s_t_"_, _"_b_u_t_t_"_, _"_r_o_u_n_d_"_, _a_n_d _"_p_r_o_j_e_c_t_i_n_g_"_, _w_h_i_c_h _s_e_t _t_h_e _c_a_p _s_t_y_l_e _t_o _C_a_p_N_o_t_L_a_s_t_, _C_a_p_B_u_t_, _C_a_p_R_o_u_n_d _o_r _C_a_p_P_r_o_j_e_c_t_i_n_g_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_c_a_p_-_s_t_y_l_e _r_o_u_n_d_<_/_i_> _<_d_t_> _<_b_>_c_l_i_p_-_m_a_s_k _p_i_x_m_a_p_-_s_p_e_c_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _p_i_x_m_a_p _f_o_r _t_h_e _c_l_i_p _m_a_s_k_. _R_e_q_u_i_r_e_s _a _p_i_x_m_a_p _p_a_r_a_m_e_t_e_r_, _a_s _d_e_s_c_r_i_b_e_d _i_n _t_h_e PPIIXXMMAAPPSS _s_e_c_t_i_o_n _b_e_l_o_w_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_c_l_i_p_-_m_a_s_k _x_l_o_g_o_1_1_<_/_i_> _<_d_t_> _<_b_>_c_l_i_p_-_o_r_i_g_i_n xx,,yy<> <> SSeettss tthhee cclliipp xx aanndd yy oorriiggiinn.. RReeqquuiirreess ttwwoo aarrgguummeennttss,, tthhee xx aanndd yy ccoooorrddiinnaatteess.. EExxaammppllee:: <> <>cclliipp--oorriiggiinn 1100,,1100<> <> <>cclliipp--rreeccttss _x_1_,_y_1_,_x_2_,_y_2 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_c_l_i_p_-_r_e_c_t_a_n_g_l_e_s xx11,,yy11,,xx22,,yy22 [[......,,xxnn,,yynn]]<> <> SSeettss aa lliisstt ooff rreeccttaanngglleess ttoo tthhee cclliipp mmaasskk.. TThhee nnuummbbeerr ooff aarrgguummeennttss mmuusstt bbee aa mmuullttiippllee ooff ffoouurr.. TThhee aarrgguummeennttss aarree ccoooorrddiinnaatteess.. TThhee ppaarrsseerr ccaallccuullaatteess tthhee wwiiddtthh aanndd hheeiigghhtt ooff tthhee rreeccttaanngglleess.. EExxaammppllee:: <> <>cclliipp--rreeccttss 00,,00,,1100,,2200,, 2200,,1100,,3300,,3300<> <> <>ccoooorrdd--mmooddee _m_o_d_e_<_/_b_> _<_d_d_> _C_h_a_n_g_e_s _t_h_e _c_o_o_r_d _m_o_d_e _f_o_r _f_i_l_l_-_p_o_l_y_g_o_n_, _d_r_a_w_-_l_i_n_e_s_, _a_n_d _d_r_a_w_-_p_o_i_n_t_s_. _A_c_c_e_p_t_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_m_o_d_e_o_r_i_g_i_n_" _a_n_d _"_p_r_e_v_i_o_u_s_"_, _t_h_a_t _s_e_t_s _t_h_e _c_o_o_r_d _m_o_d_e _t_o _C_o_o_r_d_M_o_d_e_O_r_i_g_i_n _o_r _C_o_o_r_d_M_o_d_e_P_r_e_v_i_o_u_s_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_c_o_o_r_d_-_m_o_d_e _p_r_e_v_i_o_u_s_<_/_i_> _<_d_t_> _<_b_>_c_o_p_y_-_a_r_e_a _{_p_i_x_m_a_p_-_s_p_e_c_|_._}_,_d_s_t_x_,_d_s_t_y_[_,_x_2_,_y_2_,_s_r_c_x_,_s_r_c_y_]_<_/_b_> _<_d_d_> _C_a_l_l_s _X_C_o_p_y_A_r_e_a_. _T_h_e _c_h_a_r_a_c_t_e_r _. _m_e_a_n_s _c_o_p_y _t_h_e _w_i_n_d_o_w _c_o_n_t_e_n_t_s_; _p_i_x_m_a_p_-_s_p_e_c _i_s _a_s _d_e_f_i_n_e_d _i_n _t_h_e PPIIXXMMAAPPSS _s_e_c_t_i_o_n _b_e_l_o_w_. _X_2 _a_n_d _y_2 _a_r_e _t_h_e _c_o_o_r_d_i_n_a_t_e_s _o_f _t_h_e _e_n_d _c_o_p_y_, _n_o_t _t_h_e _w_i_d_t_h _a_n_d _h_e_i_g_h_t_; _i_f _n_o_t _d_e_f_i_n_e_d_, _t_h_e _p_a_r_s_e_r _c_a_l_c_u_l_a_t_e_s _t_h_e_m_. _s_r_c___x _a_n_d _s_r_c___y _d_e_f_a_u_l_t _t_o _z_e_r_o_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_c_o_p_y_-_a_r_e_a _T_e_r_m_,_1_0_,_1_0_<_/_i_> _<_d_t_> _<_b_>_c_o_p_y_-_p_l_a_n_e _{_p_i_x_m_a_p_-_s_p_e_c_|_._}_,_d_s_t_x_,_d_s_t_y_[_,_x_2_,_y_2_,_s_r_c_x_,_s_r_c_y_,_p_l_a_n_e_]_<_/_b_> _<_d_d_> _C_a_l_l_s _X_C_o_p_y_P_l_a_n_e_. _T_h_e _c_h_a_r_a_c_t_e_r _. _m_e_a_n_s _c_o_p_y _t_h_e _w_i_n_d_o_w _c_o_n_t_e_n_t_s_; _p_i_x_m_a_p_-_s_p_e_c _i_s _a_s _d_e_f_i_n_e_d _i_n _t_h_e PPIIXXMMAAPPSS _s_e_c_t_i_o_n _b_e_l_o_w_. _X_2 _a_n_d _y_2 _a_r_e _t_h_e _c_o_o_r_d_i_n_a_t_e_s _o_f _t_h_e _e_n_d _c_o_p_y_, _n_o_t _t_h_e _w_i_d_t_h _a_n_d _h_e_i_g_h_t_; _i_f _n_o_t _d_e_f_i_n_e_d_, _t_h_e _p_a_r_s_e_r _c_a_l_c_u_l_a_t_e_s _t_h_e_m_. _s_r_c___x _a_n_d _s_r_c___y _d_e_f_a_u_l_t _t_o _z_e_r_o_. _P_l_a_n_e _d_e_f_a_u_l_t_s _t_o _o_n_e_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_c_o_p_y_-_p_l_a_n_e _s_t_a_r_,_1_0_,_1_0_<_/_i_> _<_d_t_> _<_b_>_d_a_s_h_e_s _i_1_[_._._._,_i_n_]_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _d_a_s_h_e_s _f_o_r _l_i_n_e _d_r_a_w_i_n_g_. _A_c_c_e_p_t_s _u_p _t_o _1_2_7 _a_r_g_u_m_e_n_t_s_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_d_a_s_h_e_s _3_,_7 _9_,_1_0_<_/_i_> _<_d_t_> _<_b_>_d_r_a_w_-_a_r_c _x_1_,_y_1_,_x_2_,_y_2_[_,_s_t_a_r_t_-_a_n_g_l_e_,_e_n_d_-_a_n_g_l_e_]_<_/_b_> _<_d_d_> _D_r_a_w_s _a_n _a_r_c_. _T_h_e _f_o_u_r _f_i_r_s_t _a_r_g_u_m_e_n_t_s _a_r_e _t_h_e _r_e_c_t_a_n_g_l_e _e_n_c_l_o_s_i_n_g _t_h_e _a_r_c_. _T_h_e _t_w_o _r_e_m_a_i_n_i_n_g _a_r_g_u_m_e_n_t_s_, _i_f _s_p_e_c_i_f_i_e_d_, _a_r_e _t_h_e _s_t_a_r_t _a_n_d _e_n_d _a_n_g_l_e_, _i_n _d_e_g_r_e_e_s_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_d_r_a_w_-_a_r_c _+_0_,_+_0_,_-_1_,_-_1_,_0_,_9_0_<_/_i_> _<_d_t_> _<_b_>_d_r_a_w_-_r_e_c_t _x_1_,_y_1_,_x_2_,_y_2_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_d_r_a_w_-_r_e_c_t_a_n_g_l_e _x_1_,_y_1_,_x_2_,_y_2_<_/_b_> _<_d_d_> _D_r_a_w_s _a _r_e_c_t_a_n_g_l_e_. _R_e_q_u_i_r_e_s _f_o_u_r _a_r_g_u_m_e_n_t_s_, _w_h_i_c_h _a_r_e _t_h_e _s_t_a_r_t _a_n_d _e_n_d _c_o_o_r_d_i_n_a_t_e _p_a_i_r_s_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_d_r_a_w_-_r_e_c_t _+_1_,_+_1_,_-_5_,_-_5_<_/_i_> _<_d_t_> _<_b_>_d_r_a_w_-_s_t_r_i_n_g _x_,_y_,_"_s_t_r_i_n_g_"_<_/_b_> _<_d_d_> _D_r_a_w_s _a _t_e_x_t _s_t_r_i_n_g_. _R_e_q_u_i_r_e_s _t_h_r_e_e _a_r_g_u_m_e_n_t_s_, _a _x _c_o_o_r_d_i_n_a_t_e_, _a _y _c_o_o_r_d_i_n_a_t_e_, _a_n_d _a _s_t_r_i_n_g_. _S_t_r_i_n_g_s _t_h_a_t _h_a_v_e _w_h_i_t_e _s_p_a_c_e _c_a_n _b_e _q_u_o_t_e_d _w_i_t_h _t_h_e _" _c_h_a_r_a_c_t_e_r_; _t_h_e _b_a_c_k_s_l_a_s_h _c_h_a_r_a_c_t_e_r _\ _c_a_n _a_l_s_o _b_e _u_s_e_d_, _b_u_t _i_t _w_i_l_l _b_e _n_e_c_e_s_s_a_r_y _e_s_c_a_p_e _i_t _t_w_i_c_e_. _E_x_a_m_p_l_e_: _<_b_r_> _d_r_a_w_-_s_t_r_i_n_g _1_0_,_1_0_, _"_H_e_l_l_o _w_o_r_l_d_!_" _<_d_t_> _<_b_>_e_x_p_o_s_u_r_e_s _b_o_o_l_e_a_n_<_/_b_> _<_d_d_> _S_e_t_s _g_r_a_p_h_i_c_s _e_x_p_o_s_u_r_e_s _i_n _t_h_e _G_C_. _A_l_l_o_w_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _a _i_n_t_e_g_e_r _o_r _t_h_e _s_t_r_i_n_g_s _"_t_r_u_e_"_, _"_f_a_l_s_e_"_, _"_o_n_" _a_n_d _"_o_f_f_"_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_e_x_p_o_s_u_r_e_s _t_r_u_e_<_/_i_> _<_d_t_> _<_b_>_f_i_l_l_-_a_r_c _x_1_,_y_1_,_x_2_,_y_2_[_,_s_t_a_r_t_-_a_n_g_l_e_,_e_n_d_-_a_n_g_l_e_]_<_/_b_> _<_d_d_> _L_i_k_e _d_r_a_w_-_a_r_c_, _b_u_t _f_i_l_l_s _t_h_e _c_o_n_t_e_n_t_s _o_f _t_h_e _a_r_c _w_i_t_h _t_h_e _c_u_r_r_e_n_t_l_y _s_e_l_e_c_t_e_d _f_o_r_e_g_r_o_u_n_d_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_i_l_l_-_a_r_c _+_0_,_+_0_,_-_1_,_-_1_,_0_,_1_8_0_<_/_i_> _<_d_t_> _<_b_>_f_i_l_l_-_p_o_l_y _x_1_,_y_1 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_f_i_l_l_-_p_o_l_y_g_o_n _x_1_,_y_1 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _L_i_k_e _d_r_a_w_-_l_i_n_e_s_, _b_u_t _f_i_l_l_s _t_h_e _e_n_c_l_o_s_e_d _p_o_l_y_g_o_n _a_n_d _j_o_i_n_s _t_h_e _f_i_r_s_t _a_n_d _l_a_s_t _p_o_i_n_t_, _i_f _t_h_e_y _a_r_e _n_o_t _a_t _t_h_e _s_a_m_e _p_o_s_i_t_i_o_n_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_i_l_l_-_p_o_l_y _+_0_,_+_1_0_, _+_1_0_,_+_2_0_, _+_3_0_,_+_0_<_/_i_> _<_d_t_> _<_b_>_f_i_l_l_-_r_e_c_t _x_1_,_y_1_,_x_2_,_y_2_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_f_i_l_l_-_r_e_c_t_a_n_g_l_e _x_1_,_y_1_,_x_2_,_y_2_<_/_b_> _<_d_d_> _L_i_k_e _d_r_a_w_-_r_e_c_t_, _b_u_t _f_i_l_l_s _t_h_e _c_o_n_t_e_n_t_s _o_f _t_h_e _r_e_c_t_a_n_g_l_e _w_i_t_h _t_h_e _s_e_l_e_c_t_e_d _f_o_r_e_g_r_o_u_n_d _c_o_l_o_r_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_i_l_l_-_r_e_c_t _+_1_0_,_+_1_0_,_-_2_0_,_-_2_0_<_/_i_> _<_d_t_> _<_b_>_f_i_l_l_-_r_u_l_e _r_u_l_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _f_i_l_l _r_u_l_e_. _A_c_c_e_p_t_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_e_v_e_n_o_d_d_" _a_n_d _"_w_i_n_d_i_n_g_"_, _w_h_i_c_h _s_e_t _t_h_e _f_i_l_l _r_u_l_e _t_o _E_v_e_n_O_d_d_R_u_l_e _o_r _W_i_n_d_i_n_g_R_u_l_e_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_> _f_i_l_l_-_r_u_l_e _w_i_n_d_i_n_g _<_/_i_> _<_d_t_> _<_b_>_f_i_l_l_-_s_t_y_l_e _s_t_y_l_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _f_i_l_l _s_t_y_l_e_. _A_l_l_o_w_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_s_o_l_i_d_"_, _"_t_i_l_e_d_"_, _"_s_t_i_p_p_l_e_d_" _a_n_d _"_o_p_a_q_u_e_s_t_i_p_p_l_e_d_"_, _w_h_i_c_h _s_e_t _t_h_e _f_i_l_l _s_t_y_l_e _t_o _F_i_l_l_S_o_l_i_d_, _F_i_l_l_T_i_l_e_d_, _F_i_l_l_S_t_i_p_p_l_e_d _o_r _F_i_l_l_O_p_a_q_u_e_S_t_i_p_p_l_e_d_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_i_l_l_-_s_t_y_l_e _t_i_l_e_d_<_/_i_> _<_d_t_> _<_b_>_f_o_n_t _f_o_n_t_-_s_p_e_c_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _f_o_n_t _f_o_r _t_e_x_t _f_u_n_c_t_i_o_n_s_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_o_n_t _-_*_-_*_-_*_-_R_-_*_-_*_-_*_-_1_2_0_-_*_-_*_-_*_-_*_-_I_S_O_8_8_5_9_-_1_<_/_i_> _<_d_t_> _<_b_>_f_g _c_o_l_o_r_-_s_p_e_c_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_f_o_r_e_g_r_o_u_n_d _c_o_l_o_r_-_s_p_e_c_<_/_b_> _<_d_d_> _L_i_k_e _b_a_c_k_g_r_o_u_n_d_, _b_u_t _s_e_t_s _t_h_e _c_u_r_r_e_n_t _f_o_r_e_g_r_o_u_n_d _c_o_l_o_r_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_o_r_e_g_r_o_u_n_d _b_l_u_e_<_/_i_> _<_d_t_> _<_b_>_m_a_s_k_<_/_b_> _<_d_d_> _T_h_i_s _c_o_m_m_a_n_d _i_s _u_s_e_f_u_l _w_h_e_n _y_o_u _w_a_n_t _t_o _d_r_a_w _o_n_l_y _i_n _t_h_e _r_e_g_i_o_n _t_h_a_t _r_e_a_l_l_y _n_e_e_d_s _t_o _b_e _r_e_p_a_i_n_t_e_d_. _R_e_q_u_i_r_e_s _n_o _a_r_g_u_m_e_n_t_s_. _<_d_t_> _<_b_>_f_u_n_c_t_i_o_n _f_u_n_c_t_i_o_n_-_s_p_e_c_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _s_p_e_c_i_f_i_c _G_C _f_u_n_c_t_i_o_n_. _A_l_l_o_w_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_s_e_t_"_, _"_c_l_e_a_r_"_, _"_a_n_d_"_, _"_a_n_d_r_e_v_e_r_s_e_"_, _"_c_o_p_y_"_, _"_a_n_d_i_n_v_e_r_t_e_d_"_, _"_n_o_o_p_"_, _"_x_o_r_"_, _"_o_r_"_, _"_n_o_r_"_, _"_e_q_u_i_v_"_, _"_i_n_v_e_r_t_"_, _"_o_r_r_e_v_e_r_s_e_"_, _"_c_o_p_y_i_n_v_e_r_t_e_d_" _a_n_d _"_n_a_n_d_"_, _w_h_i_c_h _s_e_t _t_h_e _f_u_n_c_t_i_o_n _t_o _G_X_s_e_t_, _G_X_c_l_e_a_r_, _G_X_a_n_d_, _G_X_a_n_d_R_e_v_e_r_s_e_, _G_X_c_o_p_y_, _G_X_a_n_d_I_n_v_e_r_t_e_d_, _G_X_n_o_o_p_, _G_X_x_o_r_, _G_X_o_r_, _G_X_n_o_r_, _G_X_e_q_u_i_v_, _G_X_i_n_v_e_r_t_, _G_X_o_r_R_e_v_e_r_s_e_, _G_X_c_o_p_y_I_n_v_e_r_t_e_d _o_r _G_X_n_a_n_d_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_f_u_n_c_t_i_o_n _x_o_r_<_/_i_> _<_d_t_> _<_b_>_j_o_i_n_-_s_t_y_l_e _s_t_y_l_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _j_o_i_n _s_t_y_l_e_. _A_l_l_o_w_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_m_i_t_e_r_"_, _"_r_o_u_n_d_" _a_n_d _"_b_e_v_e_l_"_, _w_h_i_c_h _s_e_t _t_h_e _j_o_i_n _s_t_y_l_e _t_o _J_o_i_n_M_i_t_e_r_, _J_o_i_n_R_o_u_n_d _a_n_d _J_o_i_n_B_e_v_e_l_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_j_o_i_n_-_s_t_y_l_e _r_o_u_n_d_<_/_i_> _<_d_t_> _<_b_>_i_m_a_g_e _{_p_i_x_m_a_p_-_s_p_e_c_}_,_x_s_,_y_s_,_[_x_e_,_y_e_]_<_/_b_> _<_d_d_> _T_h_i_s _f_u_n_c_t_i_o_n _i_s _i_m_p_l_e_m_e_n_t_e_d _a_s _a _w_a_y _t_o _q_u_i_c_k_l_y _c_o_m_p_o_s_e _c_o_m_p_l_e_x _d_e_c_o_r_a_t_i_o_n_s _i_n _w_i_d_g_e_t_s_. _P_i_x_m_a_p_-_s_p_e_c _i_s _a_s _d_e_f_i_n_e_d _i_n _t_h_e PPIIXXMMAAPPSS _s_e_c_t_i_o_n _b_e_l_o_w_. _x_s _a_n_d _y_s _a_r_e _t_h_e _c_o_o_r_d_i_n_a_t_e_s _f_r_o_m _w_h_e_r_e _t_o _s_t_a_r_t _c_o_p_y_i_n_g _t_h_e _p_i_x_m_a_p_; _x_e _a_n_d _y_e _a_r_e _o_p_t_i_o_n_a_l _(_t_h_e_y _d_e_f_a_u_l_t _t_o _x_s _+ _p_i_x_m_a_p_._w_i_d_t_h _a_n_d _y_s _+ _p_i_x_m_a_p_._h_e_i_g_h_t_, _r_e_s_p_e_c_t_i_v_e_l_y_)_. _I_f _t_h_e _p_i_x_m_a_p _h_a_s _a _m_a_s_k_, _t_h_e _c_o_p_y _i_s _m_a_s_k_e_d _a_c_c_o_r_d_i_n_g_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_i_m_a_g_e _p_i_x_m_a_p_._x_p_m_,_0_,_0_,_2_0_,_2_0_<_/_i_> _<_d_t_> _<_b_>_l_i_n_e _x_1_,_y_1_,_x_2_,_y_2_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_d_r_a_w_-_l_i_n_e _x_1_,_y_1_,_x_2_,_y_2_<_/_b_> _<_d_d_> _D_r_a_w_s _a _l_i_n_e _w_i_t_h _t_h_e _c_u_r_r_e_n_t _f_o_r_e_g_r_o_u_n_d _c_o_l_o_r_. _R_e_q_u_i_r_e_s _f_o_u_r _a_r_g_u_m_e_n_t_s_, _t_h_e _s_t_a_r_t_i_n_g _a_n_d _e_n_d_i_n_g _c_o_o_r_d_i_n_a_t_e _p_a_i_r_s_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_l_i_n_e _+_0_,_+_0_, _-_1_,_-_1_<_/_i_> _<_d_t_> _<_b_>_l_i_n_e_-_w_i_d_t_h _i_n_t_e_g_e_r_<_/_b_> _<_d_d_> _S_e_l_e_c_t_s _a _l_i_n_e _w_i_d_t_h _f_o_r _d_r_a_w_i_n_g_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_l_i_n_e_-_w_i_d_t_h _2_<_/_i_> _<_d_t_> _<_b_>_l_i_n_e_-_s_t_y_l_e _s_t_y_l_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _l_i_n_e _s_t_y_l_e_. _A_c_c_e_p_t_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_s_o_l_i_d_"_, _"_o_n_o_f_f_d_a_s_h_" _a_n_d _"_d_o_u_b_l_e_d_a_s_h_"_, _w_h_i_c_h _s_e_t _t_h_e _l_i_n_e _s_t_y_l_e _t_o _L_i_n_e_S_o_l_i_d_, _L_i_n_e_O_n_O_f_f_D_a_s_h _o_r _L_i_n_e_D_o_u_b_l_e_D_a_s_h_, _r_e_s_p_e_c_t_i_v_e_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_l_i_n_e_-_s_t_y_l_e _o_n_o_f_f_d_a_s_h_<_/_i_> _<_d_t_> _<_b_>_l_i_n_e_s _x_1_,_y_1_,_x_2_,_y_2 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_d_r_a_w_-_l_i_n_e_s _x_1_,_y_1_,_x_2_,_y_2 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _D_r_a_w_s _a _l_i_s_t _o_f _l_i_n_e_s_. _A_n_y _n_u_m_b_e_r _o_f _a_r_g_u_m_e_n_t _p_a_i_r_s _m_a_y _b_e _s_u_p_p_l_i_e_d_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_l_i_n_e_s _+_0_,_-_1_, _-_1_,_-_1_, _-_1_,_+_0_<_/_i_> _<_d_t_> _<_b_>_p_a_i_n_t_-_s_t_r_i_n_g _x_,_y_,_"_s_t_r_i_n_g_"_<_/_b_> _<_d_d_> _I_d_e_n_t_i_c_a_l _t_o _d_r_a_w_-_s_t_r_i_n_g_, _b_u_t _a_l_s_o _u_s_e_s _t_h_e _b_a_c_k_g_r_o_u_n_d _c_o_l_o_r_. _E_x_a_m_p_l_e_: _<_b_r_> _p_a_i_n_t_-_s_t_r_i_n_g _1_0_,_2_0_, _"_S_a_m_p_l_e _t_e_x_t_" _<_d_t_> _<_b_>_p_o_i_n_t _x_,_y_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_d_r_a_w_-_p_o_i_n_t _x_,_y_<_/_b_> _<_d_d_> _D_r_a_w_s _a _p_o_i_n_t_. _R_e_q_u_i_r_e_s _t_w_o _a_r_g_u_m_e_n_t_s_, _a _c_o_o_r_d_i_n_a_t_e _p_a_i_r_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_p_o_i_n_t _+_1_0_,_+_1_0_<_/_i_> _<_d_t_> _<_b_>_p_l_a_n_e_-_m_a_s_k _i_n_t_e_g_e_r_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _p_l_a_n_e _m_a_s_k_. _R_e_q_u_i_r_e_s _a_n _i_n_t_e_g_e_r _p_a_r_a_m_e_t_e_r_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_p_l_a_n_e_-_m_a_s_k _-_1_<_/_i_> _<_d_t_> _<_b_>_p_o_i_n_t_s _x_1_,_y_1 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_d_r_a_w_-_p_o_i_n_t_s _x_1_,_y_1 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _D_r_a_w_s _a _l_i_s_t _o_f _p_o_i_n_t_s _a_t _t_h_e _s_p_e_c_i_f_i_e_d _c_o_o_r_d_i_n_a_t_e_s_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_p_o_i_n_t_s _+_1_,_+_2_, _+_1_,_+_4_, _+_1_,_+_6_<_/_i_> _<_d_t_> _<_b_>_s_e_g_m_e_n_t_s _x_1_,_y_1_,_x_2_,_y_2 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _<_b_r_> _<_d_t_> _<_b_>_d_r_a_w_-_s_e_g_m_e_n_t_s _x_1_,_y_1_,_x_2_,_y_2 _[_._._._,_x_n_,_y_n_]_<_/_b_> _<_d_d_> _D_r_a_w_s _a _l_i_s_t _o_f _s_e_g_m_e_n_t _l_i_n_e_s_. _T_h_e _n_u_m_b_e_r _o_f _p_a_r_a_m_e_t_e_r_s _m_u_s_t _b_e _m_u_l_t_i_p_l_e _o_f _4_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_s_e_g_m_e_n_t_s _+_1_,_+_2_,_+_1_,_-_3_, _+_2_,_-_2_,_-_3_,_-_2_<_/_i_> _<_d_t_> _<_b_>_s_h_a_p_e_-_m_o_d_e _m_o_d_e_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _s_h_a_p_e _m_o_d_e _u_s_e_d _i_n _f_i_l_l_-_p_o_l_y_g_o_n_. _A_c_c_e_p_t_e_d _p_a_r_a_m_e_t_e_r_s _a_r_e _"_c_o_m_p_l_e_x_"_, _"_c_o_n_v_e_x_" _o_r _"_n_o_n_c_o_n_v_e_x_"_, _w_h_i_c_h _s_e_t _t_h_e _s_h_a_p_e _m_o_d_e _t_o _C_o_m_p_l_e_x_, _C_o_n_v_e_x _o_r _N_o_n_c_o_n_v_e_x_, _a_c_c_o_r_d_i_n_g_l_y_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_s_h_a_p_e_-_m_o_d_e _c_o_n_v_e_x_<_/_i_> _<_d_t_> _<_b_>_s_t_i_p_p_l_e _p_i_x_m_a_p_-_s_p_e_c_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _p_i_x_m_a_p _f_o_r _a _s_t_i_p_p_l_e_. _R_e_q_u_i_r_e_s _a _p_i_x_m_a_p _p_a_r_a_m_e_t_e_r_, _a_s _d_e_s_c_r_i_b_e_d _i_n _t_h_e PPIIXXMMAAPPSS _s_e_c_t_i_o_n _b_e_l_o_w_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_s_t_i_p_p_l_e _p_l_a_i_d_<_/_i_> _<_d_t_> _<_b_>_s_u_b_w_i_n_d_o_w_-_m_o_d_e mmooddee<> <> SSeettss tthhee ssuubbwwiinnddooww mmooddee iinn tthhee GGCC.. AAcccceepptteedd ppaarraammeetteerrss aarree ""iinncclluuddeeiinnffeerriioorrss"" aanndd ""cclliippbbyycchhiillddrreenn"",, wwhhiicchh sseett tthhee ssuubbwwiinnddooww mmooddee ttoo IInncclluuddeeIInnffeerriioorrss oorr CClliippBByyCChhiillddrreenn,, rreessppeeccttiivveellyy.. EExxaammppllee:: <> <>ssuubbwwiinnddooww--mmooddee iinncclluuddeeiinnffeerriioorrss<> <> <>ttiillee _p_i_x_m_a_p_-_s_p_e_c_<_/_b_> _<_d_d_> _S_e_t_s _t_h_e _p_i_x_m_a_p _f_o_r _a _t_i_l_e_. _R_e_q_u_i_r_e_s _a _p_i_x_m_a_p _p_a_r_a_m_e_t_e_r_, _a_s _d_e_s_c_r_i_b_e_d _i_n _t_h_e PPIIXXMMAAPPSS _s_e_c_t_i_o_n _b_e_l_o_w_. _E_x_a_m_p_l_e_: _<_b_r_> _<_i_>_t_i_l_e _x_l_o_g_o_1_1_?_f_o_r_e_g_r_o_u_n_d_=_r_e_d_&_b_a_c_k_g_r_o_u_n_d_=_g_r_a_y_8_0_<_/_i_> _<_d_t_> _<_b_>_t_s_-_o_r_i_g_i_n xx,,yy<> <> SSeettss tthhee ttiillee ssttiippppllee xx aanndd yy oorriiggiinn.. RReeqquuiirreess ttwwoo aarrgguummeennttss,, aa xx aanndd yy ccoooorrddiinnaattee.. EExxaammppllee:: <> <>ttss--oorriiggiinn 1100,,1100<> <> <>uummaasskk<> <> DDiissaabblleess tthhee GGCC mmaasskk,, iiff iitt hhaass bbeeeenn sseett wwiitthh tthhee ccoommmmaanndd _m_a_s_k.. RReeqquuiirreess nnoo aarrgguummeennttss.. <> <> EExxaammppllee ffoorr ddrraawwiinngg aa sshhaaddooww eeffffeecctt iinn aa wwiiddggeett:: <> <> ffoorreeggrroouunndd ggrraayy3300;;\\ ddrraaww--lliinneess ++11,,--11,,--11,,--11,,--11,,++11;;\\ ffoorreeggrroouunndd ggrraayy8855;;\\ ddrraaww--lliinneess --11,,++00,,++00,,++00,,++00,,--11 <> <> PPIIXXMMAAPPSS <> AA SSttrriinngg ttoo PPiixxmmaapp ccoonnvveerrtteerr hhaass bbeeeenn aaddddeedd ttoo XXaaww.. TThhiiss ccoonnvveerrtteerr iiss mmeeaanntt ttoo bbee eexxtteennddeedd,, aanndd hhaass eennoouugghh aabbssttrraaccttiioonn ttoo aallllooww llooaaddiinngg sseevveerraall iimmaaggee ffoorrmmaattss.. IItt uusseess aa ffoorrmmaatt tthhaatt rreesseemmbblleess aa _U_R_L,, wwiitthh tthhee ssyynnttaaxx:: <> <>[[ttyyppee::]]nnaammee[[??aarrgg==vvaall[[{{&&}}......]]]]<> <> TTyyppee ccaann bbee oonnee ooff _b_i_t_m_a_p,, _g_r_a_d_i_e_n_t oorr _x_p_m.. <> NNaammee mmaayy bbee aa ffiillee nnaammee,, oorr,, iinn tthhee ccaassee ooff ttyyppee _g_r_a_d_i_e_n_t,, mmaayy bbee eeiitthheerr _v_e_r_t_i_c_a_l oorr _h_o_r_i_z_o_n_t_a_l.. <> AArrgg==vvaall iiss aa lliisstt ooff aarrgguummeennttss ttoo tthhee ccoonnvveerrtteerr.. AAnn aarrgguummeenntt lliisstt iiss pprreecceeddeedd bbyy aa qquueessttiioonn mmaarrkk,, aanndd mmuullttiippllee aarrgguummeennttss aarree sseeppaarraatteedd bbyy aammppeerrssaannddss.. TThhee mmoosstt ccoommmmoonn aarrgguummeennttss aarree _f_o_r_e_g_r_o_u_n_d aanndd _b_a_c_k_g_r_o_u_n_d.. GGrraaddiieennttss aallssoo ssuuppppoorrtt tthhee aarrgguummeennttss _s_t_a_r_t aanndd _e_n_d ((ccoolloorrss wwiitthh wwhhiicchh ttoo ssttaarrtt aanndd eenndd tthhee ggrraaddiieenntt));; tthhee _s_t_e_p_s aarrgguummeenntt,, ttoo aallllooww uussiinngg lleessss ccoolloorrss;; aanndd tthhee _d_i_m_e_n_s_i_o_n aarrgguummeenntt ttoo ssppeecciiffyy tthhee ssiizzee ooff tthhee ggrraaddiieenntt.. TThhee _x_p_m ccoonnvveerrtteerr uunnddeerrssttaannddss tthhee _c_l_o_s_e_n_e_s_s aarrgguummeenntt,, wwhhiicchh aaiiddss iinn uussiinngg ffeewweerr ccoolloorrss ((uusseeffuull iiff yyoouu hhaavvee aa lliimmiitteedd ccoolloorrmmaapp)).. <> TTEEXXTT WWIIDDGGEETT <> MMoosstt ooff tthhee cchhaannggeess ttoo tthhiiss vveerrssiioonn ooff tthhee XXaaww lliibbrraarryy wweerree ddoonnee iinn tthhee TTeexxttWWiiddggeett,, TTeexxttSSrrccOObbjjeecctt,, TTeexxttSSiinnkkOObbjjeecctt aanndd rreellaatteedd ffiilleess.. <> AA ccoouuppllee ooff hhiigghhllyy vviissiibbllee cchhaannggeess iinn tthhee TTeexxtt wwiiddggeett aarree dduuee ttoo mmaannyy bbuuggss iinn tthhee XXaaww66 iimmpplleemmeennttaattiioonn iinnvvoollvviinngg ssccrroollllbbaarrss aanndd aauuttoo--rreessiizziinngg.. SSccrroollllbbaarrss bbeeiinngg aaddddeedd oorr rreemmoovveedd ccaauusseedd sseevveerraall pprroobblleemmss iinn kkeeeeppiinngg tthhee tteexxtt ccuurrssoorr vviissiibbllee,, aanndd iinn XXaaww66 iitt wwaass vveerryy eeaassyy ttoo hhaavvee aa wwiiddggeett tthhiinnkkiinngg tthhee ccuurrssoorr wwaass vviissiibbllee,, wwhheenn iitt wwaass nnoott.. AAllssoo,, ppeerrmmiittttiinngg aauuttoommaattiicc rreessiizziinngg ooff tthhee wwiiddggeett ttoo aa llaarrggeerr ggeeoommeettrryy ccrreeaatteedd ootthheerr pprroobblleemmss,, mmaakkiinngg iitt ddiiffffiiccuulltt ttoo hhaavvee aa ccoonnssiisstteenntt llaayyoouutt iinn tthhee aapppplliiccaattiioonn,, aanndd,, iiff tthhee wwiinnddooww mmaannaaggeerr ddiidd nnoott iinntteerrffeerree,, wwiinnddoowwss llaarrggeerr tthhaann tthhee ssccrreeeenn ccoouulldd rreessuulltt.. TThheerreeffoorree,, ssoommee ffuunnccttiioonnaalliittyy iinnvvoollvviinngg ssccrroollllbbaarrss aanndd aauuttoo--rreessiizziinngg hhaass bbeeeenn ddiissaabblleedd;; sseeee tthhee sseeccttiioonn oonn nneeww aanndd mmooddiiffiieedd TTeexxtt wwiiddggeett rreessoouurrcceess bbeellooww.. <> TThhee TTeexxtt wwiiddggeett''ss ddeeffaauulltt kkeeyy bbiinnddiinnggss wweerree oorriiggiinnaallllyy bbaasseedd oonn tthhee EEmmaaccss tteexxtt eeddiittoorr.. IInn tthhiiss rreelleeaassee,, eevveenn mmoorree ooppeerraattiioonnss ffaammiilliiaarr ttoo EEmmaaccss uusseerrss hhaavvee bbeeeenn aaddddeedd.. NNeeww tteexxtt aaccttiioonnss iinncclluuddee:: <> <> <>iinnddeenntt<> <> IInnddeennttss tteexxtt bblloocckkss.. NNoott bboouunndd bbyy ddeeffaauulltt.. TThhee TTeexxtt wwiiddggeett aallssoo ddooeess nnoott aatttteemmpptt ttoo ppeerrffoorrmm aauuttoo--iinnddeennttaattiioonn ooff iittss ssoouurrccee oobbjjeecctt bbyy ddeeffaauulltt.. <> <>kkeeyybbooaarrdd--rreesseett<> <> RReesseettss tthhee kkeeyybbooaarrdd ssttaattee.. RReevveerrttss tthhee aaccttiioonn mmuullttiipplliieerr ttoo 11,, aanndd iiff uunnddoo iiss eennaabblleedd,, ttoogggglleess bbeettwweeeenn uunnddoo aanndd rreeddoo.. BBoouunndd bbyy ddeeffaauulltt ttoo _C_o_n_t_r_o_l_<_K_e_y_>_G.. <> <>kkiillll--rriinngg--yyaannkk<> <> IInn tthhiiss vveerrssiioonn ooff XXaaww,, tteexxtt kkiilllleedd iinn aannyy tteexxtt ffiieelldd iiss kkeepptt iinn mmeemmoorryy,, aalllloowwiinngg ccuutt aanndd ppaassttee ooppeerraattiioonnss iinntteerrnnaallllyy ttoo tthhee pprrooggrraamm bbeettwweeeenn tteexxtt ffiieellddss.. BBoouunndd bbyy ddeeffaauulltt ttoo _M_e_t_a_<_K_e_y_>_Y.. <> <>nnuummeerriicc<> <> LLiisstteedd hheerree oonnllyy ffoorr ppuurrppoosseess ooff ddooccuummeennttaattiioonn.. CCaalllleedd bbyy ddeeffaauulltt wwhheenn oonnee ooff tthhee cchhaarraacctteerrss _1_, _2_, _3_, _4_, _5_, _6_, _7_, _8_, _9_, _0_, oorr _- iiss ttyyppeedd,, aalllloowwiinngg ccoommppoossiittiioonn ooff tthhee mmuullttiipplliiccaattiioonn nnuummbbeerr ooff tteexxtt aaccttiioonnss.. <> <>sseett--kkeeyybbooaarrdd--ffooccuuss<> <> SSeettss tthhee iinnppuutt ffooccuuss ooff tthhee ttoopp lleevveell wwiiddggeett ttoo tthhee tteexxtt ffiieelldd.. NNoott eennaabblleedd bbyy ddeeffaauulltt,, bbuutt bboouunndd ttoo tthhee _<_B_t_n_1_D_o_w_n_> eevveenntt.. <> <>ttooggggllee--oovveerrwwrriittee<> <> TToogggglleess oovveerrwwrriittee mmooddee.. IInn oovveerrwwrriittee mmooddee,, aannyy tteexxtt iinnsseerrtteedd iinn aa tteexxtt ffiieelldd wwiillll rreeppllaaccee eexxiissttiinngg tteexxtt.. BBoouunndd bbyy ddeeffaauulltt ttoo _<_K_e_y_>_I_n_s_e_r_t.. <> <>uunnddoo<> <> SSeettss tthhee _e_n_a_b_l_e_U_n_d_o rreessoouurrccee ooff tthhee tteexxttSSrrccOObbjjeecctt.. NNoott eennaabblleedd bbyy ddeeffaauulltt,, bbuutt bboouunndd ttoo _C_o_n_t_r_o_l_<_K_e_y_>__.. <> <> NNeeww aanndd mmooddiiffiieedd TTeexxtt wwiiddggeett rreessoouurrcceess iinncclluuddee:: <> <> <>jjuussttiiffyy ((_C_l_a_s_s JJuussttiiffyy))<> <> SSeettss tthhee tteexxtt jjuussttiiffiiccaattiioonn.. CCaann bbee oonnee ooff _l_e_f_t_, _r_i_g_h_t_, _c_e_n_t_e_r,, oorr _f_u_l_l.. OOnnllyy eennaabblleedd wwhheenn tthhee _a_u_t_o_F_i_l_l rreessoouurrccee iiss sseett,, aanndd tthhee rreessoouurrcceess _l_e_f_t_C_o_l_u_m_n aanndd _r_i_g_h_t_C_o_l_u_m_n aarree ccoorrrreeccttllyy sseett.. <> <>lleeffttCCoolluummnn ((_C_l_a_s_s CCoolluummnn))<> <> SSppeecciiffiieess tthhee lleefftt ccoolluummnn aatt wwhhiicchh ttoo bbrreeaakk tteexxtt.. TTeexxtt lliinneess ssttaarrtteedd wwiitthh aann aallpphhaannuummeerriicc cchhaarraacctteerr wwiillll aauuttoommaattiiccaallllyy ssttaarrtt aatt tthhiiss ccoolluummnn.. <> <>ppoossiittiioonnCCaallllbbaacckk ((_C_l_a_s_s CCaallllbbaacckk))<> <> AAlllloowwss iinnssttaallllaattiioonn ooff aa ccaallllbbaacckk ttoo bbee ccaalllleedd eevveerryy ttiimmee tthhee ccuurrssoorr iiss mmoovveedd,, aanndd//oorr tthhee ffiillee cchhaannggeess iittss ssiizzee.. TThhee ccaallllbbaacckk iiss ccaalllleedd wwiitthh aa ppooiinntteerr ttoo aa ssttrruuccttuurree ccoonnttaaiinniinngg tthhee ffoolllloowwiinngg ddaattaa:: <> <> ttyyppeeddeeff ssttrruucctt {{ iinntt lliinnee__nnuummbbeerr;; iinntt ccoolluummnn__nnuummbbeerr;; XXaawwTTeexxttPPoossiittiioonn iinnsseerrtt__ppoossiittiioonn;; XXaawwTTeexxttPPoossiittiioonn llaasstt__ppoossiittiioonn;; BBoooolleeaann oovveerrwwrriittee__mmooddee;; }} XXaawwTTeexxttPPoossiittiioonnIInnffoo;; <> TThhiiss ccaallllbbaacckk iiss iinntteennddeedd ttoo hheellpp pprrooggrraammmmeerrss wwrriittee tteexxtt eeddiittoorrss bbaasseedd oonn tthhee XXaaww wwiiddggeett sseett.. <> <>rreessiizzee ((_C_l_a_s_s RReessiizzee))<> <> NNoo lloonnggeerr ssuuppppoorrtteedd,, bbuutt rreeccooggnniizzeedd ffoorr bbaacckkwwaarrdd ccoommppaattiibbiilliittyy wwiitthh rreessoouurrccee ssppeecciiffiiccaattiioonnss wwrriitttteenn ffoorr tthhee XXaaww66 TTeexxtt wwiiddggeett.. <> <>rriigghhttCCoolluummnn ((_C_l_a_s_s CCoolluummnn))<> <> SSppeecciiffiieess tthhee rriigghhtt ccoolluummnn aatt wwhhiicchh ttoo bbrreeaakk tteexxtt.. TTeexxtt lliinneess ssttaarrtteedd wwiitthh aann aallpphhaannuummeerriicc cchhaarraacctteerr wwiillll aauuttoommaattiiccaallllyy eenndd aatt tthhiiss ccoolluummnn.. <> <>ssccrroollllHHoorriizzoonnttaall ((_C_l_a_s_s SSccrroollll))<> <> <> <> <>ssccrroollllVVeerrttiiccaall ((_C_l_a_s_s SSccrroollll))<> <> TThheessee rreessoouurrcceess ccoonnttrrooll tthhee ppllaacceemmeenntt ooff ssccrroollllbbaarrss oonn tthhee lleefftt aanndd bboottttoomm eeddggeess ooff tthhee TTeexxtt wwiiddggeett.. TThheeyy aacccceepptt tthhee vvaalluueess _X_a_w_t_e_x_t_S_c_r_o_l_l_A_l_w_a_y_s aanndd _X_a_w_t_e_x_t_S_c_r_o_l_l_N_e_v_e_r.. AA ccoonnvveerrtteerr iiss rreeggiisstteerreedd ffoorr tthhiiss rreessoouurrccee tthhaatt wwiillll ccoonnvveerrtt tthhee ffoolllloowwiinngg ssttrriinnggss:: _a_l_w_a_y_s aanndd _n_e_v_e_r.. TThhee vvaalluuee _X_a_w_t_e_x_t_S_c_r_o_l_l_W_h_e_n_N_e_e_d_e_d ((aanndd _w_h_e_n_N_e_e_d_e_d,, rreeccooggnniizzeedd bbyy tthhee ccoonnvveerrtteerr)),, iiss aacccceepptteedd ffoorr bbaacckkwwaarrddss ccoommppaattiibbiilliittyy wwiitthh rreessoouurrccee ssppeecciiffiiccaattiioonnss wwrriitttteenn ffoorr tthhee XXaaww66 TTeexxtt wwiiddggeett,, bbuutt iiggnnoorreedd ((eeffffeeccttiivveellyy ttrreeaatteedd aass _X_a_w_t_e_x_t_S_c_r_o_l_l_N_e_v_e_r)).. <> <> TTEEXXTT SSOOUURRCCEE OOBBJJEECCTT <> TThhee tteexxttSSrrccOObbjjeecctt aalllloowwss ddiissppllaayy ooff iittss ccoonntteennttss ttoo mmoorree tthhaann oonnee wwiinnddooww,, aanndd aallssoo ssttoorreess uunnddoo iinnffoorrmmaattiioonn.. TThhee nneeww rreessoouurrcceess ffoorr tthhee tteexxttSSrrccOObbjjeecctt aarree:: <> <> <>ccaallllbbaacckk ((_C_l_a_s_s CCaallllbbaacckk))<> <> PPrreevviioouuss vveerrssiioonnss ooff XXaaww hhaadd tthhiiss rreessoouurrccee iinn ssuubbccllaasssseess ooff tthhee TTeexxttSSoouurrccee oobbjjeecctt.. TThhiiss wwaass cchhaannggeedd ttoo mmaakkee iitt ppoossssiibbllee ttoo tteellll tthhee ccaallllbbaacckk tthhee ssttaattee ooff tthhee tteexxtt wwhheenn uunnddoo iiss eennaabblleedd.. <> <>eennaabblleeUUnnddoo ((_C_l_a_s_s UUnnddoo))<> <> AA bboooolleeaann rreessoouurrccee tthhaatt eennaabblleess oorr ddiissaabblleess tthhee uunnddoo ffuunnccttiioonn.. TThhee ddeeffaauulltt vvaalluuee iiss FFaallssee.. <> <>ssoouurrcceeCChhaannggeedd ((_C_l_a_s_s CChhaannggeedd))<> <> LLiikkee tthhee ccaallllbbaacckk rreessoouurrccee,, tthhiiss rreessoouurrccee wwaass pprreevviioouussllyy iinn ssuubbccllaasssseess ooff tthhee TTeexxttSSoouurrccee oobbjjeecctt.. IItt iiss nnooww iinn tthhee tteexxttSSrrccOObbjjeecctt ttoo ccoonnttrrooll tthhee cchhaannggeedd//uunncchhaannggeedd ssttaattee wwhheenn uunnddoo iiss eennaabblleedd.. <> <> TTEEXXTT SSIINNKK OOBBJJEECCTT <> TThhee tteexxttSSiinnkkOObbjjeecctt ssuubbccllaasssseess aasscciiiiSSiinnkkOObbjjeecctt aanndd mmuullttiiSSiinnkkOObbjjeecctt hhaavvee bbeeeenn cchhaannggeedd sslliigghhttllyy ttoo uussee aa nneeww ccuurrssoorr sshhaappee ((nnoo lloonnggeerr aa ccaarreett aatt tthhee bbaasseelliinnee)) tthhaatt iinnddiiccaatteess tthhee iinnppuutt ffooccuuss ooff tthhee tteexxtt wwiiddggeett,, aanndd aallllooww ssppeecciiffiiccaattiioonn ooff tthhee ccuurrssoorr ccoolloorr.. TThhee nneeww rreessoouurrccee iiss:: <> <> <>ccuurrssoorrCCoolloorr ((_C_l_a_s_s CCoolloorr))<> <> SSeettss tthhee ccuurrssoorr ccoolloorr ooff tthhee tteexxtt.. TThhiiss ccoolloorr iiss aallssoo uusseedd ttoo ddrraaww sseelleecctteedd tteexxtt.. <> <> SSIIMMPPLLEE MMEENNUU WWIIDDGGEETT <> TThhee ssiimmpplleeMMeennuuWWiiddggeett aallggoorriitthhmm ttoo llaayy oouutt mmeennuu eennttrriieess hhaass bbeeeenn cchhaannggeedd ttoo eennaabbllee mmuullttiippllee ccoolluummnnss wwhheenn aa ssiinnggllee ccoolluummnn ddooeess nnoott ffiitt oonn tthhee ssccrreeeenn.. IItt wwaass aallssoo mmooddiiffiieedd ttoo eennaabbllee ssuubbmmeennuuss.. <> SSMMEE BBSSBB OOBBJJEECCTT <> AA nneeww rreessoouurrccee hhaass bbeeeenn aaddddeedd ttoo tthhee ssmmeeBBSSBBOObbjjeecctt ttoo aallllooww bbiinnddiinngg ssuubbmmeennuuss ttoo iitt.. TThhee nneeww rreessoouurrccee iiss:: <> <> <>mmeennuuNNaammee ((_C_l_a_s_s MMeennuuNNaammee))<> <> SSppeecciiffiieess tthhee nnaammee ooff tthhee ppooppuupp wwiiddggeett ttoo bbee ppooppppeedd uupp wwhheenn tthhee ppooiinntteerr iiss oovveerr tthhee mmeennuu eennttrryy,, oorr NNUULLLL.. NNoottee tthhaatt tthhee nnaammeedd mmeennuu mmuusstt bbee aa cchhiilldd ooff tthhee ppooppuupp ppaarreenntt ooff tthhee ssmmeeBBSSBBOObbjjeecctt.. <> <> RREESSTTRRIICCTTIIOONNSS <> <>XXaaww<> iiss aaccttiivveellyy bbeeiinngg ddeevveellooppeedd.. PPrrooggrraammss iinntteennddiinngg ttoo bbee ffuullllyy ccoommppaattiibbllee wwiitthh ffuuttuurree rreelleeaasseess ooff tthhee XXaaww lliibbrraarryy sshhoouulldd uussee oonnllyy tthhee ppuubblliicc iinntteerrffaacceess.. WWhhiillee wwiiddggeett ssuubbccllaassssiiffiiccaattiioonn iiss nnoott aa bbaadd tthhiinngg,, aanndd ssoommeettiimmeess aann eennccoouurraaggeedd pprrooggrraammmmiinngg pprraaccttiiccee,, pprrooggrraammss tthhaatt aacccceessss pprriivvaattee ddaattaa ssttrruuccttuurreess mmaayy hhaavvee pprroobblleemmss wwiitthh nneewweerr rreelleeaasseess iinn tthhee ccuurrrreenntt ssttaaggee ooff <>XXaaww<> ddeevveellooppmmeenntt.. EEffffoorrttss aarree bbeeiinngg mmaaddee ttoo aavvooiidd ssuucchh pprroobblleemmss aanndd ttoo gguuaarraanntteeee tthhaatt nneewweerr rreelleeaasseess wwiillll bbee ssoouurrccee aanndd bbiinnaarryy ccoommppaattiibbllee.. <> AAUUTTHHOORRSS <> TThhee oorriiggiinnaall XX CCoonnssoorrttiiuumm vveerrssiioonn ooff tthhee AAtthheennaa WWiiddggeett SSeett aanndd iittss ddooccuummeennttaattiioonn wweerree tthhee wwoorrkk ooff mmaannyy ppeeooppllee,, iinncclluuddiinngg CChhrriiss DD.. PPeetteerrssoonn,, RRaallpphh SSwwiicckk,, MMaarrkk AAcckkeerrmmaann,, DDoonnnnaa CCoonnvveerrssee,, JJiimm FFuullttoonn,, LLoorreettttaa GGuuaarriinnoo--RReeiidd,, CChhaarrlleess HHaayynneess,, RRiicchh HHyyddee,, MMaarryy LLaarrssoonn,, JJooeell MMccCCoorrmmaacckk,, RRoonn NNeewwmmaann,, JJeeaannnnee RRiicchh,, TTeerrrryy WWeeiissssmmaann,, MMiikkee GGaannccaarrzz,, PPhhiill KKaarrllttoonn,, KKaatthhlleeeenn LLaannggoonnee,, RRaamm RRaaoo,, SSmmookkeeyy WWaallllaaccee,, AAll MMeennttoo,, aanndd JJeeaann DDiiaazz.. <> XXFFrreeee8866''ss aaddddiittiioonnss aanndd mmooddiiffiiccaattiioonnss ttoo _X_a_w were written by Paulo César Pereira de Andrade.

SEE ALSO

Athena Widget Set - C Language Interface