File: ARTWORK

package info (click to toggle)
wmcdplay 1.0beta1-13
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 640 kB
  • ctags: 831
  • sloc: cpp: 1,487; sh: 9; makefile: 6
file content (275 lines) | stat: -rw-r--r-- 9,089 bytes parent folder | download
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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
wmcdplay - A cd player designed for WindowMaker
05/09/98  Release 1.0 Beta1
Copyright (C) 1998  Sam Hawker <shawkie@geocities.com>
This software comes with ABSOLUTELY NO WARRANTY
This software is free software, and you are welcome to redistribute it
under certain conditions
See the README file for a more complete notice.


ARTWORK
=======

The artwork mechanism allows you to customise the appearance (and more) of
wmcdplay at run-time, by loading an artwork file with the "-f artwork_file"
command line argument - yes, THIS IS A CHANGE!!!!! IT USED TO BE "-a"
                             ----------------------------------------

This file trys to explain how to create artwork files. Please feel free to send
me comments or improved versions.


BASICS
======

wmcdplay can be in any one of 6 states:
   Data     0
   Stopped  1
   Playing  2
   Paused   3
   NoCD     4
   TrayOpen 5

wmcdplay buttons can perform any of 10 actions, and the action can
depend on the current state of wmcdplay:
   NOTHING 0
   Stop    1
   Play    2
   Pause   3
   Resume  4
   Prev    5
   Next    6
   Rewd    7
   FFwd    8
   Eject   9
   Close   10


PIXMAPS
=======

The following symbolic color names may be used in any pixmaps:
   led_color_high
   led_color_med
   led_color_low
   color_back
and should be used appropriately to ensure that the led and background
colors can be set at runtime with the "-l led_color" and "-back_color"
command line arguments

led.xpm
-------
   This pixmap is used by wmcdplay to draw the digits of the time and
   track displays
   It represents the string of characters: "00112233445566778899  DDAATTNNOOCC--PPEE:;_"
   "00" means the character "0" but states that it is double width (eg 7+1 pixels wide)
   ":" means the character ":" which is only single width (eg 3+1 pixels wide)
   ";" means an unlit ":" single width character
   "_" means a single width "-" character
   The digit size used does not matter, but ensure that 1 pixel spaces are left between
   digits and that (double width + 1 space) = 2 * (single width + 1 space)
   eg.                            ( 7 + 1 ) = 2 * ( 3 + 1 )
   Transparency is _NOT_ interpreted
   This file must begin with these 2 lines (character perfect):

/* XPM */
static char * led_xpm[] = {

ledsym.xpm
----------
   This pixmap is used by wmcdplay to draw the symbols illustrating the current status
   It should contain symbols for the following (in sequence):
      Data, Stopped, Playing, Paused, NoCD, TrayOpen
   The symbol size used does not matter, but ensure that 1 pixel spaces are left between
   symbols
   Transparency is _NOT_ interpreted
   This file must begin with these 2 lines (character perfect):

/* XPM */
static char * ledsym_xpm[] = {

ledtsel.xpm
-----------
   This pixmap is used by wmcdplay to draw the symbols illustrating the current track
   selection mode
   It should contain symbols for the following (in sequence):
      None, Next, Repeat, RepeatCD, Random
   The symbol size used does not matter, but ensure that 1 pixel spaces are left between
   symbols
   Transparency is _NOT_ interpreted
   This file must begin with these 2 lines (character perfect):

/* XPM */
static char * ledtsel_xpm[] = {

symbols.xpm
-----------
   This pixmap contains the symbols to be drawn onto the buttons
   It should contain symbols for the following (in sequence):
      NOTHING, Stop, Play, Pause, Resume, Prev, Next, Rewd, FFwd, Eject, Close
   The symbol size used does not matter, but ensure that 1 pixel spaces are left between
   symbols
   Transparency _IS_ interpreted
   This file must begin with these 2 lines (character perfect):

/* XPM */
static char * symbols_xpm[] = {
   
cdplayer.xpm
------------
   This pixmap provides the basic background for wmcdplay
   It _must_ be 64x64 pixels
   It should provide solid areas (the size and color of which will depend on the
   led.xpm, ledsym.xpm and ledtsel.xpm files used), for any required displays to
   be drawn onto
   These areas are usually bordered in some way
   It can also be used to provide solid areas which can form buttons
   (Although the button symbols can themselves form the buttons)
   Transparency _IS_ interpreted
   This file must begin with these 2 lines (character perfect):

/* XPM */
static char * cdplayer_xpm[] = {


THE DATA FILE - artwork.dat
===========================

So far, all we have in our artwork file is a set of pixmaps. But we also
need a data file (artwork.dat), to answer the following questions:

   How many buttons are there?
   Where exactly is each button?
   What does each button do?
   Should do-NOTHING buttons be hidden?
   Which led displays are there?
   Where are they?

The formats of entries in this file must follow the examples given quite closely.
Basically, anything before an '=' must appear exactly as shown and at the
beginning of the line (not indented as here). Also, all entries must be on a single
line unless shown otherwise here.
Comments and blank lines are, however, perfectly legal (between entries).

How many buttons?
-----------------
   eg.

   int art_nbtns=5;

Where exactly is each button?
-----------------------------
   Buttons must be shaped as convex polygons, so you give the position
   (and shape) of each as a list of coordinates of its verticies.
   The polygon defined by these points is used to interpret mouse clicks,
   and also (optionally) to hide do-NOTHING buttons.

   Also, tell wmcdplay where on the button to put the symbol. This is in the
   form of the co-ordinates of the top-left corner of the symbol, relative
   to the top-left corner of wmcdplay.
   A single entry, defines all buttons.

   eg.

   int art_btns[]={ 8  , 38 , 5  , 5  , 27 , 7  , 27 , 20 , 40 , 7  , 54 , 5  , 54 ,
                    19 , 26 , 5  , 6  , 22 , 28 , 22 , 28 , 39 , 22 , 39 , 6  , 24 ,
                    19 , 50 , 5  , 6  , 57 , 21 , 42 , 28 , 42 , 28 , 59 , 6  , 59 ,
                    35 , 26 , 5  , 31 , 22 , 52 , 22 , 52 , 24 , 37 , 39 , 31 , 39 ,
                    51 , 31 , 5  , 42 , 36 , 56 , 22 , 59 , 22 , 59 , 39 , 42 , 39 };

   Each line defines 1 button:
   symbol_x , symbol_y , num_vertices , x1 , y1 , x2 , y2 , x3 , y3 , x4 , y4 , x5 , y5

   Different buttons may have different numbers of vertices, so different numbers of fields.
   The button must be a _convex_ polygon, and the vertices must be given in sequence, going
   _clockwise_ around the button.

What does each button do?
-------------------------
   This is answered with a set of integer actions (see list given earlier) for each button,
   for each state (see list given earlier):

   wmcdplay state:     0   1   2   3   4   5

                       D   S   P   P   N   T
                       A   T   L   A   O   R
                       T   O   A   U       A
                       A   P   Y   S   C   Y
                           P   I   E   D    
                       T   E   N   D       O
                       R   D   G           P
                       K                   E
                                           N

   eg.

   int art_actions[]={ 0 , 2 , 3 , 4 , 0 , 0  ,
                       5 , 5 , 5 , 0 , 0 , 0  ,
                       6 , 6 , 6 , 0 , 0 , 0  ,
                       0 , 0 , 1 , 1 , 0 , 0  ,
                       9 , 9 , 9 , 9 , 9 , 10 };

Should do-NOTHING buttons be hidden?
------------------------------------
   This can be set so that whenever a button has NOTHING assigned to it, it is hidden
   (using the region defined by style_btns). Otherwise it is left and the symbol
   representing NOTHING is drawn onto it.

   eg.

   bool art_hidebtns=false;

Which led displays are there?
-----------------------------

   eg.

   bool style_leds[4]={ true, true, false, false};

   That's basically:
   show_time=true , show_track=true , show_status=false , show_trksel=false

Where are they?
---------------
   eg.

   int art_ledpos[3][2]={ 8 , 7 , 37 , 45 , 0 , 0 , 0 , 0 };

   That's basically:
   time_x=8 , time_y=7 , track_x=37 , track_y=45 , status_x=0 , status_y=0 , trksel_x=0 , trksel_y=0

   These are the co-ordinates of the top-left corner of each display
   relative to the top-left corner of wmcdplay.
   You should enter valid integers even for displays which you have
   chosen not to use.


ARTWORK FILES
=============

   Suppose you have created the files as outlined above in the directory
   ~/wmcdplay/foo.  Then you can run

      cd ~/wmcdplay
      /usr/lib/wmcdplay/makeart foo

   You can then use your new artwork file by running

      wmcdplay -f ~/wmcdplay/foo.art

   Additionally, you can run

      sudo mv ~/wmcdplay/foo.art /usr/share/wmcdplay

   And then you only need to run

      wmcdplay -f foo.art

   If you have created multiple artwork files in separate subdirectories of
   ~/wmcdplay, you can convert them to .art files all at once using

      cd ~/wmcdplay
      /usr/lib/wmcdplay/makeall

   Finally, if you compile wmcdplay from source, you can replace the default
   artwork file with another by pointing the symlink XPM/standard.art at it.