README
1=============================================
2 asclock - afterstep clock
3=============================================
4
5RELEASE 2.0 beta 11
6 March-13, 1999
7 Copyright (C) Beat Christen, spiff@longstreet.ch
8 Copyright (C) Patrick Rogan, rogan@lycos.com
9
10COPYING
11 This is GPL2 software. Read the file COPYING for infos!
12
13THIS VERSION
14
15 The very special new feature is the possibility to completely
16 construct your own clock look. You are always welcome to send in
17 asclock themes for distribution with the main package. For infos
18 on how to build a new theme, have a look at README.THEMES
19
20 Please note, that there is also a GTK version. Find out more
21 about what this is, here:
22 http://www.gtk.org
23
24 And even an applet for the gnome desktop: See the link below for
25 more infos!
26 http://www.gnome.org
27
28 The theme features will be included in the gtk and applet version
29 asap.
30
31AVAILABILITY
32 the latest releases should be available from
33 http://www.asclock.org/tar/
34
35 All other flavours of asclock are also maintained there.
36
37INSTALL
38 1. Check in the Imakefile if all LIBS are ok for your system.
39 2. `configure`
40 3. `make` (Send me the output if this fails)
41 4. make install
42 5. copy everything in the themes directory to either
43 /usr/local/share/asclock/ or /usr/share/asclock/
44
45FEEDBACK
46 Please send me language customized 'month.xpm' and 'weekday.xpm' files.
47 I prefer uuencoded mail.
48
49AUTHORS
50 Beat Christen
51 Patrick Rogan
52
53CONTRIBUTORS
54 wmaker-dockability: Alfredo K. Kojima
55
56 themes: Pat Rogan
57
58 low-network-
59 bandwidth-patch: Tim Phipps
60
61 close-color-matching-
62 patch: Patrick Rogan
63
64 year-display-patch: Nick Vargish
65
66 dynamic xpm Fredrik Hallenberg
67 loading
68
69 Shape Extensions Dan Weeks
70 and man page
71
72 language specific Carlos Canau
73 files Frank Larsen
74 Andy Lo A Foe
75 Dan Weeks
76 Emanuele Caratti
77 Jorgen Pehrson
78 Vadim V. Klimenko (vadim@max.odessa.ua)
79 Alexey L. Yarovinsky" <aleshka@cortext.co.il>
80 and many more. look at the changes for the
81 respective names.
82
83CHANGES
84 28-May-99 - corrected a little bug that messed up the date.
85 - removed analog theme since that one is not usable.
86
87 13-Mar-99 - beats functionality added
88 - Orb & beats theme added
89 - some config-file changes
90
91 19-Feb-99 - new config file format for themes
92 some functions disappeared from the command-line.
93 If you insist on them, tell me.
94
95 09-Nov-98 - hebrew and japanese added
96
97 08-Nov-98 - themes concept implemented
98 thanks to Pat Rogan for pushing me this way!
99
100 26-Sep-98 - applied different patches supplied by Tim Phipps, Patrick
101 Rogan, Nick Vargish
102 Thanks to all authors for keeping those patches coming!!!
103 11-Apr-98 - loadable xpm's...
104 15-May-97 - slovene added
105 10-Dec-96 - ukrainian & russian added
106 26-Aug-96 - czech added
107 13-Aug-96 - french added
108 6-Aug-96 - spanish added (thanks to David Lazaro Saz khelekir@encomix.es)
109 - hungarian added
110 (thanks to Gyula Matics mgyula@garfield.sch.bme.hu)
111 - breton added (thanks to Jean-Pierre.Messager@univ-brest.fr)
112
113 30-Jul-96 - ClassHints added (patch by Peter Parnes peppar@cdt.luth.se)
114
115 23-Jul-96 - swedish added (by Jorgen Pehrson d93jpe@blg.du.se)
116
117 4-Jul-96 - italian added (by Emanuele Caratti)
118 - improved configure
119
120 21-Jun-96 - '-iconic' state added
121 - usleep did not exist on Solaris 2.4: changed to poll()
122 - better error messages
123
124 8-Jun-96 - '-noblink' feature added
125 - final switch to imake
126
127 30-May-96 - am/pm should not show 0:00 am/pm but 12:00 am/pm
128 - portuguese weekday resized
129 - man page (by Dan Weeks)
130
131 25-May-96 - '-geometry' is now '-position' and it _works_ !!!
132 - in AM/PM mode, no leading one was visible...
133 - '-led' command line option added
134
135 24-May-96 - asclock can start an executable: as default you get a
136 message on console
137 - command line options added (-exe, -geometry, -shape, -12, -24)
138 - Shape-Extension (by Dan Weeks)
139 - now it's a Build script
140 - dutch added (by Andy Lo A Foe <arloafoe@cs.vu.nl>)
141 - norwegian added (by Frank Larsen <frankrl@stud.cs.uit.no>)
142
143 22-May-96 - obscure, not necessary XRaiseWindow removed :)
144 - error-message if Xpm-conversion failed
145 - name changed to 'afterstep clock'
146 - blinking optimized
147 - color selection in Configure
148 - color led added (by James Robinson <jimr@simons-rock.edu>)
149 - portuguese added (by Carlos Canau <canau@dawn.EUnet.pt>)
150 - Makefile improvements
151 - Configure is now for sh
152
153 20-May-96 - english support added (by Dan Weeks <dan@mango.sfasu.edu>)
154 - Language configure script
155 - german weekday widened to same size as english...
156 - Makefile changes for Solaris
157
158 18-May-96 - 8bit greyscale support added
159 - slightly moved the time-led's
160 - no bmclock directory was created while decompressing
161--
162END OF FILE
163
164
165
166
167
168
169
170
171
172
173
README.THEMES
1documentation on themes
2-----------------------
3
4
5SPECIAL NOTE FOR THE IMPATIENT: copy your themes to either
6/usr/local/share/asclock/ or /usr/share/asclock/
7
8
9a theme consists of 8 xpms and a position file called 'config'.
10
11all tiles within the same xpm must have the same width or height, except the
12colon which has half the width of the other digits.
13
14the xpm's should have the following names:
15
16 clock.xpm - the groundplate in the backhround. If the groundplate has
17 transparent areas, this pixmap should also have a mask bitmap
18 as defined by the XPM standard.
19 Look at one of the examples coming along with this package for
20 infos on how this exactly looks like.
21 asclock will open a window with the size of this pixmap.
22
23 date.xpm - contains the numbers for the calendar.
24 format: '1234567890:'
25
26 led.xpm - contains the numbers for the time display. A colon needs to be
27 here after the numbers, which should have at most half the width
28 of the numbers.
29 format: '0123456789:(am)(pm)'
30
31 the colon needs to have half the width of the digits.
32 the 'am' and 'pm' part have 1.5 times the size of a digit.
33
34 month.xpm - contains the month names. this will go away and will be replaced
35 by an alphabet, from which the month names will be assembled.
36 format: 'Jan'
37 'Feb'
38 'Mar'
39 'Apr'
40 'May'
41 'Jun'
42 'Jul'
43 'Aug'
44 'Sep'
45 'Oct'
46 'Nov'
47 'Dec'
48
49 weekday.xpm - contains the weekday names. this will go away and will be replaced
50 by an alphabet, from which the month names will be assembled.
51 format: 'Mon'
52 'Tue'
53 'Wed'
54 'Thr'
55 'Fri'
56 'Sat'
57 'Sun'
58
59 hour.xpm - contains an hour pointer for analog clocks.
60 12 o'clock is asumed.
61
62 minute.xpm - contains a minute pointer for analog clocks.
63 12 o'clock is asumed.
64
65 second.xpm - contains the seconds pointer for analog clocks.
66 12 o'clock is asumed.
67
68Here comes the tricky part - the config file:
69
70 config - this is an ascii file, specifying the positions of the pixmaps.
71 It can be linked against asclock for default themes, and therefore must
72 be a C- compilable file.
73 If you want to do a theme with time or calendar part only, you
74 could specify a 0 as position. The pixmap will not be displayed then.
75
76 variable names that can be defined in 'config':
77
78 booleans:: ( 0==no, 1==yes )
79
80 led_visible : time active
81 week_visible : weekday pixmap active
82 cal_visible : calendar day active
83 month_visible : month pixmap active
84 analog_visible : use analog clock features
85 hour_visible : show the hour pointer
86 min_visible : show the minute pointer
87 sec_visible : show the second pointer
88
89 integers::
90
91 led_elem_width : time digit width
92 led_elem_height : time digit height
93 led_24h_hour_x1 : x position of hour digit 1 in 24h format
94 led_24h_hour_x2 : x position of hour digit 2 in 24h format
95 led_24h_colon_x : x position of colon in 24h format
96 led_24h_min_x1 : x postion of minute digit 1 in 24h format
97 led_24h_min_x2 : x position of minute digit 2 in 24h format
98 led_24h_topy : y top line of all time digits in 24h format
99
100 led_12h_hour_x1 : x position of hour digit 1 in 12h format
101 led_12h_hour_x2 : x position of hour digit 2 in 12h format
102 led_12h_colon_x : x position of colon in 12h format
103 led_12h_min_x1 : x postion of minute digit 1 in 12h format
104 led_12h_min_x2 : x position of minute digit 2 in 12h format
105 led_ampm_x : x position of am/pm led
106 led_ampm_width : width of am/pm led
107 led_12_topy : y top line of all time digits in 12h format
108
109 week_elem_width : weekday element width
110 week_elem_height: weekday element height
111 week_x : weekday x position
112 week_y : weekday top y position
113
114 cal_elem_width : calendar element width
115 cal_elem_height : calendar element height
116 cal_x1 : x position of calendar digit 1
117 cal_x2 : x position of calendar digit 2
118 cal_topy : y top line of calendar digits
119 comment: if there is only one calendar digit,
120 the position of the digit is (x1+x2)/2
121
122 month_elem_width: month element width
123 month_elem_height: month element height
124 month_x : x position of month element
125 month_y : y top line of month element
126
127 hour_center_x : center x position on clock.xpm
128 hour_center_y : center y position on clock.xpm
129 hour_rot_x : rotation origin x pos on hour.xpm
130 hour_rot_y : rotation origin y pos on hour.xpm
131
132 min_center_x : center x position on clock.xpm
133 min_center_y : center y position on clock.xpm
134 min_rot_x : rotation origin x pos on min.xpm
135 min_rot_y : rotation origin y pos on min.xpm
136
137 sec_center_x : center x position on clock.xpm
138 sec_center_y : center y position on clock.xpm
139 sec_rot_x : rotation origin x pos on sec.xpm
140 sec_rot_y : rotation origin y pos on sec.xpm
141
142See the different themes directories for examples!!!
143
144To make new themes it usually helps to just copy a similar one
145and gradually replace it's elements.
146
147Enjoy.
148
149
150