home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff216.lzh / BackDrop / backdrop.doc < prev    next >
Text File  |  1989-06-02  |  4KB  |  133 lines
  1.  
  2.      BACKDROP(1)           AMIGA Programmer's Manual            BACKDROP(1)
  3.  
  4.  
  5.  
  6.      NAME 
  7.           backdrop - adds a backdrop behind workbench windows 
  8.  
  9.      SYNOPSIS 
  10.           backdrop {-a# | -b# | -f | -p# | -q | -s | b1b2b3b4b5b6b7b8} 
  11.  
  12.      DESCRIPTION 
  13.           Backdrop  allows  you to define a pattern which will then be
  14.           displayed on the workbench screen in the normally empty area
  15.           behind all the windows.  I originally wrote it because I was
  16.           experimenting an overscan interlaced workbench, and I wanted
  17.           to get that 'workstation' look.   The  only  program  I  had
  18.           which  would  give  a  similar  effect was DropCloth by Eric
  19.           Lavitsky,  but  this  requires  Workbench  to   be   loaded.
  20.           Backdrop  will  not  cohabit very well with Workbench, which
  21.           suits me fine since I hardly ever use Workbench.  
  22.  
  23.           The first time you run Backdrop, it detaches itself from the
  24.           CLI and hangs around in memory until you tell  it  to  quit.
  25.           You  can  change  the  current  settings by running Backdrop
  26.           again with  different  options.    Only  those  options  you
  27.           specify   will  be  altered,  all  the  others  will  remain
  28.           unchanged.  
  29.  
  30.           The following options can be specified: 
  31.  
  32.           -a followed by a number sets the foreground colour  used  to
  33.           plot  the pattern to the pen number specified (normally 0 to
  34.           3). Similarly, -b sets the background colour.  
  35.  
  36.           -f and -s select the window type used by Backdrop. -f uses a
  37.           SMART_REFRESH window, which results in fast updating of  the
  38.           screen,  but  can use up to 64K of chip memory (in interlace
  39.           mode).  -s uses a SIMPLE_REFRESH window, which gives  slower
  40.           updating  of  the screen but doesn't use up any chip memory.
  41.           If  you  can  afford  the  memory,  -f   looks   much   more
  42.           professional.  
  43.  
  44.           -p followed by a number selects one of the built in patterns
  45.           for display.   Pattern  0  is  the default pattern.  Numbers
  46.           from 1 upwards select other patterns.  If you try to  select
  47.           a non-existant pattern, you get the default pattern.  
  48.  
  49.           -q  tells any copy of Backdrop already resident in memory to
  50.           remove itself, and restore the screen back to normality.  If
  51.           Backdrop isn't already resident, then  this  option  has  no
  52.           effect.  
  53.  
  54.           Finally,  you can define your own unique pattern by giving a
  55.           list of 16 hex digits.  These are interpreted  as  8  bytes,
  56.           with  each  byte  corresponding  to  one row of an 8x8 grid.
  57.           This grid is then replicated over the entire screen to  form
  58.           the pattern.    Try  experimenting  with  random  values  to
  59.           generate some unique patterns.  
  60.  
  61.           Any or all of these options may be present  on  the  command
  62.           line, and  order is not important.  You can get a summary of
  63.  
  64.  
  65.      Copyright Eddy Carroll 1989      -1-
  66.  
  67.  
  68.      BACKDROP(1)           AMIGA Programmer's Manual            BACKDROP(1)
  69.  
  70.  
  71.           these options by invoking Backdrop with  -h  (or  any  other
  72.           invalid option).  
  73.  
  74.      CAVEATS 
  75.           If you try running this when Workbench is running, Workbench
  76.           will  disappear  (this  could be viewed as a benefit :-) You
  77.           can quite easily recover Workbench by  telling  Backdrop  to
  78.           quit with the -q option.  
  79.  
  80.      DISTRIBUTION 
  81.           Although  I  retain  copyright of Backdrop, it may be freely
  82.           redistributed as long as no charge is  made  other  than  to
  83.           cover distribution costs.  
  84.  
  85.      EXAMPLES 
  86.           Backdrop installs a simple backdrop pattern 
  87.           Backdrop -a0 -b3 -p1 installs a red brick wall pattern 
  88.           Backdrop -a2 cccc666633339999 installs dark stripes pattern 
  89.  
  90.      AUTHOR 
  91.           Eddy Carroll 
  92.           The Old Rectory, 
  93.           Delgany, Co. Wicklow, 
  94.           Ireland.  
  95.  
  96.           EMAIL: ecarroll@cs.tcd.ie 
  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.      Copyright Eddy Carroll 1989      -2-
  132.  
  133.