File: README

package info (click to toggle)
xsnow 1.41-1
  • links: PTS
  • area: non-free
  • in suites: woody
  • size: 308 kB
  • ctags: 178
  • sloc: ansic: 1,214; makefile: 56; sh: 10
file content (170 lines) | stat: -rwxr-xr-x 5,496 bytes parent folder | download | duplicates (2)
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
Copyright 1984,1988,1990,1993-1995,2000 by Rick Jansen, all rights reserved.

 X S N O W
       *
 *   *
   *       *
       *
  *

December 16th 2000

Latest news:
------------
After 5 years here's a new Xsnow! The program has been around bit, and
is now even making it snow on many Windows machines, so it's high time
for an improved verson for X. Xsnow 1.41 works with modern X servers
like XFree86, where older versions made snow build up somewhere in the
sky at times, defying gravity.

Xsnow 1.41 features a new Santa, many thanks to Thomas Linder
(Thomas.Linder@gmx.net).

It is now possible to slow Santa down. See the option -santaupdatefactor

Xsnow 1.41 was tested with Linux (Suse 6.0), SUN Solaris 2.5.1, Silicon
Graphics Irix 6.5. 


Where to get Xsnow:
-------------------
Xsnow is available from the author's WWW page:
  
  http://www.euronet.nl/~rja/

Click on the appropriate item and the tar file will be downloaded
upon your request.

Xsnow is also archived at ftp.x.org in the contrib/games directory.


How to compile:
---------------
To build:
	xmkmf
	make depend
	make
 
To run:
	./xsnow
    or:
	./xsnow&  (in the background)
 
To install (be root):
	make install
	make install.man

If xmkmf does not work and you cannot get a working Makefile that way
then try compiling yourself, eh, xsnow this way: 

	cc -o xsnow snow.c  -lXext -lX11 -lXpm -lm -lsocket -lnsl
 
gcc, SUN Solaris users without a C-compiler, but with gcc installed,
try the following two commands. The first compiles Xsnow, the second
links Xsnow.
 
	gcc -c -O2 -I/usr/openwin/include -DSVR4 -DSYSV xsnow.c
	gcc -o xsnow xsnow.o -O2 -L/usr/openwin/lib -lXext -lX11 -lXpm -lm -lsocket -lnsl
 
Note: Xsnow-1.41 needs the Xpm library. It is available from:

	ftp://ftp.x.org/contrib/libraries/

The current Xpm version is xpm3.4k                                                       


VMS
---
This distribution contains a file 'make.com' to build Xsnow on
VMS systems, and 'xsnow.hlp'. To build type '@make' in the
xsnow directory. Another make.com is make2.com 

Virtual window managers
-----------------------
For compatibility with virtual window managers Xsnow uses 'vroot.h',
an include file that makes X programs compatible with window managers
like swm and tvtwm. The complete vroot distribution is available from
'ftp.x.org' in the contrib directory as 'vroot.shar.Z'.
Vroot was written by Andreas Stolcke <stolcke@ICSI.Berkeley.EDU>, 9/7/90
and is copyright 1991 by Andreas Stolcke, copyright 1990 by Solbourne 
Computer Inc.

Silicon Graphics IRIX 5.x
------------------------
Silicon Graphics and Irix 5.x users may not see any snow or
Santa at all, as long the desktop icons are visible. To
circumvent this problem issue this command:

   /usr/lib/desktop/telldesktop quit

The icons will disappear and xsnow will work perfectly. To
restart the desktop just start /usr/lib/desktop/startdesktop
or select Desktop->Home Directory from the toolchest.

It's even possible to have both - desktop icons and xsnow
(and even multiple desks). You need to modify the window
manager's resource file 4DWm, the file 

  ~/.desktop-`hostname`/4DWm. 

Example:

*Global.backgroundDescription:   -execute /etc/killall -TERM
xsnow ; /usr/local/bin/xsnow
*Desk 1.backgroundDescription:   -execute /etc/killall -TERM
xsnow ; /usr/local/bin/xsnow
*Desk 2.backgroundDescription:   -execute /etc/killall -TERM
xsnow ; /usr/local/bin/xsnow

Restart the he toolchest and Xsnow should appear. What this
does is stop the currently running Xsnow and start a new one
when you switch to another desktop.

HP and hp-ux:
-------------
HP also uses a Workspace Manager which may interfere with Xsnow.
If Xsnow does not appear:
In the "Style Manager", choose "Backdrop" and select "NoBackdrop".
You should now be able to run Xsnow.


Update history
--------------
 1.22 Really building up snow at bottom of screen
 1.22 A choice of Santa's. Thanks to Holger Veit (Holger.Veit@gmd.de)
      for Santa no. 2. Santa 1 was derived from 2 by scaling down.
 1.23 Aaaargh! gnu C doesn't like the initialization of the new
      Santa pixmaps. Extra braces do the trick, which is so often the case
 1.24 Deleted PaintSnowAtBottom. It's more of a surprise this way.
 1.24 Bug removed with windows off-screen to the left
 1.25 Rudolf's red nose. Silly. Grmbll.
 1.25 Bug with -nokeepsnowonwindows removed
 1.27 Bug with erasing snow on top of windows removed
      Erasing of snow at bottom of screen improved in case of expose event
 1.30 Performance improved. Wind.
 1.31 Make.com and xsnow.hlp for VMS
 1.32 unsigned long snowDelay changed to long, as strtoul is troublesome
 1.35 Snow really builds up on windows now, and does not snow on pop-ups.
 1.37 Offset for certain window managers like twm, nokeepsnowonwindows
      and nokeepsnowonscreen are back.
 1.38 Santa is a real snow plough now.
 1.39 usSleep fixed for VMS. Bug resulted in using too much resources.
 1.40 -solidbg for improved performance, memory leak fixed.
 1.41 -santaupdatefactor, fix for X-servers that use backing store, new
			Santa by Thomas Linder

 Copyright
 ---------
 Xsnow is available freely and you may give it to other people as is,
 but I retain all rights. Therefore it does not classify as 'Public
 Domain' software. It *is* allowed to package Xsnow for Unix/Linux 
 distributions, CD-Roms etc, and to make the necessary changes to
 makefiles etc. to facilitate this.

Merry X-mas!

Rick Jansen
--
rja@euronet.nl
http://www.euronet.nl/~rja/