Penguin
Annotated edit history of blitspin(1) version 5, including all changes. View license author blame.
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 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.