version 5, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
XScreenSaver |
|
|
2 |
!!!XScreenSaver |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
ENVIRONMENT |
|
|
8 |
SEE ALSO |
|
|
9 |
COPYRIGHT |
|
|
10 |
AUTHOR |
|
|
11 |
---- |
|
|
12 |
!!NAME |
|
|
13 |
|
|
|
14 |
|
|
|
15 |
blitspin - rotate a bitmap in an interesting way |
|
|
16 |
!!SYNOPSIS |
|
|
17 |
|
|
|
18 |
|
|
|
19 |
__blitspin__ [[-display ''host:display.screen''] |
|
|
20 |
[[-foreground ''color''] [[-background ''color''] |
|
|
21 |
[[-window] [[-root] [[-mono] [[-install] [[-visual ''visual''] |
|
|
22 |
[[-bitmap ''filename''] [[-delay ''usecs''] [[-delay2 |
|
|
23 |
''usecs''] |
|
|
24 |
!!DESCRIPTION |
|
|
25 |
|
|
|
26 |
|
|
|
27 |
The ''blitspin'' program repeatedly rotates a bitmap by |
|
|
28 |
90 degrees by using logical operations: the bitmap is |
|
|
29 |
divided into quadrants, and the quadrants are shifted |
|
|
30 |
clockwise. Then the same thing is done again with |
|
|
31 |
progressively smaller quadrants, except that all |
|
|
32 |
sub-quadrants of a given size are rotated in parallel. So |
|
|
33 |
this takes __O(16*log2(N))__ blits of size NxN, with the |
|
|
34 |
limitation that the image must be square, and the size must |
|
|
35 |
be a power of 2. |
|
|
36 |
!!OPTIONS |
|
|
37 |
|
|
|
38 |
|
|
|
39 |
''blitspin'' accepts the following options: |
|
|
40 |
|
|
|
41 |
|
|
|
42 |
__-window__ |
|
|
43 |
|
|
|
44 |
|
|
|
45 |
Draw on a newly-created window. This is the |
|
|
46 |
default. |
|
|
47 |
|
|
|
48 |
|
|
|
49 |
__-root__ |
|
|
50 |
|
|
|
51 |
|
|
|
52 |
Draw on the root window. |
|
|
53 |
|
|
|
54 |
|
|
|
55 |
__-mono__ |
|
|
56 |
|
|
|
57 |
|
|
|
58 |
If on a color display, pretend we're on a monochrome |
|
|
59 |
display. |
|
|
60 |
|
|
|
61 |
|
|
|
62 |
__-install__ |
|
|
63 |
|
|
|
64 |
|
|
|
65 |
Install a private colormap for the window. |
|
|
66 |
|
|
|
67 |
|
|
|
68 |
__-visual__ ''visual'' |
|
|
69 |
|
|
|
70 |
|
|
|
71 |
Specify which visual to use. Legal values are the name of a |
|
|
72 |
visual class, or the id number (decimal or hex) of a |
|
|
73 |
specific visual. |
|
|
74 |
|
|
|
75 |
|
|
|
76 |
__-bitmap__ ''filename'' |
|
|
77 |
|
|
|
78 |
|
|
|
79 |
The file name of a bitmap to rotate. It need not be square: |
|
|
80 |
it will be padded with the background color. If unspecified |
|
|
81 |
or the string ''(default)'', a builtin bitmap is |
|
|
82 |
used. |
|
|
83 |
|
|
|
84 |
|
|
|
85 |
If support for the ''XPM'' library was enabled at |
|
|
86 |
compile-time, the specified file may be in ''XPM'' format |
|
|
87 |
as well as ''XBM'', and thus may be a color |
|
|
88 |
image. |
|
|
89 |
|
|
|
90 |
|
|
|
91 |
The __*bitmapFilePath__ resource will be searched if the |
|
|
92 |
bitmap name is not a fully-qualified pathname. |
|
|
93 |
|
|
|
94 |
|
|
|
95 |
__-grab-screen__ |
|
|
96 |
|
|
|
97 |
|
|
|
98 |
If this option is specified, then the image which is spun |
|
|
99 |
will be grabbed from the portion of the screen underlying |
|
|
100 |
the blitspin window, or from the system's video input, or |
|
|
101 |
from a random file on disk, as indicated by the |
|
|
102 |
''grabDesktopImages'', ''grabVideoFrames'', and |
|
|
103 |
''chooseRandomImages'' options in the |
5 |
perry |
104 |
''~/.xscreensaver'' file; see xscreensaver-demo(1) |
1 |
perry |
105 |
for more details. |
|
|
106 |
|
|
|
107 |
|
|
|
108 |
__-delay__ ''microseconds'' |
|
|
109 |
|
|
|
110 |
|
|
|
111 |
How long to delay between steps of the rotation process, in |
|
|
112 |
microseconds. Default is 500000, one-half |
|
|
113 |
second. |
|
|
114 |
|
|
|
115 |
|
|
|
116 |
__-delay2__ ''microseconds'' |
|
|
117 |
|
|
|
118 |
|
|
|
119 |
How long to delay between each 90-degree rotation, in |
|
|
120 |
microseconds. Default is 500000, one-half second. |
|
|
121 |
__DISPLAY__ to get the default host and display |
|
|
122 |
number. |
|
|
123 |
!!ENVIRONMENT |
|
|
124 |
|
|
|
125 |
|
|
|
126 |
__XENVIRONMENT__ to get the name of a resource file that |
|
|
127 |
overrides the global resources stored in the |
|
|
128 |
RESOURCE_MANAGER property. |
|
|
129 |
!!SEE ALSO |
|
|
130 |
|
|
|
131 |
|
5 |
perry |
132 |
X(1), xscreensaver(1), |
|
|
133 |
xscreensaver-demo(1), |
|
|
134 |
xscreensaver-getimage(1) |
1 |
perry |
135 |
!!COPYRIGHT |
|
|
136 |
|
|
|
137 |
|
|
|
138 |
Copyright 1992, 1993, 1997, 2001 by Jamie Zawinski. |
|
|
139 |
Permission to use, copy, modify, distribute, and sell this |
|
|
140 |
software and its documentation for any purpose is hereby |
|
|
141 |
granted without fee, provided that the above copyright |
|
|
142 |
notice appear in all copies and that both that copyright |
|
|
143 |
notice and this permission notice appear in supporting |
|
|
144 |
documentation. No representations are made about the |
|
|
145 |
suitability of this software for any purpose. It is provided |
|
|
146 |
!!AUTHOR |
|
|
147 |
|
|
|
148 |
|
|
|
149 |
Jamie Zawinski |
|
|
150 |
|
|
|
151 |
|
4 |
perry |
152 |
Based on !SmallTalk code which appeared in the August 1981 |
1 |
perry |
153 |
issue of Byte magazine. |
|
|
154 |
---- |