File: README.THEMES

package info (click to toggle)
asclock 2.0.12-33
  • links: PTS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 1,464 kB
  • sloc: ansic: 1,229; sh: 179; makefile: 74
file content (149 lines) | stat: -rw-r--r-- 5,493 bytes parent folder | download | duplicates (9)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
documentation on themes
-----------------------


SPECIAL NOTE FOR THE IMPATIENT: copy your themes to either
/usr/local/share/asclock/ or /usr/share/asclock/


a theme consists of 8 xpms and a position file called 'config'.

all tiles within the same xpm must have the same width or height, except the 
colon which has half the width of the other digits.

the xpm's should have the following names:

  clock.xpm     -  the groundplate in the backhround. If the groundplate has
		   transparent areas, this pixmap should also have a mask bitmap
		   as defined by the XPM standard.
		   Look at one of the examples coming along with this package for
		   infos on how this exactly looks like.
		   asclock will open a window with the size of this pixmap.

  date.xpm	-  contains the numbers for the calendar.
		   format:   '1234567890:' 

  led.xpm       -  contains the numbers for the time display. A colon needs to be
		   here after the numbers, which should have at most half the width
		   of the numbers.
		   format:	'0123456789:(am)(pm)'

		   the colon needs to have half the width of the digits.
		   the 'am' and 'pm' part have 1.5 times the size of a digit.

  month.xpm     -  contains the month names. this will go away and will be replaced
		   by an alphabet, from which the month names will be assembled.
		   format:	'Jan'
				'Feb'
				'Mar'
				'Apr'
				'May'
				'Jun'
				'Jul'
				'Aug'
				'Sep'
				'Oct'
				'Nov'
				'Dec'

  weekday.xpm   -  contains the weekday names. this will go away and will be replaced
		   by an alphabet, from which the month names will be assembled.
		   format:  	'Mon'
				'Tue'
				'Wed'
				'Thr'
				'Fri'
				'Sat'
				'Sun'

  hour.xpm      -  contains an hour pointer for analog clocks.
                   12 o'clock is asumed.

  minute.xpm    -  contains a minute pointer for analog clocks.
                   12 o'clock is asumed.
 
  second.xpm    -  contains the seconds pointer for analog clocks.
                   12 o'clock is asumed.

Here comes the tricky part - the config file:

  config	-  this is an ascii file, specifying the positions of the pixmaps.
		   It can be linked against asclock for default themes, and therefore must
		   be a C- compilable file.
		   If you want to do a theme with time or calendar part only, you
		   could specify a 0 as position. The pixmap will not be displayed then.

		   variable names that can be defined in 'config':

		booleans::   ( 0==no, 1==yes )

                   led_visible     :  time active          
		   week_visible    :  weekday pixmap active
		   cal_visible     :  calendar day active  
		   month_visible   :  month pixmap active  
		   analog_visible  :  use analog clock features
		   hour_visible    :  show the hour pointer
		   min_visible     :  show the minute pointer
		   sec_visible     :  show the second pointer

		integers::

		   led_elem_width  :  time digit width
		   led_elem_height :  time digit height
		   led_24h_hour1_x :  x position of hour digit 1 in 24h format 
		   led_24h_hour2_x :  x position of hour digit 2 in 24h format
		   led_24h_colon_x :  x position of colon in 24h format
		   led_24h_min1_x  :  x postion of minute digit 1 in 24h format
		   led_24h_min2_x  :  x position of minute digit 2 in 24h format
		   led_24h_topy    :  y top line of all time digits in 24h format

		   led_12h_hour1_x :  x position of hour digit 1 in 12h format 
		   led_12h_hour2_x :  x position of hour digit 2 in 12h format
		   led_12h_colon_x :  x position of colon in 12h format
		   led_12h_min1_x  :  x postion of minute digit 1 in 12h format
		   led_12h_min2_x  :  x position of minute digit 2 in 12h format
		   led_ampm_x      :  x position of am/pm led
		   led_ampm_width  :  width of am/pm led
		   led_12_topy     :  y top line of all time digits in 12h format

		   week_elem_width :  weekday element width
		   week_elem_height:  weekday element height
		   week_x          :  weekday x position
		   week_y          :  weekday top y position

		   cal_elem_width  :  calendar element width
		   cal_elem_height :  calendar element height
		   cal1_x          :  x position of calendar digit 1 
		   cal2_x          :  x position of calendar digit 2
		   cal_topy        :  y top line of calendar digits
		   comment: if there is only one calendar digit,
			    the position of the digit is (x1+x2)/2

		   month_elem_width:  month element width
		   month_elem_height: month element height
		   month_x         :  x position of month element
		   month_y         :  y top line of month element

		   hour_center_x   :  center x position on clock.xpm
		   hour_center_y   :  center y position on clock.xpm
                   hour_rot_x      :  rotation origin x pos on hour.xpm
                   hour_rot_y      :  rotation origin y pos on hour.xpm

		   min_center_x    :  center x position on clock.xpm
		   min_center_y    :  center y position on clock.xpm
                   min_rot_x       :  rotation origin x pos on min.xpm
                   min_rot_y       :  rotation origin y pos on min.xpm

		   sec_center_x    :  center x position on clock.xpm
		   sec_center_y    :  center y position on clock.xpm
                   sec_rot_x       :  rotation origin x pos on sec.xpm
                   sec_rot_y       :  rotation origin y pos on sec.xpm

See the different themes directories for examples!!!

To make new themes it usually helps to just copy a similar one
and gradually replace it's elements.

Enjoy.