


SUNCLOCK(1)              USER COMMANDS                SUNCLOCK(1)



NAME
     sunclock - show illuminated portion of Earth

SYNOPSIS
     sunclock [ _o_p_t_i_o_n_s ]

DESCRIPTION
     _s_u_n_c_l_o_c_k is an X11 application that displays a  map  of  the
     Earth  and indicates the illuminated portion of the globe by
     drawing sunlit areas dark on light, night areas as light  on
     dark.  It also displays the current date and time.

OPTIONS
     The program does not use the X Toolkit, and hence only those
     options  explicitly  enumerated  below may be used.  Neither
     are any resources used.

     -version
          Show program version and patch level, and then exit.

     -display _d_i_s_p_n_a_m_e
          Give the name of the X server to contact.

     -iconic
          Start iconic.  Usually you will want  to  specify  this
          option.

     -geometry +_x+_y
          Specify the position of the window.  Only the  position
          is used; any size information given is ignored.

     -icongeometry +_x+_y
          Specify the position of the icon.  Only the position is
          used; any size information given is ignored.

HOW IT WORKS
     _s_u_n_c_l_o_c_k calculates the position of the Sun using the  algo-
     rithm in chapter 18 of:

     _A_s_t_r_o_n_o_m_i_c_a_l _F_o_r_m_u_l_a_e _f_o_r _C_a_l_c_u_l_a_t_o_r_s by Jean  Meeus,  Third
     Edition, Richmond: Willmann-Bell, 1985.

     and Mercator projects the illuminated area onto  map  image.
     The  Sun's  position  is  calculated to better than one arc-
     second in accuracy.

BUGS
     The maps are not rescaled if you resize the open  window  or
     icon.   (I don't want to have to store a vector database for
     the map.)  The program  contravenes  section  4.1.9  of  the
     ICCCM  in  that  its  icon  window  is a fixed size, and any
     WM_ICON_SIZE property of the root window is ignored.



Sun Release 4.1           Last change:                          1






SUNCLOCK(1)              USER COMMANDS                SUNCLOCK(1)



     The illuminated area shown is the area which would be sunlit
     if the Earth had no atmosphere.  The actual illuminated area
     is larger because of atmospheric refraction and twilight.

AUTHOR
     John Mackin, Basser Department of Computer Science,  Univer-
     sity   of  Sydney,  Sydney,  Australia;  <john@cs.su.oz.AU>.
     Based on a Suntools program by John Walker, Autodesk,  Inc.;
     <kelvin@acad.uu.NET>.














































Sun Release 4.1           Last change:                          2



