home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Misc / VirtualWindowManagerV1.1.LHA / aavd.doc < prev    next >
Encoding:
Text File  |  1994-10-09  |  8.8 KB  |  247 lines
  1.  
  2.  
  3.  
  4.                           Almost A Virtual Desktop
  5.                                      by
  6.                               Jimmy Westerlund
  7.  
  8.                                V1.1 1994-10-09
  9.  
  10.  
  11.                                 For V37+ only
  12.  
  13.  
  14.     DISCLAIMER
  15.  
  16.         aavd is freeware. This means that you may do anything you
  17.         like with it as long as you don't try to make money on it.
  18.  
  19.     Description
  20.  
  21.         Have you ever used the olvwm window manager for x-windows. 
  22.         Then you've noticed the Virtual Desktop window, and know 
  23.         what it is used for. If you don't, just run this program 
  24.         and you will soon find out what it does.
  25.  
  26.         aavd will open a window that shows a miniature of the
  27.         default public screen (usually the Workbench) where each "box"
  28.         represents a window. From the aavd window you will be able to:
  29.             o move a window
  30.             o resize a window
  31.             o activate a window
  32.             o depth arrange a window
  33.             o and some more...
  34.  
  35.         I have tried to use the common mouse techines in aavd, this
  36.         means that if you want to activate a window, click on the left
  37.         mouse button, to drag, just drag as you use to do. You can even
  38.         cancel the operation with the right button. See below for a list
  39.         of what you can do, and how to do it.
  40.  
  41.  
  42.  
  43.         o How to activate a window:
  44.             Click the left button.
  45.  
  46.         o How to move a window:
  47.             Press the left button, move the window to it's new position
  48.             and release the button. This opration is canceld if the
  49.             right button is pressed before the left is released.
  50.  
  51.         o How to depth arrange a window:
  52.             Click on the right button.
  53.             The window will be move to the front, unless it's already at
  54.             the front, in which case it will be moved to the back. This is
  55.             not as smooth as clicking on the depth gadget on
  56.             the window, since I've not figured out how to determine if a
  57.             window is covered by another window.
  58.  
  59.         o How to resize a window:
  60.             Press the right button, move the mouse and release the
  61.             button when you're done. The left button can be used to
  62.             cancel this operation. 
  63.  
  64.  
  65.         That's about it. Not very hard to learn...
  66.  
  67.  
  68.  
  69.     And here's the template...
  70.  
  71.         > aavd ?
  72.         PS=PUBSCREEN/K,X=XPOS/K/N,Y=YPOS/K/N,W=WIDTH/K/N,H=HEIGHT/K/N,
  73.         NOFANCY/S,NOSCREENDRAW/S,NOBACKDROP/S,NOAAVDWIN/S,SECS/K/N,
  74.         MICS/K/N,NOSCREENBOX/S,SCREENBOXINFRONT/S,SAFE/S,LOCKPOS/S,
  75.         LOCKSIZE/S,FOLLOW/S:
  76.  
  77.  
  78.         PUBSCREEN           Name of the pubscreen to open Aavd on, default
  79.                             is the default public screen (usually Workbench).
  80.                             When this template is used, then Aavd will never
  81.                             leave this screen. Otherwise Aavd will change
  82.                             screen when you do.
  83.         XPOS                X position top open the Aavd window on. -1 means
  84.                             the first visible xpos.
  85.         YPOS                Y position. -1 means the first visible ypos.
  86.         WIDTH               The width of the Aavd window. 
  87.         HEIGHT              The height.
  88.         NOFANCY             The "windows" are not drawn with a (fancy) 3d
  89.                             look.
  90.         NOSCREENDRAW        When you drag or resize a window, then no box
  91.                             will appear around the real window, but only
  92.                             in the Aavd window.
  93.         NOBACKDROP          Ignore all backdrop window. Usually the
  94.                             Workbench window is backdrop.
  95.         NOAAVDWIN           Ignore the Aavd window in the Aavd Window.
  96.         SECS
  97.         MICS
  98.         NOSCREENBOX         Don't draw the box that tells you where the
  99.                             visible part of the screen is.
  100.         SCREENBOXINFRONT    Draw the screenbox in front of the window
  101.                             boxes, instead of below.
  102.         SAFE                This means that you cannot move a window who
  103.                             got no dragbar or resize a window without a
  104.                             sizegadget, or deapth arrange a window without
  105.                             a depth gadget. Unfortnelly, this doesn't work
  106.                             yet.
  107.         LOCKPOS             This locks the position of the Aavd window.
  108.                             With other words, you can't move it.
  109.         LOCKSIZE            This prevents you from resizeing the Aavd window.
  110.         FOLLOW              This tells the Aavd window to follow the
  111.                             visible screen when you scroll it.
  112.  
  113.  
  114.  
  115.  
  116.     Some technical info.
  117.  
  118.         aavd patches some of the rom routines to find out when a window
  119.         is moved, resized, depth arranenged, opened, closed and so on.
  120.         The patch is very simple, first it calls the original routine,
  121.         and when that returnes the patch will signal the aavd task and
  122.         then the aavd window will be updated.
  123.  
  124.         Here's a list of the routines that will be patched:
  125.  
  126.             from intuition.library:
  127.  
  128.                 OpenWindow()
  129.                 OpenWindowTagList()
  130.                 CloseWindow()
  131.  
  132.             from layers.library
  133.  
  134.                 MoveSizeLayer()
  135.                 BehindLayer()
  136.                 UpfrontLayer()
  137.  
  138.         Because of these patches, it may be possible that aavd doesn't
  139.         works to well with other programs that patches these routines.
  140.  
  141.         You can only run one Aavd at a time. This because of the
  142.         patches. If you for example should start two Aavd's at the same 
  143.         time (A and B), then Aavd A will get pointers to the original
  144.         routines, and Aavd B will get the pointers to Aavd A's routines.
  145.         It will problaby work without problem so far. The problem is that
  146.         if you should quit Aavd A before Aavd B the following will happen:
  147.  
  148.             when Aavd A quits, it will restore the original routine
  149.             pointers. This means that Aavd B will no longer receive
  150.             signals when windows are moved, opend, resized and so on.
  151.  
  152.             and when you then quits Aavd B, it will restore the pointers
  153.             to how it looked when it was started (to Aavd A's routines).
  154.             Aavd A's routines will now be deallocated by the system, and
  155.             the next time the system calls one of these patched routines
  156.             you will get a GURU!!!
  157.  
  158.  
  159.         These are the actions that are checked every 125000 microsecond.
  160.  
  161.             o If the user has activated another screen, then if that
  162.               screen is either public or the workbench we will
  163.               move the Aavd's window to that screen. This will not
  164.               happend if you used the PUBSCREEN template.
  165.  
  166.             o If the screen has been scrolled, the we will redraw the
  167.               aavd window. If the FOLLOW template is used, then we also
  168.               will move the Aacd window.
  169.  
  170.             o If the user has activated another window, then redraw the
  171.               Aavd window.
  172.  
  173.         I have not been able to find out a better way to check these
  174.         actions.
  175.  
  176.     Some bugs.
  177.  
  178.         The resize ruotine will be rewritten so that resizing will go
  179.         smoother.
  180.  
  181.         The SAFE template doesn't work yet.
  182.  
  183.     Examples
  184.  
  185.         o The simplest way to start Aavd...
  186.  
  187.             > Aavd
  188.  
  189.         o To open Aavd on a specific position with a specific size...
  190.  
  191.             > Aavd XPOS = 50 YPOS = 30 WIDTH = 150 HEIGHT = 75
  192.  
  193.             Open Aavd on position (50,30) width the width 150 and
  194.             the height 75.
  195.  
  196.         o To open Aavd on the first Directory Open screen...
  197.  
  198.             > Aavd PUBSCREEN = DOPUS.1
  199.  
  200.             DOPUS.1 is the name of the first DirOpus screen.
  201.  
  202.         o To open Aavd in the topleft corner of the visible part of
  203.           the screen, making it imposiible to move it around and
  204.           make it follow the screen when it is scrolled...
  205.  
  206.             > Aavd XPOS = -1 YPOS = -1 LOCKPOS FOLLOW
  207.  
  208.  
  209.  
  210.     My address
  211.  
  212.         I, who wrote this, can be reached at the following address:
  213.  
  214.             Jimmy Westerlund
  215.             Ringvägen 15
  216.             890 42  Mellansel
  217.               SWEDEN
  218.               
  219.             INTERNET: ing9435@to.mh.se              
  220.  
  221.         Here you can send bugreports, tips, hints, suggestions, and so
  222.         on...
  223.  
  224.  
  225.  
  226.     Future
  227.  
  228.         Well, I don't really know.
  229.         First I guess I'll try to remove the bugs I know, clean up
  230.         the source, rewrite this doc and so on.
  231.  
  232.  
  233.     History
  234.  
  235.         V1.1 1994-10-09
  236.  
  237.             Fixed small bug when using the NOFANCY option. The color of
  238.             the active window is now white, and not, as before, grey.
  239.  
  240.             Slightly modified the patch routines. Now Aavd will never
  241.             redraw the window if an action fails, for example, someone
  242.             tried to open a window, but failed for some reson.
  243.  
  244.  
  245.         V1.0 1994-06-26
  246.  
  247.             First version released.