home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / x / volume14 / tclock / part01 next >
Internet Message Format  |  1991-08-27  |  41KB
  1. Path: uunet!cs.utexas.edu!sun-barr!cronkite.Central.Sun.COM!exodus!austin.eds.com
  2. From: mayoff@austin.eds.com (Rob Mayoff)
  3. Newsgroups: comp.sources.x
  4. Subject: v14i017: tclock -- transparent clock, Part01/01
  5. Message-ID: <19139@exodus.Eng.Sun.COM>
  6. Date: 28 Aug 91 01:31:42 GMT
  7. Sender: news@exodus.Eng.Sun.COM
  8. Lines: 1231
  9. Approved: argv@sun.com
  10.  
  11. Submitted-by: mayoff@austin.eds.com (Rob Mayoff)
  12. Posting-number: Volume 14, Issue 17
  13. Archive-name: tclock/part01
  14.  
  15. +----------+
  16. Moderator's note:
  17.     If you don't have the shape extension *built into your server*, then 
  18.     this program won't work.  Just because you may have -lXext doesn't
  19.     mean you have the shape extensions.  If it doesn't work for you,
  20.     this program is just like a simple analog clock (that doesn't resize).
  21.  
  22.     (also be sure to run xmkmf to make a new Makefile from the Imakefile.)
  23.     --dan
  24. +----------+
  25.  
  26. An oft-asked question on comp.windows.x is "how do I make a transparent
  27. window?"  The program that follows, "tclock", uses the SHAPE extension
  28. to display an analog clock with a "transparent" face.
  29.  
  30. #!/bin/sh
  31. echo tclock/
  32. mkdir tclock
  33. echo tclock/Makefile
  34. cat > tclock/Makefile << \END_OF_Makefile
  35. # Makefile generated by imake - do not edit!
  36. # $XConsortium: imake.c,v 1.51 89/12/12 12:37:30 jim Exp $
  37. #
  38. # The cpp used on this machine replaces all newlines and multiple tabs and
  39. # spaces in a macro expansion with a single space.  Imake tries to compensate
  40. # for this, but is not always successful.
  41. #
  42.  
  43. ###########################################################################
  44. # Makefile generated from "Imake.tmpl" and <Imakefile>
  45. # $XConsortium: Imake.tmpl,v 1.77 89/12/18 17:01:37 jim Exp $
  46. #
  47. # Platform-specific parameters may be set in the appropriate .cf
  48. # configuration files.  Site-wide parameters may be set in the file
  49. # site.def.  Full rebuilds are recommended if any parameters are changed.
  50. #
  51. # If your C preprocessor doesn't define any unique symbols, you'll need
  52. # to set BOOTSTRAPCFLAGS when rebuilding imake (usually when doing
  53. # "make Makefile", "make Makefiles", or "make World").
  54. #
  55. # If you absolutely can't get imake to work, you'll need to set the
  56. # variables at the top of each Makefile as well as the dependencies at the
  57. # bottom (makedepend will do this automatically).
  58. #
  59.  
  60. ###########################################################################
  61. # platform-specific configuration parameters - edit sun.cf to change
  62.  
  63. # platform:  $XConsortium: sun.cf,v 1.38 89/12/23 16:10:10 jim Exp $
  64. # operating system:  SunOS 4.1.1
  65.  
  66. ###########################################################################
  67. # site-specific configuration parameters - edit site.def to change
  68.  
  69. # site:  $XConsortium: site.def,v 1.21 89/12/06 11:46:50 jim Exp $
  70.  
  71.             SHELL = /bin/sh
  72.  
  73.               TOP = .
  74.       CURRENT_DIR = .
  75.  
  76.                AR = ar cq
  77.   BOOTSTRAPCFLAGS =
  78.                CC = cc
  79.  
  80.          COMPRESS = compress
  81.               CPP = /lib/cpp $(STD_CPP_DEFINES)
  82.     PREPROCESSCMD = cc -E $(STD_CPP_DEFINES)
  83.           INSTALL = install
  84.                LD = ld
  85.              LINT = lint
  86.       LINTLIBFLAG = -C
  87.          LINTOPTS = -axz
  88.                LN = ln -s
  89.              MAKE = make
  90.                MV = mv
  91.                CP = cp
  92.            RANLIB = ranlib
  93.   RANLIBINSTFLAGS =
  94.                RM = rm -f
  95.      STD_INCLUDES =
  96.   STD_CPP_DEFINES =
  97.       STD_DEFINES =
  98.  EXTRA_LOAD_FLAGS =
  99.   EXTRA_LIBRARIES =
  100.              TAGS = ctags
  101.  
  102.     SHAREDCODEDEF = -DSHAREDCODE
  103.          SHLIBDEF = -DSUNSHLIB
  104.  
  105.     PROTO_DEFINES =
  106.  
  107.      INSTPGMFLAGS =
  108.  
  109.      INSTBINFLAGS = -m 0755
  110.      INSTUIDFLAGS = -m 4755
  111.      INSTLIBFLAGS = -m 0664
  112.      INSTINCFLAGS = -m 0444
  113.      INSTMANFLAGS = -m 0444
  114.      INSTDATFLAGS = -m 0444
  115.     INSTKMEMFLAGS = -m 4755
  116.  
  117.           DESTDIR =
  118.  
  119.      TOP_INCLUDES = -I$(INCROOT)
  120.  
  121.       CDEBUGFLAGS = -O
  122.         CCOPTIONS =
  123.       COMPATFLAGS =
  124.  
  125.       ALLINCLUDES = $(STD_INCLUDES) $(TOP_INCLUDES) $(INCLUDES) $(EXTRA_INCLUDES)
  126.        ALLDEFINES = $(ALLINCLUDES) $(STD_DEFINES) $(PROTO_DEFINES) $(DEFINES) $(COMPATFLAGS)
  127.            CFLAGS = $(CDEBUGFLAGS) $(CCOPTIONS) $(ALLDEFINES)
  128.         LINTFLAGS = $(LINTOPTS) -DLINT $(ALLDEFINES)
  129.            LDLIBS = $(SYS_LIBRARIES) $(EXTRA_LIBRARIES)
  130.         LDOPTIONS = $(CDEBUGFLAGS) $(CCOPTIONS)
  131.    LDCOMBINEFLAGS = -X -r
  132.  
  133.         MACROFILE = sun.cf
  134.            RM_CMD = $(RM) *.CKP *.ln *.BAK *.bak *.o core errs ,* *~ *.a .emacs_* tags TAGS make.log MakeOut
  135.  
  136.     IMAKE_DEFINES =
  137.  
  138.          IRULESRC = $(CONFIGDIR)
  139.         IMAKE_CMD = $(IMAKE) -DUseInstalled -I$(IRULESRC) $(IMAKE_DEFINES)
  140.  
  141.      ICONFIGFILES = $(IRULESRC)/Imake.tmpl $(IRULESRC)/Imake.rules \
  142.             $(IRULESRC)/Project.tmpl $(IRULESRC)/site.def \
  143.             $(IRULESRC)/$(MACROFILE) $(EXTRA_ICONFIGFILES)
  144.  
  145. ###########################################################################
  146. # X Window System Build Parameters
  147. # $XConsortium: Project.tmpl,v 1.63 89/12/18 16:46:44 jim Exp $
  148.  
  149. ###########################################################################
  150. # X Window System make variables; this need to be coordinated with rules
  151. # $XConsortium: Project.tmpl,v 1.63 89/12/18 16:46:44 jim Exp $
  152.  
  153.           PATHSEP = /
  154.         USRLIBDIR = $(DESTDIR)/usr/local/lib
  155.            BINDIR = $(DESTDIR)/usr/local/bin/X11
  156.           INCROOT = $(DESTDIR)/usr/local/include
  157.      BUILDINCROOT = $(TOP)
  158.       BUILDINCDIR = $(BUILDINCROOT)/X11
  159.       BUILDINCTOP = ..
  160.            INCDIR = $(INCROOT)/X11
  161.            ADMDIR = $(DESTDIR)/usr/local/adm
  162.            LIBDIR = $(USRLIBDIR)/X11
  163.         CONFIGDIR = $(LIBDIR)/config
  164.        LINTLIBDIR = $(USRLIBDIR)/lint
  165.  
  166.           FONTDIR = $(LIBDIR)/fonts
  167.          XINITDIR = $(LIBDIR)/xinit
  168.            XDMDIR = $(LIBDIR)/xdm
  169.            AWMDIR = $(LIBDIR)/awm
  170.            TWMDIR = $(LIBDIR)/twm
  171.            GWMDIR = $(LIBDIR)/gwm
  172.           MANPATH = $(DESTDIR)/usr/local/man
  173.     MANSOURCEPATH = $(MANPATH)/man
  174.            MANDIR = $(MANSOURCEPATH)n
  175.         LIBMANDIR = $(MANSOURCEPATH)3
  176.       XAPPLOADDIR = $(LIBDIR)/app-defaults
  177.  
  178.         SOXLIBREV = 4.2
  179.           SOXTREV = 4.0
  180.          SOXAWREV = 4.0
  181.         SOOLDXREV = 4.0
  182.          SOXMUREV = 4.0
  183.         SOXEXTREV = 4.0
  184.  
  185.        FONTCFLAGS = -t
  186.  
  187.      INSTAPPFLAGS = $(INSTDATFLAGS)
  188.  
  189.             IMAKE = imake
  190.            DEPEND = makedepend
  191.               RGB = rgb
  192.             FONTC = bdftosnf
  193.         MKFONTDIR = mkfontdir
  194.         MKDIRHIER = /bin/sh $(BINDIR)/mkdirhier.sh
  195.  
  196.         CONFIGSRC = $(TOP)/config
  197.         CLIENTSRC = $(TOP)/clients
  198.           DEMOSRC = $(TOP)/demos
  199.            LIBSRC = $(TOP)/lib
  200.           FONTSRC = $(TOP)/fonts
  201.        INCLUDESRC = $(TOP)/X11
  202.         SERVERSRC = $(TOP)/server
  203.           UTILSRC = $(TOP)/util
  204.         SCRIPTSRC = $(UTILSRC)/scripts
  205.        EXAMPLESRC = $(TOP)/examples
  206.        CONTRIBSRC = $(TOP)/../contrib
  207.            DOCSRC = $(TOP)/doc
  208.            RGBSRC = $(TOP)/rgb
  209.         DEPENDSRC = $(UTILSRC)/makedepend
  210.          IMAKESRC = $(CONFIGSRC)
  211.          XAUTHSRC = $(LIBSRC)/Xau
  212.           XLIBSRC = $(LIBSRC)/X
  213.            XMUSRC = $(LIBSRC)/Xmu
  214.        TOOLKITSRC = $(LIBSRC)/Xt
  215.        AWIDGETSRC = $(LIBSRC)/Xaw
  216.        OLDXLIBSRC = $(LIBSRC)/oldX
  217.       XDMCPLIBSRC = $(LIBSRC)/Xdmcp
  218.       BDFTOSNFSRC = $(FONTSRC)/bdftosnf
  219.      MKFONTDIRSRC = $(FONTSRC)/mkfontdir
  220.      EXTENSIONSRC = $(TOP)/extensions
  221.  
  222.   DEPEXTENSIONLIB = $(USRLIBDIR)/libXext.a
  223.      EXTENSIONLIB =  -lXext
  224.  
  225.           DEPXLIB = $(DEPEXTENSIONLIB)
  226.              XLIB = $(EXTENSIONLIB) -lX11
  227.  
  228.       DEPXAUTHLIB = $(USRLIBDIR)/libXau.a
  229.          XAUTHLIB =  -lXau
  230.  
  231.         DEPXMULIB =
  232.            XMULIB = -lXmu
  233.  
  234.        DEPOLDXLIB =
  235.           OLDXLIB = -loldX
  236.  
  237.       DEPXTOOLLIB =
  238.          XTOOLLIB = -lXt
  239.  
  240.         DEPXAWLIB =
  241.            XAWLIB = -lXaw
  242.  
  243.  LINTEXTENSIONLIB = $(USRLIBDIR)/llib-lXext.ln
  244.          LINTXLIB = $(USRLIBDIR)/llib-lX11.ln
  245.           LINTXMU = $(USRLIBDIR)/llib-lXmu.ln
  246.         LINTXTOOL = $(USRLIBDIR)/llib-lXt.ln
  247.           LINTXAW = $(USRLIBDIR)/llib-lXaw.ln
  248.  
  249.           DEPLIBS = $(DEPXAWLIB) $(DEPXMULIB) $(DEPXTOOLLIB) $(DEPXLIB)
  250.  
  251.          DEPLIBS1 = $(DEPLIBS)
  252.          DEPLIBS2 = $(DEPLIBS)
  253.          DEPLIBS3 = $(DEPLIBS)
  254.  
  255. ###########################################################################
  256. # Imake rules for building libraries, programs, scripts, and data files
  257. # rules:  $XConsortium: Imake.rules,v 1.67 89/12/18 17:14:15 jim Exp $
  258.  
  259. ###########################################################################
  260. # start of Imakefile
  261.  
  262.     DEFINES = -DSHAPE -DMITSHM -DMULTIBUFFER -DMITMISC
  263.   SYS_LIBRARIES = -lm
  264. LOCAL_LIBRARIES = $(XLIB)
  265.            SRCS = tclock.c
  266.        OBJS = tclock.o
  267.  
  268.  PROGRAM = tclock
  269.  
  270. all:: tclock
  271.  
  272. tclock: $(OBJS) $(DEPLIBS)
  273.     $(RM) $@
  274.     $(CC) -o $@ $(OBJS) $(LDOPTIONS) $(LOCAL_LIBRARIES) $(LDLIBS) $(EXTRA_LOAD_FLAGS)
  275.  
  276. saber_tclock:
  277.     #load $(ALLDEFINES) $(SRCS) $(LOCAL_LIBRARIES) $(SYS_LIBRARIES) $(EXTRA_LIBRARIES)
  278.  
  279. osaber_tclock:
  280.     #load $(ALLDEFINES) $(OBJS) $(LOCAL_LIBRARIES) $(SYS_LIBRARIES) $(EXTRA_LIBRARIES)
  281.  
  282. install:: tclock
  283.     $(INSTALL) -c $(INSTPGMFLAGS)   tclock $(BINDIR)
  284.  
  285. install.man:: tclock.man
  286.     $(INSTALL) -c $(INSTMANFLAGS) tclock.man $(MANDIR)/tclock.n
  287.  
  288. depend::
  289.     $(DEPEND) -s "# DO NOT DELETE" -- $(ALLDEFINES) -- $(SRCS)
  290.  
  291. lint:
  292.     $(LINT) $(LINTFLAGS) $(SRCS) $(LINTLIBS)
  293. lint1:
  294.     $(LINT) $(LINTFLAGS) $(FILE) $(LINTLIBS)
  295.  
  296. clean::
  297.     $(RM) $(PROGRAM)
  298.  
  299. ###########################################################################
  300. # common rules for all Makefiles - do not edit
  301.  
  302. emptyrule::
  303.  
  304. clean::
  305.     $(RM_CMD) \#*
  306.  
  307. Makefile::
  308.     -@if [ -f Makefile ]; then \
  309.     echo "    $(RM) Makefile.bak; $(MV) Makefile Makefile.bak"; \
  310.     $(RM) Makefile.bak; $(MV) Makefile Makefile.bak; \
  311.     else exit 0; fi
  312.     $(IMAKE_CMD) -DTOPDIR=$(TOP) -DCURDIR=$(CURRENT_DIR)
  313.  
  314. tags::
  315.     $(TAGS) -w *.[ch]
  316.     $(TAGS) -xw *.[ch] > TAGS
  317.  
  318. saber:
  319.     #load $(ALLDEFINES) $(SRCS)
  320.  
  321. osaber:
  322.     #load $(ALLDEFINES) $(OBJS)
  323.  
  324. ###########################################################################
  325. # empty rules for directories that do not have SUBDIRS - do not edit
  326.  
  327. install::
  328.     @echo "install in $(CURRENT_DIR) done"
  329.  
  330. install.man::
  331.     @echo "install.man in $(CURRENT_DIR) done"
  332.  
  333. Makefiles::
  334.  
  335. includes::
  336.  
  337. ###########################################################################
  338. # dependencies generated by makedepend
  339.  
  340.  
  341. END_OF_Makefile
  342. echo tclock/patchlevel.h
  343. cat > tclock/patchlevel.h << \END_OF_patchlevel.h
  344. Version 1.0, Patchlevel 0
  345.  
  346. END_OF_patchlevel.h
  347. echo tclock/Imakefile
  348. cat > tclock/Imakefile << \END_OF_Imakefile
  349.     DEFINES = ExtensionDefines
  350.   SYS_LIBRARIES = -lm
  351. LOCAL_LIBRARIES = $(XLIB)
  352.            SRCS = tclock.c
  353.        OBJS = tclock.o
  354.  
  355. ComplexProgramTarget(tclock)
  356.  
  357. END_OF_Imakefile
  358. echo tclock/tclock.c
  359. cat > tclock/tclock.c << \END_OF_tclock.c
  360. /*
  361.  * tclock.c    Tclock creates a "transparent" clock for the X Window System
  362.  *        using the shaped-window extension of X11R4.
  363.  *
  364.  * Copyright (C) 1991 Rob Mayoff.
  365.  *
  366.  * E-mail: mayoff@ccwf.cc.utexas.edu
  367.  *
  368.  * This program is free software; you can redistribute it and/or modify
  369.  * it under the terms of the GNU General Public License as published by
  370.  * the Free Software Foundation; either version 1, or (at your option)
  371.  * any later version.
  372.  * 
  373.  * This program is distributed in the hope that it will be useful,
  374.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  375.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  376.  * GNU General Public License for more details.
  377.  * 
  378.  * You should have received a copy of the GNU General Public License
  379.  * along with this program; if not, write to the Free Software
  380.  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  381.  */ 
  382.  
  383. #include <stdio.h>
  384. #include <math.h>
  385. #include <X11/Xlib.h>
  386. #include <X11/Xutil.h>
  387. #include <X11/Xos.h>
  388. #include <X11/Xresource.h>
  389. #include <X11/extensions/shape.h>
  390. #include <signal.h>
  391. #include <errno.h>
  392. #include "defaults.h"
  393.  
  394. #define HOURHAND    0
  395. #define MINUTEHAND    1
  396. #define SECONDHAND    2
  397. #define NUMHANDS    3
  398.  
  399. #define NUMVERTICES    5
  400.  
  401. typedef struct
  402. {
  403.   XPoint    vertex[NUMVERTICES];
  404.   int        offset[NUMVERTICES];
  405.   int        radius[NUMVERTICES];
  406.   int        position;
  407. }    Hand;
  408.  
  409. Display *display;
  410. int     screen_number;
  411. Window  rootWindow, mainWindow;
  412. int     ShapeEventNumber, ShapeErrorNumber;
  413. long    clock;
  414. struct tm lastTimes, times;
  415. Pixmap  border, clip;
  416. GC      clearGC, drawGC;
  417. double  cos60[60], sin60[60];
  418. Hand    hand[NUMHANDS];
  419. XArc    tick[12];
  420. XrmDatabase    db;
  421. int    clockRadius;
  422. int    tickRadius;
  423. int    tickSize;
  424. double    scale;
  425. char    appName[200], appClass[200];
  426. XSizeHints    mainSize, savedHints;
  427.  
  428. char *
  429. getOption(o)
  430.   char *o;
  431. {
  432.   XrmValue    value;
  433.   char    *type, key[200], keyClass[200], *p;
  434.  
  435.   
  436.   /* Make the main key */
  437.   sprintf(key, "%s.%s", appName, o);
  438.  
  439.   /* Make the class key */
  440.   sprintf(keyClass, "%s.%s", appClass, o);
  441.   for(p = keyClass; *p; p++)
  442.     if(*p == '.' && *(p+1))
  443.       *(p+1) = toupper(*(p+1));
  444.  
  445.   if(XrmGetResource(db, key, keyClass, &type, &value))
  446.     return value.addr;
  447.   else
  448.     return 0;
  449. }
  450.  
  451. void
  452. initHand(h, s)
  453.   int h;        /* Hand to initialize */
  454.   char *s;        /* Name of hand */
  455. {
  456.   char    rn[1000];    /* Resource name */
  457.   static
  458.   char    *vn[NUMVERTICES-1] =    /* Names of vertices */
  459.     { "tip", "right", "middle", "left" };
  460.   int    i;
  461.  
  462.   clockRadius = -1;
  463.   for(i = 0; i < NUMVERTICES-1; i++)
  464.   {
  465.     sprintf(rn, "%s.%s.radius", s, vn[i]);
  466.     hand[h].radius[i] = scale * atoi(getOption(rn)) + 0.5;
  467.     if(clockRadius < hand[h].radius[i])
  468.       clockRadius = hand[h].radius[i];
  469.     sprintf(rn, "%s.%s.offset", s, vn[i]);
  470.     hand[h].offset[i] = atoi(getOption(rn));
  471.   }
  472.  
  473.   hand[h].radius[i] = hand[h].radius[0];
  474.   hand[h].offset[i] = hand[h].offset[0];
  475. }
  476.  
  477. void
  478. initMisc()
  479. {
  480.   int i, j;
  481.   extern
  482.   double    atof();
  483.  
  484.   for(i=0; i<60; i++)
  485.   {
  486.     cos60[i] = cos((double)i * M_PI * 2.0 / 60);
  487.     sin60[i] = sin((double)i * M_PI * 2.0 / 60);
  488.   }
  489.  
  490.   initHand(HOURHAND, "hour");
  491.   initHand(MINUTEHAND, "minute");
  492.   initHand(SECONDHAND, "second");
  493.  
  494.   tickRadius = scale * atoi(getOption("tick.radius")) + 0.5;
  495.   tickSize = scale * atoi(getOption("tick.size")) + 0.5;
  496.   if((tickRadius + tickSize) > clockRadius)
  497.     clockRadius = tickRadius+tickSize;
  498.  
  499.   for(i=0; i<12; i++)
  500.   {
  501.     j = (i + 9) % 12;
  502.     tick[i].x =
  503.       0.5 + (double)clockRadius + (double)cos60[j*5] * tickRadius - tickSize;
  504.     tick[i].y =
  505.       0.5 + (double)clockRadius + (double)sin60[j*5] * tickRadius - tickSize;
  506.     tick[i].width = tick[i].height = tickSize*2;
  507.     tick[i].angle1 = 0;
  508.     tick[i].angle2 = 360*64;
  509.   }
  510. }
  511.  
  512. void drawHand(h, p)
  513.   int h;        /* Hand number to draw */
  514.   int p;        /* Position at which to draw it */
  515. {
  516.   int i, j;
  517.  
  518.   if(p != hand[h].position)
  519.   {
  520.     hand[h].position = p;
  521.  
  522.     for(j = 0; j < NUMVERTICES - 1; j++)
  523.     {
  524.       i = (p + 45 + hand[h].offset[j]);
  525.       while(i >= 60)    i-=60;
  526.       hand[h].vertex[j].x =
  527.     hand[h].radius[j] * cos60[i] + 0.5 + clockRadius;
  528.       hand[h].vertex[j].y =
  529.     hand[h].radius[j] * sin60[i] + 0.5 + clockRadius;
  530.     }
  531.  
  532.     /* Close the polygon for XDrawLines (sigh) */
  533.     hand[h].vertex[j] = hand[h].vertex[0];
  534.   }
  535.  
  536.   XFillPolygon(display, clip, drawGC, hand[h].vertex, NUMVERTICES-1,
  537.     Nonconvex, CoordModeOrigin);
  538.   XDrawLines(display, clip, clearGC, hand[h].vertex, NUMVERTICES,
  539.     CoordModeOrigin);
  540.  
  541.   XFillPolygon(display, border, drawGC, hand[h].vertex, NUMVERTICES-1,
  542.     Nonconvex, CoordModeOrigin);
  543.   XDrawLines(display, border, drawGC, hand[h].vertex, NUMVERTICES,
  544.     CoordModeOrigin);
  545. }
  546.  
  547. void
  548. reshape()
  549. {
  550.   XFillRectangle(display, border, clearGC, 0, 0,
  551.     clockRadius*2+1, clockRadius*2+1);
  552.   XFillRectangle(display, clip, clearGC, 0, 0,
  553.     clockRadius*2+1, clockRadius*2+1);
  554.  
  555.   if(tickRadius > 0)
  556.   {
  557.     XFillArcs(display, clip, drawGC, tick, 12);
  558.     XDrawArcs(display, clip, clearGC, tick, 12);
  559.  
  560.     XFillArcs(display, border, drawGC, tick, 12);
  561.     XDrawArcs(display, border, drawGC, tick, 12);
  562.   }
  563.  
  564.   if(hand[SECONDHAND].radius[0])
  565.     drawHand(SECONDHAND, times.tm_sec);
  566.   if(hand[MINUTEHAND].radius[0])
  567.     drawHand(MINUTEHAND, times.tm_min);
  568.   if(hand[HOURHAND].radius[0])
  569.     drawHand(HOURHAND, times.tm_hour);    /* Hour converted in sigalrm() */
  570.  
  571.   XShapeCombineMask(display, mainWindow, ShapeBounding, 0, 0, border, ShapeSet);
  572.   XShapeCombineMask(display, mainWindow, ShapeClip, 0, 0, clip, ShapeSet);
  573.  
  574.   XFlush(display, 1);
  575.  
  576.   /* This call to XPending ensures that if the window gets closed, we die */
  577.   XPending(display);
  578. }
  579.  
  580. XTextProperty *
  581. strToTP(s)
  582.   char *s;
  583. {
  584.   extern
  585.   char *malloc();
  586.  
  587.   XTextProperty *tp = (XTextProperty *)malloc(sizeof *tp);
  588.   XStringListToTextProperty(&s, 1, tp);
  589.   return tp;
  590. }
  591.  
  592. int
  593. sigalrm()
  594. {
  595.   clock = time(0);
  596.   times = *localtime(&clock);
  597.   times.tm_hour = times.tm_hour * 5 + times.tm_min / 12;
  598.   reshape();
  599. }
  600.  
  601. unsigned long
  602. getColor(c)
  603.   char *c;
  604. {
  605.   XColor    color;
  606.  
  607.   if(!XParseColor(display, DefaultColormap(display, screen_number),
  608.     c, &color))
  609.     return 0;
  610.   
  611.   XAllocColor(display, DefaultColormap(display, screen_number), &color);
  612.  
  613.   return color.pixel;
  614. }
  615.  
  616. void
  617. usage(name)
  618.   char *name;
  619. {
  620.   fprintf(stderr, "usage: %s [options]\n", name);
  621.   fprintf(stderr, "Options: (options followed by resource equivalents)\n");
  622.   fprintf(stderr, "  -background      .background       Background color\n");
  623.   fprintf(stderr, "  -bg              .background       ...\n");
  624.   fprintf(stderr, "  -border          .border           Border color\n");
  625.   fprintf(stderr, "  -borderWidth     .borderWidth      Border width\n");
  626.   fprintf(stderr, "  -display         .display          X server name\n");
  627.   fprintf(stderr, "  -geometry        .geometry        Clock location\n");
  628.   fprintf(stderr, "  -scale           .scale            Scaling factor\n");
  629.   fprintf(stderr, "  -tickradius      .tick.radius      Tick distance\n");
  630.   fprintf(stderr, "  -ticksize        .tick.size        Tick size\n");
  631.   fprintf(stderr, "  -width           .borderWidth      Border width\n");
  632.   fprintf(stderr, "  -xrm             other resources\n");
  633.   fprintf(stderr, "See defaults.h for other resources.  A tick radius of\n");
  634.   fprintf(stderr, "zero will disable tick marks, for those who like a very\n");
  635.   fprintf(stderr, "abstract clock.  The size part of the geometry strin\n");
  636.   fprintf(stderr, "is ignored - use -scale to adjust the clock size.\n");
  637.   fprintf(stderr, "\nTclock version 1.0, Copyright (C) 1991 Rob Mayoff.\n");
  638.   fprintf(stderr, "Tclock comes with ABSOLUTELY NO WARRANTY.  This is free software, and\n");
  639.   fprintf(stderr, "you are welcome to redistribute it under certain conditions; see the file\n");
  640.   fprintf(stderr, "COPYING included with the distribution for details.\n");
  641. }
  642.  
  643. void
  644. makeAppName(r)
  645.   char *r;
  646. {
  647.   char *p;
  648.  
  649.   for(p = r+strlen(r); p >= r && *p != '/'; p--)
  650.     ;
  651.   strcpy(appName, ++p);
  652.   strcpy(appClass, "Tclock");
  653. }
  654.  
  655. void
  656. main(ac, av)
  657.   int ac;
  658.   char **av;
  659. {
  660.   XSetWindowAttributes  mainAtts;
  661.   XWMHints      mainWM;
  662.   XClassHint    mainClass;
  663.   struct itimerval      old, new;
  664.   int           sigalrm();
  665.   XGCValues     gcv;
  666.   XrmDatabase    cmdDB;
  667.   extern
  668.   char        *getenv();
  669.   char        *displayName, fn[1000];
  670.   int        parseReturn, rc;
  671.  
  672.   XrmParseCommand(&db, option, numOptions, "tclock", &ac, av);
  673.   if(ac>1)
  674.   {
  675.     usage(av[0]);
  676.     exit(1);
  677.   }
  678.  
  679.   makeAppName(av[0]);
  680.  
  681.   displayName = getOption("display");
  682.   cmdDB = db;
  683.  
  684.   if(!displayName)
  685.     displayName = getenv("DISPLAY");
  686.   if(!displayName)
  687.     displayName = ":0";
  688.   display = XOpenDisplay(displayName);
  689.   if(display == 0)
  690.   {
  691.     fprintf("Couldn't open display %s\n", displayName);
  692.     exit(-1);
  693.   }
  694.  
  695.   screen_number = DefaultScreen(display);
  696.   rootWindow = RootWindow(display, screen_number);
  697.  
  698.   if(!XShapeQueryExtension(display, &ShapeEventNumber, &ShapeErrorNumber))
  699.     exit(1);
  700.  
  701.   db = XrmGetStringDatabase(tclockDefaults);
  702.   XrmMergeDatabases(XrmGetStringDatabase(XResourceManagerString(display), &db));
  703.   
  704.   sprintf(fn, "%s/.Xdefaults", getenv("HOME"));
  705.   if(access(fn, R_OK) == 0)
  706.     XrmMergeDatabases(XrmGetFileDatabase(fn), &db);
  707.  
  708.   if(getenv("XENVIRONMENT") && access(getenv("XENVIRONMENT")) == 0)
  709.     XrmMergeDatabases(XrmGetFileDatabase(getenv("XENVIRONMENT")), &db);
  710.  
  711.   XrmMergeDatabases(cmdDB, &db);
  712.  
  713.   scale = atof(getOption("scale"));
  714.   initMisc();
  715.   
  716.   if(getOption("geometry"))
  717.     parseReturn = XParseGeometry(getOption("geometry"), &(mainSize.x),
  718.       &(mainSize.y), &(mainSize.width), &(mainSize.height));
  719.   else
  720.     parseReturn = NoValue;
  721.  
  722.   mainSize.width = clockRadius*2+1;
  723.   mainSize.height = clockRadius*2+1;
  724.   mainSize.flags = 0;
  725.   if(parseReturn&(XValue|YValue))
  726.   {
  727.     mainSize.flags = USPosition;
  728.     if(parseReturn&XValue && parseReturn&XNegative)
  729.       mainSize.x =
  730.     DisplayWidth(display, screen_number) - mainSize.width + mainSize.x-1;
  731.     if(parseReturn&YValue && parseReturn&YNegative)
  732.       mainSize.y =
  733.     DisplayHeight(display, screen_number) - mainSize.height + mainSize.y-1;
  734.   }
  735.  
  736.   mainAtts.border_pixel = getColor(getOption("border"));
  737.   mainAtts.background_pixel = getColor(getOption("background"));
  738.   mainAtts.save_under = 1;
  739.   mainAtts.event_mask = StructureNotifyMask|ButtonPressMask|ButtonReleaseMask;
  740.   mainAtts.do_not_propagate_mask = 0;
  741.   mainWindow = XCreateWindow(display, rootWindow,
  742.     mainSize.x, mainSize.y, mainSize.width, mainSize.height,
  743.     0, DefaultDepth(display, screen_number), InputOutput,
  744.     DefaultVisual(display, screen_number),
  745.     CWBorderPixel|CWBackPixel|CWSaveUnder|CWEventMask|CWDontPropagate,
  746.       &mainAtts);
  747.   
  748.   savedHints = mainSize;
  749.  
  750.   mainWM.flags = 0;
  751.   mainClass.res_name = mainClass.res_class = "xclock";
  752.   XSetWMProperties(display, mainWindow, strToTP("xclock"), strToTP("xclock"),
  753.     av, ac, &mainSize, &mainWM, &mainClass);
  754.  
  755.   border = XCreatePixmap(display, mainWindow, clockRadius*2+1, clockRadius*2+1, 1);
  756.   clip = XCreatePixmap(display, mainWindow, clockRadius*2+1, clockRadius*2+1, 1);
  757.  
  758.   gcv.function = GXclear;
  759.   gcv.join_style = JoinMiter;
  760.   gcv.line_width = atoi(getOption("borderWidth"));
  761.   clearGC = XCreateGC(display, border,
  762.     GCFunction|GCJoinStyle|GCLineWidth, &gcv);
  763.   gcv.function = GXset;
  764.   drawGC = XCreateGC(display, border,
  765.     GCFunction|GCJoinStyle|GCLineWidth, &gcv);
  766.  
  767.   sigalrm();
  768.   XMapRaised(display, mainWindow);
  769.   XFlush(display);
  770.  
  771.   signal(SIGALRM, sigalrm);
  772.   new.it_interval.tv_sec = 1;
  773.   new.it_value.tv_sec = 1;
  774.   new.it_interval.tv_usec = 0;
  775.   new.it_value.tv_usec = 0;
  776.   setitimer(ITIMER_REAL, &new, &old);
  777.  
  778.   for(;;)
  779.     sigpause(0);
  780. }
  781.  
  782. END_OF_tclock.c
  783. echo tclock/defaults.h
  784. cat > tclock/defaults.h << \END_OF_defaults.h
  785. /*
  786.  * defaults.h    This provides the defaults and the command line argument
  787.  *        database for tclock.
  788.  *
  789.  * Copyright (C) 1991 Rob Mayoff.
  790.  *
  791.  * E-mail: mayoff@ccwf.cc.utexas.edu
  792.  *
  793.  * This program is free software; you can redistribute it and/or modify
  794.  * it under the terms of the GNU General Public License as published by
  795.  * the Free Software Foundation; either version 1, or (at your option)
  796.  * any later version.
  797.  * 
  798.  * This program is distributed in the hope that it will be useful,
  799.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  800.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  801.  * GNU General Public License for more details.
  802.  * 
  803.  * You should have received a copy of the GNU General Public License
  804.  * along with this program; if not, write to the Free Software
  805.  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  806.  */ 
  807.  
  808. char *tclockDefaults =
  809. "\
  810. Tclock.Scale:            1\n\
  811. Tclock.Border:            white\n\
  812. Tclock.Background:        black\n\
  813. Tclock.BorderWidth:        0\n\
  814. \
  815. Tclock.Hour.Tip.Radius:        60\n\
  816. Tclock.Hour.Tip.Offset:        0\n\
  817. Tclock.Hour.Right.Radius:    20\n\
  818. Tclock.Hour.Right.Offset:    26\n\
  819. Tclock.Hour.Middle.Radius:    10\n\
  820. Tclock.Hour.Middle.Offset:    30\n\
  821. Tclock.Hour.Left.Radius:    20\n\
  822. Tclock.Hour.Left.Offset:    34\n\
  823. \
  824. Tclock.Minute.Tip.Radius:    100\n\
  825. Tclock.Minute.Tip.Offset:    0\n\
  826. Tclock.Minute.Right.Radius:    20\n\
  827. Tclock.Minute.Right.Offset:    26\n\
  828. Tclock.Minute.Middle.Radius:    10\n\
  829. Tclock.Minute.Middle.Offset:    30\n\
  830. Tclock.Minute.Left.Radius:    20\n\
  831. Tclock.Minute.Left.Offset:    34\n\
  832. \
  833. Tclock.Second.Tip.Radius:    100\n\
  834. Tclock.Second.Tip.Offset:    0\n\
  835. Tclock.Second.Right.Radius:    3\n\
  836. Tclock.Second.Right.Offset:    26\n\
  837. Tclock.Second.Middle.Radius:    30\n\
  838. Tclock.Second.Middle.Offset:    30\n\
  839. Tclock.Second.Left.Radius:    3\n\
  840. Tclock.Second.Left.Offset:    34\n\
  841. \
  842. Tclock.Tick.Radius:        95\n\
  843. Tclock.Tick.Size:        4\n\
  844. ";
  845.  
  846. #define SEP    XrmoptionSepArg
  847. #define XRM    XrmoptionResArg
  848.  
  849. XrmOptionDescRec option[] =
  850. {
  851.   { "-background",    ".background",        SEP, 0 },
  852.   { "-bg",        ".background",        SEP, 0 },
  853.   { "-border",        ".border",        SEP, 0 },
  854.   { "-borderWidth",    ".borderWidth",        SEP, 0 },
  855.   { "-display",        ".display",        SEP, 0 },
  856.   { "-geometry",    ".geometry",        SEP, 0 },
  857.   { "-scale",        ".scale",        SEP, 0 },
  858.   { "-tickradius",    ".tick.radius",        SEP, 0 },
  859.   { "-ticksize",    ".tick.size",        SEP, 0 },
  860.   { "-width",        ".borderWidth",        SEP, 0 },
  861.   { "-xrm",        0,            XRM, 0 },
  862. };
  863. int    numOptions = (sizeof option)/(sizeof(XrmOptionDescRec));
  864.  
  865. END_OF_defaults.h
  866. echo tclock/COPYING
  867. cat > tclock/COPYING << \END_OF_COPYING
  868.  
  869.             GNU GENERAL PUBLIC LICENSE
  870.              Version 1, February 1989
  871.  
  872.  Copyright (C) 1989 Free Software Foundation, Inc.
  873.                     675 Mass Ave, Cambridge, MA 02139, USA
  874.  Everyone is permitted to copy and distribute verbatim copies
  875.  of this license document, but changing it is not allowed.
  876.  
  877.                 Preamble
  878.  
  879.   The license agreements of most software companies try to keep users
  880. at the mercy of those companies.  By contrast, our General Public
  881. License is intended to guarantee your freedom to share and change free
  882. software--to make sure the software is free for all its users.  The
  883. General Public License applies to the Free Software Foundation's
  884. software and to any other program whose authors commit to using it.
  885. You can use it for your programs, too.
  886.  
  887.   When we speak of free software, we are referring to freedom, not
  888. price.  Specifically, the General Public License is designed to make
  889. sure that you have the freedom to give away or sell copies of free
  890. software, that you receive source code or can get it if you want it,
  891. that you can change the software or use pieces of it in new free
  892. programs; and that you know you can do these things.
  893.  
  894.   To protect your rights, we need to make restrictions that forbid
  895. anyone to deny you these rights or to ask you to surrender the rights.
  896. These restrictions translate to certain responsibilities for you if you
  897. distribute copies of the software, or if you modify it.
  898.  
  899.   For example, if you distribute copies of a such a program, whether
  900. gratis or for a fee, you must give the recipients all the rights that
  901. you have.  You must make sure that they, too, receive or can get the
  902. source code.  And you must tell them their rights.
  903.  
  904.   We protect your rights with two steps: (1) copyright the software, and
  905. (2) offer you this license which gives you legal permission to copy,
  906. distribute and/or modify the software.
  907.  
  908.   Also, for each author's protection and ours, we want to make certain
  909. that everyone understands that there is no warranty for this free
  910. software.  If the software is modified by someone else and passed on, we
  911. want its recipients to know that what they have is not the original, so
  912. that any problems introduced by others will not reflect on the original
  913. authors' reputations.
  914.  
  915.   The precise terms and conditions for copying, distribution and
  916. modification follow.
  917.  
  918.             GNU GENERAL PUBLIC LICENSE
  919.    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  920.  
  921.   0. This License Agreement applies to any program or other work which
  922. contains a notice placed by the copyright holder saying it may be
  923. distributed under the terms of this General Public License.  The
  924. "Program", below, refers to any such program or work, and a "work based
  925. on the Program" means either the Program or any work containing the
  926. Program or a portion of it, either verbatim or with modifications.  Each
  927. licensee is addressed as "you".
  928.  
  929.   1. You may copy and distribute verbatim copies of the Program's source
  930. code as you receive it, in any medium, provided that you conspicuously and
  931. appropriately publish on each copy an appropriate copyright notice and
  932. disclaimer of warranty; keep intact all the notices that refer to this
  933. General Public License and to the absence of any warranty; and give any
  934. other recipients of the Program a copy of this General Public License
  935. along with the Program.  You may charge a fee for the physical act of
  936. transferring a copy.
  937.  
  938.   2. You may modify your copy or copies of the Program or any portion of
  939. it, and copy and distribute such modifications under the terms of Paragraph
  940. 1 above, provided that you also do the following:
  941.  
  942.     a) cause the modified files to carry prominent notices stating that
  943.     you changed the files and the date of any change; and
  944.  
  945.     b) cause the whole of any work that you distribute or publish, that
  946.     in whole or in part contains the Program or any part thereof, either
  947.     with or without modifications, to be licensed at no charge to all
  948.     third parties under the terms of this General Public License (except
  949.     that you may choose to grant warranty protection to some or all
  950.     third parties, at your option).
  951.  
  952.     c) If the modified program normally reads commands interactively when
  953.     run, you must cause it, when started running for such interactive use
  954.     in the simplest and most usual way, to print or display an
  955.     announcement including an appropriate copyright notice and a notice
  956.     that there is no warranty (or else, saying that you provide a
  957.     warranty) and that users may redistribute the program under these
  958.     conditions, and telling the user how to view a copy of this General
  959.     Public License.
  960.  
  961.     d) You may charge a fee for the physical act of transferring a
  962.     copy, and you may at your option offer warranty protection in
  963.     exchange for a fee.
  964.  
  965. Mere aggregation of another independent work with the Program (or its
  966. derivative) on a volume of a storage or distribution medium does not bring
  967. the other work under the scope of these terms.
  968.  
  969.   3. You may copy and distribute the Program (or a portion or derivative of
  970. it, under Paragraph 2) in object code or executable form under the terms of
  971. Paragraphs 1 and 2 above provided that you also do one of the following:
  972.  
  973.     a) accompany it with the complete corresponding machine-readable
  974.     source code, which must be distributed under the terms of
  975.     Paragraphs 1 and 2 above; or,
  976.  
  977.     b) accompany it with a written offer, valid for at least three
  978.     years, to give any third party free (except for a nominal charge
  979.     for the cost of distribution) a complete machine-readable copy of the
  980.     corresponding source code, to be distributed under the terms of
  981.     Paragraphs 1 and 2 above; or,
  982.  
  983.     c) accompany it with the information you received as to where the
  984.     corresponding source code may be obtained.  (This alternative is
  985.     allowed only for noncommercial distribution and only if you
  986.     received the program in object code or executable form alone.)
  987.  
  988. Source code for a work means the preferred form of the work for making
  989. modifications to it.  For an executable file, complete source code means
  990. all the source code for all modules it contains; but, as a special
  991. exception, it need not include source code for modules which are standard
  992. libraries that accompany the operating system on which the executable
  993. file runs, or for standard header files or definitions files that
  994. accompany that operating system.
  995.  
  996.   4. You may not copy, modify, sublicense, distribute or transfer the
  997. Program except as expressly provided under this General Public License.
  998. Any attempt otherwise to copy, modify, sublicense, distribute or transfer
  999. the Program is void, and will automatically terminate your rights to use
  1000. the Program under this License.  However, parties who have received
  1001. copies, or rights to use copies, from you under this General Public
  1002. License will not have their licenses terminated so long as such parties
  1003. remain in full compliance.
  1004.  
  1005.   5. By copying, distributing or modifying the Program (or any work based
  1006. on the Program) you indicate your acceptance of this license to do so,
  1007. and all its terms and conditions.
  1008.  
  1009.   6. Each time you redistribute the Program (or any work based on the
  1010. Program), the recipient automatically receives a license from the original
  1011. licensor to copy, distribute or modify the Program subject to these
  1012. terms and conditions.  You may not impose any further restrictions on the
  1013. recipients' exercise of the rights granted herein.
  1014.  
  1015.   7. The Free Software Foundation may publish revised and/or new versions
  1016. of the General Public License from time to time.  Such new versions will
  1017. be similar in spirit to the present version, but may differ in detail to
  1018. address new problems or concerns.
  1019.  
  1020. Each version is given a distinguishing version number.  If the Program
  1021. specifies a version number of the license which applies to it and "any
  1022. later version", you have the option of following the terms and conditions
  1023. either of that version or of any later version published by the Free
  1024. Software Foundation.  If the Program does not specify a version number of
  1025. the license, you may choose any version ever published by the Free Software
  1026. Foundation.
  1027.  
  1028.   8. If you wish to incorporate parts of the Program into other free
  1029. programs whose distribution conditions are different, write to the author
  1030. to ask for permission.  For software which is copyrighted by the Free
  1031. Software Foundation, write to the Free Software Foundation; we sometimes
  1032. make exceptions for this.  Our decision will be guided by the two goals
  1033. of preserving the free status of all derivatives of our free software and
  1034. of promoting the sharing and reuse of software generally.
  1035.  
  1036.                 NO WARRANTY
  1037.  
  1038.   9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  1039. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  1040. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  1041. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  1042. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  1043. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  1044. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  1045. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  1046. REPAIR OR CORRECTION.
  1047.  
  1048.   10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  1049. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  1050. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  1051. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  1052. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  1053. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  1054. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  1055. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  1056. POSSIBILITY OF SUCH DAMAGES.
  1057.  
  1058.              END OF TERMS AND CONDITIONS
  1059.  
  1060.     Appendix: How to Apply These Terms to Your New Programs
  1061.  
  1062.   If you develop a new program, and you want it to be of the greatest
  1063. possible use to humanity, the best way to achieve this is to make it
  1064. free software which everyone can redistribute and change under these
  1065. terms.
  1066.  
  1067.   To do so, attach the following notices to the program.  It is safest to
  1068. attach them to the start of each source file to most effectively convey
  1069. the exclusion of warranty; and each file should have at least the
  1070. "copyright" line and a pointer to where the full notice is found.
  1071.  
  1072.     <one line to give the program's name and a brief idea of what it does.>
  1073.     Copyright (C) 19yy  <name of author>
  1074.  
  1075.     This program is free software; you can redistribute it and/or modify
  1076.     it under the terms of the GNU General Public License as published by
  1077.     the Free Software Foundation; either version 1, or (at your option)
  1078.     any later version.
  1079.  
  1080.     This program is distributed in the hope that it will be useful,
  1081.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  1082.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  1083.     GNU General Public License for more details.
  1084.  
  1085.     You should have received a copy of the GNU General Public License
  1086.     along with this program; if not, write to the Free Software
  1087.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  1088.  
  1089. Also add information on how to contact you by electronic and paper mail.
  1090.  
  1091. If the program is interactive, make it output a short notice like this
  1092. when it starts in an interactive mode:
  1093.  
  1094.     Gnomovision version 69, Copyright (C) 19xx name of author
  1095.     Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  1096.     This is free software, and you are welcome to redistribute it
  1097.     under certain conditions; type `show c' for details.
  1098.  
  1099. The hypothetical commands `show w' and `show c' should show the
  1100. appropriate parts of the General Public License.  Of course, the
  1101. commands you use may be called something other than `show w' and `show
  1102. c'; they could even be mouse-clicks or menu items--whatever suits your
  1103. program.
  1104.  
  1105. You should also get your employer (if you work as a programmer) or your
  1106. school, if any, to sign a "copyright disclaimer" for the program, if
  1107. necessary.  Here a sample; alter the names:
  1108.  
  1109.   Yoyodyne, Inc., hereby disclaims all copyright interest in the
  1110.   program `Gnomovision' (a program to direct compilers to make passes
  1111.   at assemblers) written by James Hacker.
  1112.  
  1113.   <signature of Ty Coon>, 1 April 1989
  1114.   Ty Coon, President of Vice
  1115.  
  1116. That's all there is to it!
  1117.  
  1118. END_OF_COPYING
  1119. echo tclock/tclock.man
  1120. cat > tclock/tclock.man << \END_OF_tclock.man
  1121. .TH TCLOCK 1 "Release 4" "X Version 11"
  1122. .SH NAME
  1123. tclock \- display time of day
  1124. .SH SYNOPSIS
  1125. .B tclock
  1126. [-option ...]
  1127. .SH DESCRIPTION
  1128. .I Tclock
  1129. displays an analog clock with a transparent face.
  1130. .SH OPTIONS
  1131. .TP 8
  1132. .B \-background \fIbackground-color\fB
  1133. specify the color of the interior of the clock
  1134. .TP 8
  1135. .B \-bg \fIbackground-color\fB
  1136. same as \-background
  1137. .TP 8
  1138. .B \-border \fIborder-color\fB
  1139. specify the color of the clock border
  1140. .TP 8
  1141. .B \-borderWidth \fIborder-width\fB
  1142. specify the thickness of the border \- this is used as the line-width
  1143. attribute of a graphics context, so a border width of zero still results
  1144. in a thin border.  If you want \fIno\fP border at all, make the border
  1145. color the same as the background color.
  1146. .TP 8
  1147. .B \-display \fIdisplay-name\fB
  1148. specify the name of the display to use
  1149. .TP 8
  1150. .B \-geometry \fIclock-geometry\fB
  1151. specify the geometry of the clock.  Note that the size specification of
  1152. this string will be ignored; see the \fI\-scale\fP option for changing
  1153. the size of the clock.
  1154. .TP 8
  1155. .B \-scale \fIclock-size\fB
  1156. specify the size of the clock as a scale of the normal size.  For example,
  1157. \-scale 0.5 results in a clock half the size of the default (in width
  1158. and height - one-fourth the size in area), and \-scale 2.5 results in a
  1159. clock two and one-half times larger.
  1160. .TP 8
  1161. .B \-tickradius \fItick-distance\fB
  1162. specify the distance of each tick from the center of the clock.  Specifying
  1163. zero results in no tick marks.  Note that this is adjusted by the \-scale
  1164. option.
  1165. .TP 8
  1166. .B \-ticksize \fItick-size\fB
  1167. specify the radius of each tick mark.  Note that this is adjusted by the
  1168. \-scale option; however, ticks do not seem to scale well, so if you regularly
  1169. start up the clock at a specific scaling amount, you may wish to fine-tune
  1170. this parameter for best results.
  1171. .TP 8
  1172. .B \-width \fIborder-width\fB
  1173. same as \-borderWidth
  1174. .TP 8
  1175. .B \-xrm \fImiscellaneous-resource\fB
  1176. specify a resource for which no command-line option exists.  This is most
  1177. often used to disable the second hand by specifying \fI\-xrm
  1178. "Tclock.Second.Tip.Radius: 0".
  1179. .SH RESOURCES
  1180. .LP
  1181. The resources equivalent to command-line options are
  1182. .IP
  1183. Tclock.geometry
  1184. .br
  1185. Tclock.scale
  1186. .br
  1187. Tclock.border
  1188. .br
  1189. Tclock.background
  1190. .br
  1191. Tclock.borderWidth
  1192. .br
  1193. Tclock.tick.radius
  1194. .br
  1195. Tclock.tick.size
  1196. .LP
  1197. In addition, each hand of the clock is made up of four points.  You may
  1198. specify the position of each of these four points for each hand.  The hand
  1199. specifications are {hour, minute, second}, and the point specifications are
  1200. {tip, right, middle, left}.  Each point has two resources:
  1201. .IP
  1202. Tclock.\fIhand\fP.\fIpoint\fP.radius
  1203. .br
  1204. Tclock.\fIhand\fP.\fIpoint\fP.offset
  1205. .LP
  1206. The radius specifies the distance in pixels of that points from the center
  1207. of the clock.  The offset specifies the angle of that point as an offset in
  1208. minutes (sixtieths of a circle) from the "true" position of the hand.
  1209. Specifying a radius of zero for the tip of a hand disables that hand.
  1210. .LP
  1211. Note that after you have fine-tuned the shapes of the hands, you can simply
  1212. use the \-scale option (or the .scale resource) to get any size clock with
  1213. hands of that shape, without needing to adjust the radii of all those points.
  1214. .SH "SEE ALSO"
  1215. oclock(1), xclock(1)
  1216. .SH COPYRIGHT
  1217. Copyright (C) 1991 Rob Mayoff.
  1218.  
  1219. This program is free software; you can redistribute it and/or modify
  1220. it under the terms of the GNU General Public License as published by
  1221. the Free Software Foundation; either version 1, or (at your option)
  1222. any later version.
  1223.  
  1224. This program is distributed in the hope that it will be useful,
  1225. but WITHOUT ANY WARRANTY; without even the implied warranty of
  1226. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  1227. GNU General Public License for more details.
  1228.  
  1229. You should have received a copy of the GNU General Public License
  1230. along with this program; if not, write to the Free Software
  1231. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  1232. .SH AUTHOR
  1233. Rob Mayoff (mayoff@ccwf.cc.utexas.edu)
  1234.  
  1235. END_OF_tclock.man
  1236.  
  1237. --
  1238. Dan Heller
  1239. O'Reilly && Associates       Z-Code Software    Comp-sources-x:
  1240. Senior Writer                President          comp-sources-x@uunet.uu.net
  1241. argv@ora.com                 argv@zipcode.com
  1242.