[0m


XSWITCHER(1)	    UNIX Programmer's Manual	     XSWITCHER(1)



[1mNAME
     [0mxswitcher - X11 virtual screen switcher

[1mSYNOPSIS
     xswitcher [0m[ [1m-d [0m_d_i_s_p_l_a_y [1m-i [0m_s_c_r_e_e_n-_n_u_m_b_e_r ]

[1mDESCRIPTION
     [0m_X_s_w_i_t_c_h_e_r is a tool for X servers which have multiple vir-
     tual screens, but only one physical screen - for example,
     Acorn's _X_a_r_m(1).  _X_s_w_i_t_c_h_e_r allows the user to rotate
     through the available screens in either direction.

     When invoked it opens a small window in each of the screens
     available on the specified display.  Each window shows a
     picture of a double-headed arrow and a message identifying
     the screen number that the window is on.  (If the window is
     too small for the message to fit, then just the number is
     displayed, centred in the window.) A press of the left or
     middle mouse button inside the window causes the next screen
     to be displayed.	The screen number is decremented if the
     pointer was in the left half of the _x_s_w_i_t_c_h_e_r window, incre-
     mented if it was in the right half.  In either case, the
     pointer is left inside the _x_s_w_i_t_c_h_e_r window on the new
     screen, such that you are ready to move in the same direc-
     tion again.

     While the input focus is assigned to the _x_s_w_i_t_c_h_e_r window, a
     press on the key corresponding to the number of a screen
     takes you directly to that screen.  If an invalid number is
     pressed, _x_s_w_i_t_c_h_e_r will ring the bell.

     To exit _x_s_w_i_t_c_h_e_r type the string "quit" into one of its
     windows.  The characters must be typed in lower case, con-
     secutively and without any intervening mouse button clicks.
     Exiting has deliberately been made difficult because
     accidentally exiting _x_s_w_i_t_c_h_e_r can sometimes leave you
     stranded on the wrong screen!

[1mOPTIONS
     -d [0m_d_i_s_p_l_a_y

     Use the specfied display instead of the default (which is
     found from environment variable $DISPLAY)

     [1m-i [0m_s_c_r_e_e_n-_n_u_m_b_e_r

     Immediate mode.  Do not open any switcher windows, but
     switch directly to the specified screen and then exit.  This
     is provided so that _x_s_w_i_t_c_h_e_r may be called from window
     manager menus.





Printed 3/11/92     Revision 1.5 of 28/06/90			1






XSWITCHER(1)	    UNIX Programmer's Manual	     XSWITCHER(1)



[1mX DEFAULTS
     [0mThe resource naming scheme has been designed to let the user
     specify colours (and other parameters) on the basis of
     screen number, screen depth, or a mixture of both.  This is
     necessary because the depths and characterisitics of the
     various virtual screens is determined when the X server is
     started, and the user would like to specify once and for all
     a set of resources that will cope adequately with any combi-
     nation of screen characteristics.

     Resources are sought in the resoure database under the name
     by which the program was invoked, usually _x_s_w_i_t_c_h_e_r.  The
     program's class is _X_S_w_i_t_c_h_e_r.  Between the program name and
     the resource name is a field describing which screens the
     resource may be applied to.  This is best explained by exam-
     ple.  In the examples below, each resource is specifying the
     foreground colour.  The examples are presented in order of
     search priority.

     To specify a resource to apply to screen 3 if and only if it
     is of depth 4, say

	  xswitcher.screen3depth4.foreground: Red

     To specify a resource to apply to screen 3, whatever its
     depth, say

	  xswitcher.screen3.foreground: Blue

     To specify a resource that applies to all screens of depth
     4, say

	  xswitcher.depth4.foreground: Green

     To specify a resource that applies to all screens of all
     depths, say

	  xswitcher.foreground: Yellow


     A discussion of all the resources recognised follows.  All
     of these may be specified in any of the ways shown above.

     [1marrowcolour (class Foreground)
	     [0mSpecifies the colour of the double-headed arrow.

     [1mbackground (class Background)
	     [0mSpecifies the colour to be used for the background.

     [1mbordercolour (class Foreground)
	     [0mSpecifies the colour of the border.




Printed 3/11/92     Revision 1.5 of 28/06/90			2






XSWITCHER(1)	    UNIX Programmer's Manual	     XSWITCHER(1)



     [1mborderwidth (class Borderwidth)
	     [0mSpecifies the width of the window border.

     [1mfont (class Font)
	     [0mSpecifies the font to use for the label.  If absent,
	     a default font is chosen automatically.

     [1mforeground (class Foreground)
	     [0mSpecifies the colour to be used for text.

     [1mgeometry (class Geometry)
	     [0mSpecifies the geometry of the window.  Expressed in
	     the usual X11 _w_i_d_t_h[1mx[0m_h_e_i_g_h_t[1m[+-][0m_x_o_f_f_s_e_t[1m[+-][0m_y_o_f_f_s_e_t
	     notation.

     The values of the next three resources may contain the
     string "%d", which if present will be replaced by the screen
     number.  This enables the user to have the screen number in
     the window's title, and hence on the window manager's title
     bar.

     [1miconname (class Title)
	     [0mSpecifies the icon name to be passed to the window
	     manager.

     [1mlabel (class Title)
	     [0mSpecifies the label to be displayed inside the
	     arrow.

     [1mtitle (class Title)
	     [0mSpecifies the window title to be passed to the win-
	     dow manager.

     The default values of the resources are: WhitePixel for
     class Foreground, BlackPixel for class Background, and
     "Xswitcher (%d)" for class Title.	The default size of the
     xswitcher windows is 100x100 pixels.

[1mSEE ALSO
     [0mXarm(1), XWarpPointer(3)

[1mBUGS
     [0mThere should be command-line equivalents of many resources.

     You cannot specify an icon bitmap.

     There should be an option to create an active window icon.

[1mCOPYRIGHT
     [0mCopyright 1989, Acorn Computers Ltd.





Printed 3/11/92     Revision 1.5 of 28/06/90			3






XSWITCHER(1)	    UNIX Programmer's Manual	     XSWITCHER(1)



[1mAUTHOR
     [0mSteve Hunt, Acorn Computers Ltd.





















































Printed 3/11/92     Revision 1.5 of 28/06/90			4



[0m