git.hungrycats.org Git - xscreensaver/blob - local/man/cat.1/blitspin.1

   1
   2
   3
   4 XScreenSaver(1)                                   XScreenSaver(1)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        blitspin - rotate a bitmap in an interesting way
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        b\bbl\bli\bit\bts\bsp\bpi\bin\bn   [-display   _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn]   [-foreground
  12        _\bc_\bo_\bl_\bo_\br]  [-background  _\bc_\bo_\bl_\bo_\br]  [-window]  [-root]   [-mono]
  13        [-install]  [-visual  _\bv_\bi_\bs_\bu_\ba_\bl]  [-bitmap  _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be] [-delay
  14        _\bu_\bs_\be_\bc_\bs] [-delay2 _\bu_\bs_\be_\bc_\bs]
  15
  16 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  17        The _\bb_\bl_\bi_\bt_\bs_\bp_\bi_\bn program repeatedly rotates  a  bitmap  by  90
  18        degrees by using logical operations: the bitmap is divided
  19        into quadrants, and the quadrants are  shifted  clockwise.
  20        Then  the  same  thing  is  done  again with progressively
  21        smaller quadrants, except  that  all  sub-quadrants  of  a
  22        given  size  are  rotated  in  parallel.   So  this  takes
  23        O\bO(\b(1\b16\b6*\b*l\blo\bog\bg2\b2(\b(N\bN)\b))\b) blits of size NxN, with the limitation  that
  24        the  image must be square, and the size must be a power of
  25        2.
  26
  27 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  28        _\bb_\bl_\bi_\bt_\bs_\bp_\bi_\bn accepts the following options:
  29
  30        -\b-w\bwi\bin\bnd\bdo\bow\bw Draw on  a  newly-created  window.   This  is  the
  31                default.
  32
  33        -\b-r\bro\boo\bot\bt   Draw on the root window.
  34
  35        -\b-m\bmo\bon\bno\bo   If   on  a  color  display,  pretend  we're  on  a
  36                monochrome display.
  37
  38        -\b-i\bin\bns\bst\bta\bal\bll\bl
  39                Install a private colormap for the window.
  40
  41        -\b-v\bvi\bis\bsu\bua\bal\bl _\bv_\bi_\bs_\bu_\ba_\bl
  42                Specify which visual to use.  Legal values are the
  43                name  of a visual class, or the id number (decimal
  44                or hex) of a specific visual.
  45
  46        -\b-b\bbi\bit\btm\bma\bap\bp _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
  47                The file name of a bitmap to rotate.  It need  not
  48                be  square:  it will be padded with the background
  49                color.  If unspecified or the string _\b(_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b),  a
  50                builtin bitmap is used.
  51
  52                If support for the _\bX_\bP_\bM library was enabled at com-
  53                pile-time, the specified file may be in _\bX_\bP_\bM format
  54                as well as _\bX_\bB_\bM, and thus may be a color image.
  55
  56                The  *\b*b\bbi\bit\btm\bma\bap\bpF\bFi\bil\ble\beP\bPa\bat\bth\bh  resource will be searched if
  57                the bitmap name is not a fully-qualified pathname.
  58
  59        -\b-g\bgr\bra\bab\bb-\b-s\bsc\bcr\bre\bee\ben\bn
  60                If  this option is specified, then the image which
  61
  62
  63
  64 X Version 11                24-Nov-97                           1
  65
  66
  67
  68
  69
  70 XScreenSaver(1)                                   XScreenSaver(1)
  71
  72
  73                is spun will be grabbed from the  portion  of  the
  74                screen  underlying  the  blitspin window.  (Or, it
  75                may  come  from  an  external  video  source:  see
  76                below.)
  77
  78
  79        -\b-d\bde\bel\bla\bay\by _\bm_\bi_\bc_\br_\bo_\bs_\be_\bc_\bo_\bn_\bd_\bs
  80                How  long  to  delay between steps of the rotation
  81                process, in microseconds.  Default is 500000, one-
  82                half second.
  83
  84
  85        -\b-d\bde\bel\bla\bay\by2\b2 _\bm_\bi_\bc_\br_\bo_\bs_\be_\bc_\bo_\bn_\bd_\bs
  86                How long to delay between each 90-degree rotation,
  87                in microseconds.  Default is 500000, one-half sec-
  88                ond.   D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display
  89                number.
  90
  91 R\bRE\bES\bSO\bOU\bUR\bRC\bCE\bES\bS
  92        On some systems (currently, only SGIs), this program  can,
  93        instead of grabbing a desktop image, grab a frame of video
  94        from an external camera and manipulate that instead.   The
  95        following resources control that.
  96
  97
  98        g\bgr\bra\bab\bbV\bVi\bid\bde\beo\boP\bPr\bro\bob\bba\bab\bbi\bil\bli\bit\bty\by (Float)
  99                What portion of the time to grab video rather than
 100                a screen image, between 0.0 and 1.0.  Defaults  to
 101                0.5, or half the time.
 102
 103        v\bvi\bid\bde\beo\boD\bDe\bev\bvi\bic\bce\be (Integer)
 104                The  number  of  the default video input device to
 105                check first.  If unspecified, the  default  camera
 106                (from videopanel(1)) will be checked first.  After
 107                that, all other available video input devices will
 108                be checked in order.
 109
 110                The  first  one  which  produces a non-black image
 111                will be used.  If all images are black, the others
 112                will  be  re-checked  a few times before giving up
 113                and falling back  to  simply  grabbing  a  desktop
 114                image  (but note that this takes a few seconds, so
 115                if you  don't  actually  have  any  video  sources
 116                hooked  up,  you should consider turning off video
 117                grabbing by setting g\bgr\bra\bab\bbV\bVi\bid\bde\beo\boP\bPr\bro\bob\bba\bab\bbi\bil\bli\bit\bty\by to  0.0.)
 118
 119        v\bvi\bid\bde\beo\boG\bGa\bai\bin\bn (Float)
 120                The amount by which to brighten the grabbed image.
 121                This defaults to 2.2.
 122
 123 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
 124        X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT to get the name of a resource file that over-
 125        rides  the global resources stored in the RESOURCE_MANAGER
 126        property.
 127
 128
 129
 130 X Version 11                24-Nov-97                           2
 131
 132
 133
 134
 135
 136 XScreenSaver(1)                                   XScreenSaver(1)
 137
 138
 139 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 140        X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1)
 141
 142 C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
 143        Copyright (C) 1992, 1993, 1997 by Jamie Zawinski.  Permis-
 144        sion to use, copy, modify, distribute, and sell this soft-
 145        ware and its  documentation  for  any  purpose  is  hereby
 146        granted  without  fee,  provided  that the above copyright
 147        notice appear in all copies and that both  that  copyright
 148        notice  and  this  permission  notice appear in supporting
 149        documentation.  No  representations  are  made  about  the
 150        suitability  of this software for any purpose.  It is pro-
 151        vided "as is" without express or implied warranty.
 152
 153 A\bAU\bUT\bTH\bHO\bOR\bR
 154        Jamie Zawinski <jwz@jwz.org>, 17-aug-92.
 155
 156        Based on SmallTalk code which appeared in the August  1981
 157        issue of Byte magazine.
 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 X Version 11                24-Nov-97                           3
 197
 198