home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma68.dms / ma68.adf / PIP / PIP.doc < prev    next >
Text File  |  1996-07-08  |  8KB  |  175 lines
  1.  
  2.  
  3.                           ___________________________
  4.                          |                           |
  5.                          |           P I P           |
  6.                          |                           |
  7.                          |    (Picture-In-Picture)   |
  8.                          |                           |
  9.                          |        Version 2.9        |
  10.                          |                           |
  11.                          |   © 1996 by Paul Shandi   |
  12.                          |___________________________|
  13.  
  14.  
  15.  
  16.  --<  INTRODUCTION  >-------------------------------------------------------
  17.  
  18.  "PIP", or "Picture-In-Picture", is a small program that opens a window on
  19.  the frontmost screen and displays all other Intuition screens within it.
  20.  It does so by shrinking all such screens by 50% and displaying them.  Thus,
  21.  you can quickly get an accurate status of what each screen is doing without
  22.  flipping to it and leaving your current screen.
  23.  
  24.  
  25.  
  26.  --<  STARTING THE PROGRAM  >-----------------------------------------------
  27.  
  28.  There are 4 files associated with the program, and they are:
  29.  
  30.  PIP           -  The main program
  31.  PIP.info      -  The main program's icon
  32.  PIP.doc       -  This documentation
  33.  PIP.doc.info  -  This documentation's icon
  34.  
  35.  Okay then, to start the program, all you have to do is double-click on its
  36.  icon.  If you wish to start the program from a CLI, use this format:
  37.  
  38.  run >nil: pip
  39.  
  40.  This will allow you to close the CLI window after running the program.
  41.  
  42.  The last thing to note is the program ONLY runs on Workbench 2.04 or higher
  43.  Amigas, so Workbench 1.3 users will miss out.  Sorry people, but you really
  44.  should upgrade as soon as you can afford it.
  45.  
  46.  
  47.  
  48.  --<  USING THE PROGRAM  >--------------------------------------------------
  49.  
  50.  Once the program has started, you will notice a window at the top-left of
  51.  the current screen.  It will show one of two things:
  52.  
  53.  (1) Nothing.  This means there are no other Intuition screens currently
  54.      open, and thus PIP can't display anything.  :)
  55.  
  56.  (2) A shrunken screen with its title in PIP's title bar.  This screen was
  57.      the first Intuition screen found by PIP.
  58.  
  59.  To view any other open Intuition screens, just click the radio gadgets down
  60.  the right-hand side of PIP's window.  Think of them as channel selectors on
  61.  a television set.  :)  In fact, think of PIP as a TV set where you flick
  62.  through channels to see what's on.  :)
  63.  
  64.  There are 2 menus for use with PIP, called "Project" and "Redraw".
  65.  
  66.  PROJECT: Here you can re-scan your Amiga for all screens, and this may be
  67.           necessary from time to time because PIP won't know when you've
  68.           closed screens or opened new ones.  You can also jump directly to
  69.           the currently displayed screen by selecting the "Go to" item.
  70.  
  71.  REDRAW: The 3 menu items here let you set the speed of PIP's redraw rate.
  72.          Constant will do it constantly, Delayed will do it slower, and None
  73.          will stop it altogether.
  74.  
  75.  
  76.  
  77.  --<  WHAT HAPPENED SINCE V2.2 OF PIP?  >-----------------------------------
  78.  
  79.  Some of you may have used Version 2.2 of PIP which can be found under
  80.  "util/misc" in Aminet.  Such users might think that this version, 2.9, is
  81.  far inferior in operation to it (others might think it's better).  Let's
  82.  start off by listing the differences:
  83.  
  84.  V2.2                             V2.9
  85.  Shows only 640x256 screens       Shows first 640x256 of any screen
  86.  Shows only 10 screens            Shows up to 14 screens
  87.  Shows 50% or 100% size           Shows only 50% size
  88.  Uses menus to select screens     Uses gadgets to select screens
  89.  Allows different redraw rates    Only 3 different redraw rates
  90.  Allows jumping to next screen    Allows jumping to displayed screen
  91.  Uses ToolTypes to set window     Opens window at top-left only
  92.  Unstable (crashes sometimes)     Stable (won't crash where V2.2 did)
  93.  
  94.  After comparison, which version seems better?  It all depends on personal
  95.  taste.  Why couldn't I incorporate the same features from V2.2 into V2.9,
  96.  such as 100% size and ToolTypes?  Well, because I wasn't happy with PIP.
  97.  
  98.  It was originally designed to be a size-reduced representation of all open
  99.  Intuition screens.  Then I added bells and whistles such as 100% option,
  100.  gave it ToolTypes, allowed different redraw rates and so on.  This made it
  101.  bulky and stupid; the program became too big for my intended uses.
  102.  
  103.  So I took it to a weight-loss centre (read: my program editor) and gave it
  104.  a face-lift and liposuction.  ToolType and 100% support were the first to
  105.  go.  A choice of 3 redraw rates were given instead of the 5 from previous.
  106.  The restriction of 10 target screens was upgraded to 14 due to new gadget
  107.  support (and we lost the chunky "Screens" menu as a result - hooray!).
  108.  
  109.  In the process of these changes, the program also became more stable and
  110.  less prone to crashes.  Screens of 256 colours will now be shown without
  111.  PIP spitting the dummy as in V2.2.  Also, you can now view the first 640
  112.  horizontal and 256 vertical pixels of ANY screen, whereas V2.2 only allowed
  113.  screens of 640x256 or less to be shown.  (You can't view all of screens
  114.  which are >640 or >256, because that would mean re-writing the program to
  115.  re-size its window constantly, which I'm not prepared to do.  One thing
  116.  I've learned from feedback of V2.2 is that everyone has different screen
  117.  sizes due to graphics boards etc, so it's an impossible task to accommodate
  118.  everyone personally).
  119.  
  120.  PIP has always been Freely Distributable.  If you don't like the changes
  121.  from V2.2 to V2.9, then bad luck.  After all, you didn't pay for it.  :)
  122.  
  123.  
  124.  
  125.  --<  KNOWN BUGS AND THE FUTURE  >------------------------------------------
  126.  
  127.  The only known bug is that PIP is designed to use a font of Topaz 8 size.
  128.  Any other font sizes will probably corrupt PIP's window.  Whether or not
  129.  this gets fixed in a future release remains to be seen.
  130.  
  131.  So what is PIP's future?  Do you want to see it continue?  I'm not one to
  132.  say never, which is why this release is V2.9, meaning that the definitive
  133.  and final version of 3.0 could well see the light of day.  But is it worth
  134.  it?  Does anyone actually regard PIP worthy of another regeneration?  Let
  135.  me know if you honestly like it and want to see V3.0 come along.
  136.  
  137.  
  138.  
  139.  --<  COPYRIGHT AND DISTRIBUTION  >-----------------------------------------
  140.  
  141.  "PIP" is Freely Distributable.  This means anyone can spread the program
  142.  where they see fit.  You may upload it to BBS's, submit it to PD libraries,
  143.  give it to your friends; whatever.  However, it is NOT a PD product; the
  144.  author retains all copyrights to it, as well as this documentation.
  145.  
  146.  COMMERCIAL NOTE: Although this program can be freely distributed, it may
  147.  NOT be distributed as part of a commercial package under ANY circumstances!
  148.  Doing so will get you issued with a lawsuit, so don't consider it.  If you
  149.  would like to have it as part of a commercial package, contact me first.
  150.  The single and ONLY exception to this commercial-related rule is when the
  151.  program is to be included in a CD-ROM compilation of PD, ShareWare or
  152.  Freely Distributable software, such as the excellent Aminet CD collections.
  153.  
  154.  The program MUST be distributed with the following 4 files, of which NONE
  155.  may be altered or omitted:
  156.  
  157.  PIP           -  The main program
  158.  PIP.info      -  The main program's icon
  159.  PIP.doc       -  This documentation
  160.  PIP.doc.info  -  This documentation's icon
  161.  
  162.  
  163.  
  164.  --<  CONTACTING THE AUTHOR  >----------------------------------------------
  165.  
  166.  You can contact me (Paul Shandi) via E-Mail only:
  167.  
  168.  E-Mail: shandman@fl.net.au
  169.  
  170.  Please do so if you have any comments, bug reports, etc, about the program.
  171.  
  172.  ========================<  END OF DOCUMENTATION  >=========================
  173.  
  174.  
  175.