home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / blit55us.zip / DISK.ZIP / SSOK.DOC < prev    next >
Text File  |  1995-11-27  |  19KB  |  478 lines
  1. ╔═══════════════════╗
  2. ║README for SSOK.ZIP║
  3. ╚═══════════════════╝
  4.  
  5.  10-Mar-95
  6.  
  7. ┌────────┐
  8. │Contents│
  9. └────────┘
  10.  
  11.  File List
  12.  Revision History
  13.  General Remarks
  14.  Installation
  15.  The Modules
  16.    EXTERNAL.SSM
  17.    STICKS.SSM
  18.    TV.SSM
  19.    HOPOK.SSM
  20.    RAUPE.SSM
  21.  Disclaimer
  22.  Distribution
  23.  Support
  24.  Credits
  25.  Copyrights
  26.  
  27. ┌─────────┐
  28. │File List│
  29. └─────────┘
  30.  
  31.  SSOK.ZIP vs. 1.3a contains - EXTERNAL.SSM (the 'EXTERNAL' module)
  32.                               STICKS  .SSM (the 'Sticks' module)
  33.                               TV      .SSM (the 'TV' module)
  34.                               HOPOK   .SSM (the 'Hop-Pointer' module)
  35.                               RAUPE   .SSM (the 'raupe' module)
  36.  
  37.                               SSOK    .DOC (this file)
  38.  
  39. ┌────────────────┐
  40. │Revision History│
  41. └────────────────┘
  42.  
  43.  1.0  *** 06-Aug-94 *** Initial version of SSOK.ZIP
  44.  
  45.  1.1  *** 16-Aug-94 *** Two modules added: TV.SSM, HOPOK.SSM
  46.                         Improved SSOK.DOC
  47.  
  48.  1.2  *** 03-Sep-94 *** One new module: RAUPE.SSM, utilizing a poem
  49.                          by Ernst Jandl
  50.                         Changed SSOK.DOC
  51.  
  52.  1.3  *** 21-Sep-94 *** Bug fixed: Some module configuration screens didn't fit
  53.                                    into a standard VGA desktop
  54.  
  55.  1.3a *** 10-Mar-95 *** New compile with EMX, eliminating use of SSOKDLL.DLL
  56.                         Minor code changes
  57.                         (Thanks to Siegfried Hanisch for 'EMXing' SSOK!)
  58.                         Changed SSOK.DOC
  59.  
  60. ┌───────────────┐
  61. │General Remarks│
  62. └───────────────┘
  63.  
  64.  A. ScreenSaver
  65.  ──────────────
  66.  
  67.  SSOK.ZIP contains modules for "ScreenSaver", a shareware screen saver written
  68.  by Siegfried Hanisch. You can get "ScreenSaver" from:
  69.  
  70.   ftp://ftp.cdrom.com/pub/os2/2_x/graphics
  71.   ftp://hobbes.nmsu.edu/pub/os2/32bit/graphics
  72.  
  73.  Check also the appropriate incoming directories for new versions. "Screen-
  74.  Saver" is usually obtainable from CIS, OS2USER.
  75.  
  76.  Siegfried Hanisch's e-mail internet addresses are:
  77.  
  78.   siggih@ibm.net
  79.   ssaver@ibm.net
  80.   hanisch@ci.tuwien.ac.at
  81.  
  82.  His mail address is
  83.  
  84.   Dipl.-Ing. Siegfried Hanisch
  85.   Einsiedlergasse 6/16
  86.   A-1050 Vienna
  87.   Austria
  88.   Tel: +43-1-5520514
  89.  
  90.  
  91.  B. Blanker
  92.  ──────────
  93.  
  94.  Another Austria based author, Peter Wansch, offers another screensaver,
  95.  called "Blanker". "Blanker" is capable of utilizing "ScreenSaver" modules.
  96.  You can get "Blanker" from:
  97.  
  98.   ftp://hobbes.nmsu.edu/pub/os2/32bit/graphics
  99.  
  100.  and usually from CIS, OS2USER or OS2BVEN.
  101.  
  102.  Peter Wansch's e-mail internet address is:
  103.  
  104.   p.wansch@ieee.org
  105.  
  106.  His mail address is
  107.  
  108.   Dipl.-Ing. Peter Wansch
  109.   Hagenbachgasse 37
  110.   A-3423 St. Andrä-Wördern
  111.   Austria
  112.   Tel: +43-2242-32124
  113.   Fax: +43-2242-31113
  114.  
  115.  
  116.  C. ScreenSaver/Blanker & SSOK
  117.  ─────────────────────────────
  118.  
  119.  From March 1995 all five mnodules of SSOK are bundled with both screensavers.
  120.  The included modules are distributed free of charge.
  121.  
  122.  
  123. ┌────────────┐
  124. │Installation│
  125. └────────────┘
  126.  
  127.  You can substitute most references to "ScreenSaver" with "Blanker" if that is
  128.  your saver.
  129.  
  130.  - IF THE MODULES DIDN'T COME WITH YOUR FAVOURITE SCREENSAVER:
  131.    Unzip the SSOK.ZIP package into the SSAVER directory. Be sure to overwrite
  132.    files if you already have a previous version of SSOK.ZIP.
  133.  
  134.  - Start ScreenSaver, mark any of my modules in the right listbox,
  135.    and click once on "Configure module" to see and change the individual
  136.    settings. Please refer to the module specific explanation below.
  137.  
  138.  - You'll find a special profile file, SSAVEROK.INI, in the "ScreenSaver"
  139.    directory. I use it instead of OS2.INI to store the parameters for all
  140.    my modules.
  141.  
  142. ┌───────────┐
  143. │The Modules│
  144. └───────────┘
  145.  
  146.  EXTERNAL.SSM
  147.  ────────────
  148.  
  149.  A. Purpose and Configuration
  150.  
  151.     EXTERNAL.SSM is aimed at those people who want to start external programs
  152.     as screen saver modules. Imagine you have a DOS- or OS/2-fullscreen
  153.     graphics program which you would like to use as a blanker.
  154.  
  155.     Use "Configure module" to fill in
  156.       - the full path of the program you want to use as external module
  157.       - any useful parameters your program might expect
  158.       - and click on the appropriate box to mark the program as a DOS or
  159.         VIO-OS/2 or WIN-OS/2 or PM application.
  160.  
  161.  
  162.  B. Special considerations
  163.  
  164.     Be sure to run ScreenSaver always with "mouse sensing" enabled. EXTERNAL
  165.     is a somewhat dirty module that posts a mouse movement before shelling out
  166.     to the external program so that ScreenSaver minimizes itself upon exiting
  167.     the external program. Please keep in memory that there was no such thing
  168.     planned by the author of ScreenSaver and so he couldn't provide any means 
  169.     of communication between the external program and the ScreenSaver itself.
  170.     The communication between the module and ScreenSaver itself wasn't
  171.     designed for that purpose either.
  172.  
  173.     You will encounter the following phenomenon: After testing the external
  174.     module, that is: after exiting the called external program in testing 
  175.     mode, ScreenSaver will minimize itself as if the EXTERNAL module and the
  176.     external program would have been invoked by ScreenSaver during normal
  177.     operation after the usual timeout.
  178.  
  179.  
  180.  C. Revision History EXTERNAL.SSM
  181.  
  182.     1.0  *** 04-Aug-94 *** initial release
  183.  
  184.  
  185.  STICKS.SSM
  186.  ──────────
  187.  
  188.  A. Purpose and Configuration
  189.  
  190.     STICKS.SSM is just another screen saver module. It eats up your screen 
  191.     from behind. You can play with the self-explanatory parameters by using
  192.     the "Configure module" dialog. The different shapes of the sticks
  193.     "black hole" are quite interesting (IMHO <g>).
  194.  
  195.  B. Revision History STICKS.SSM
  196.  
  197.     1.0  *** 06-Aug-94 *** initial release
  198.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  199.  
  200.  
  201.  TV.SSM
  202.  ──────
  203.  
  204.  A. Purpose and Configuration
  205.  
  206.     TV.SSM is just another screen saver module. It draws black and white
  207.     circles on the screen. Just take it as a somewhat primitive imitation of
  208.     the TV snow you can see when your box gets no signal. There are no
  209.     parameters you can play with.
  210.  
  211.  B. Revision History TV.SSM
  212.  
  213.     1.0  *** 11-Aug-94 *** initial release
  214.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  215.  
  216.  
  217.  HOPOK.SSM
  218.  ─────────
  219.  
  220.  A. Purpose and Configuration
  221.  
  222.     HOPOK.SSM is NOT just another screen saver module. It's called
  223.     "Hop-Pointer", because it should make you aware of "HOP", a fractal image
  224.     generator utilizing the so-called "Hopalong" algorithms. HOP is written by
  225.     Michael Peters and located on CompuServe, forum GRAPHDEV, lib 4,
  226.     'Fractal Sources' (HOPZIP.EXE), and on the Internet. Please check HOP if
  227.     you're interested in fractal images. HOP itself includes a screensaver
  228.     for DOS and Windows and you can use it as OS/2 screensaver along with my
  229.     EXTERNAL module.
  230.  
  231.     HOP contains way more features than this very small module.
  232.  
  233.     Here is a quote from Michael's documentation to give us an impression what
  234.     HOP is:
  235.  
  236.     "
  237.  
  238.    ┌────────────────────────────────────────────────────────────────────────┐
  239.    │ WHAT DOES "HOP" MEAN ANYWAY ?                                          │
  240.    └────────────────────────────────────────────────────────────────────────┘
  241.  
  242.      Barry Martin from Aston University (Birmingham/England) discovered a
  243.      new fractal in the mid-80's. A. K. Dewdney presented Martin's first
  244.      images and the algorithm in his 'Computer Recreations' column in
  245.      Scientific American (Sept.1986). He called the new fractal HOPALONG,
  246.      referring to the unique way it grows on the screen. Unlike the famous
  247.      Mandelbrot fractals, here the pixels 'hop from one point to another'.
  248.      The fractal doesn't grow line by line, but rather emerges from the
  249.      whole of the screen.
  250.  
  251.      The character of the resulting images is quite different from what most
  252.      people associate with 'fractals'. Many Hopalongs have some mysterious
  253.      similarity to some biological forms such as diatoms, radiolarians, or
  254.      other unicellular microorganisms. (I strongly recommend to take a look
  255.      at Ernst Haeckel's famous 'Art Forms in Nature' drawings.) If you find
  256.      that the complexity and symmetry of such things fascinates you, you
  257.      will also like HOP's creations. Maybe they will even make you wonder
  258.      what the real connection is between nature, fractals, mind, and beauty.
  259.  
  260.      Hopalong fractals lack the deep complexity of the M-Set - it isn't
  261.      possible to infinitely zoom into the images without losing some of
  262.      their complexity. On the other hand, the way they are created is far
  263.      more interesting to watch in real-time than the (usually boring)
  264.      line-by-line growth of Mandelbrot fractals which results in utterly
  265.      amazing, but static images (unless your computer is extremely fast).
  266.  
  267.      Appendix C contains a short Pascal program which shows how the
  268.      Hopalong algorithm works.
  269.  
  270.                              ────────────────────────
  271.  
  272.      HOP is based on HOPALONG algorithms, but it introduces a lot of new
  273.      and unusual features:
  274.  
  275.      Martin's formula is accompanied by more than two dozen newly developed
  276.      formulas, all similar in structure, but different in detail. The result
  277.      is a wide variety of new fractals.
  278.  
  279.      Several new mathematical 'special effects' modify the shapes of the
  280.      'pure' fractals and introduce movement and 'Fractals in Motion'.
  281.  
  282.      A wide variety of graphic effects is available to manipulate the
  283.      images. Some of these effects are standard (VGA color scrolling is
  284.      done by most graphic programs), but many others are unique and were
  285.      designed for HOP.
  286.  
  287.    ┌────────────────────────────────────────────────────────────────────────┐
  288.    │ THE BASIC CONCEPT                                                      │
  289.    └────────────────────────────────────────────────────────────────────────┘
  290.  
  291.      HOP runs like an slideshow. While some of the images in the show are
  292.      more or less static, others contain wild or gentle movements and
  293.      animations, depending on dozens of interacting parameters all of which
  294.      you can control. Each of the slides runs endlessly or for a
  295.      predetermined number of pixels. The slides are either 'composed',
  296.      stored in a file, and can be exactly reproduced, or they are designed
  297.      on-the-fly (improvised) by HOP's random algorithms or by you, or both.
  298.  
  299.      When you run the demo, HOP plays back a parameter file containing a
  300.      series of 'composed' images and animations. (If you like HOP and learn
  301.      how to use it, you will very soon also come up with interesting
  302.      'compositions' which you can exchange with other HOP users or run
  303.      with the screensaver.)
  304.  
  305.      If HOP doesn't playback a file, it runs in an 'improvising' mode. Each
  306.      of the images will run for a certain number of pixels, then a new image
  307.      will come up, and so on. You have full control over all parameters, but
  308.      unless you want to explore a specific image, you don't have to enter
  309.      any numbers - everything will happen by itself! (Actually I started
  310.      writing HOP because I'm so lazy.)
  311.  
  312.      While some of the images might blow your mind, others might be boring.
  313.      The program juggles many variables, producing images that are based on
  314.      controlled randomness - unfortunately, the program can't watch the images
  315.      and decide if they are beautiful or not. The algorithms are blind.
  316.      (Maybe this will be different in a future version of HOP). It is as if
  317.      you took a snapshot of a random area of the Mandelbrot set - the chance
  318.      to get a boring image is quite high even if the M-set contains loads of
  319.      incredible sights.
  320.  
  321.      You have control over the decisions the program makes to some extent
  322.      though - this happens on the 'Tune' page of the user interface.
  323.  
  324.      Take the randomly generated images as suggestions. Throw them away, or
  325.      modify a nice image until you really like it. Then store it in your
  326.      'favorites' collection, and please exchange it with others.
  327.  
  328.      When you play with HOP's suggestions and learn to master all the
  329.      different parameters, you will find that there are a number of effects
  330.      that are almost never used in HOP's improvisations. They have to be
  331.      used like the special effects in a movie or in rock music: Overusing
  332.      them won't do any good, but using them thoughtfully can add spice and
  333.      interesting variations. Also, some of the effects slow down performance
  334.      or could easily make a boring picture if applied by a blind random
  335.      algorithm.
  336.  
  337.      Another thing you should be aware of is that when running in random
  338.      mode, HOP will try to automatically center and size the fractals. The
  339.      reason this is done is that without this automatic optimization (just
  340.      taking the naked random numbers and formulas and generating the images
  341.      as they come), many fractal images would be too small, or you would be
  342.      shown less interesting details, or the screen would be mostly blank
  343.      because the fractal would develop right outside of it.
  344.  
  345.      The positive effect of this optimizing is that most images will be more
  346.      or less interesting. You can sit and watch HOP design a neverending
  347.      series of fractals, like the shells you find whilst walking along an
  348.      ocean beach. But this is only one way of looking at them! Anyone
  349.      interested in shells would stop from time to time and pick one up to
  350.      look at its microstructure which - as we have learned from fractal
  351.      theory - is just as complex as the view from above. HOP cannot do this
  352.      for you automatically. It doesn't know where interesting details are
  353.      located. The incredible microstructure of HOP fractals has to be
  354.      studied manually. Try zooming in to interesting details and playing
  355.      with the many program features and parameters to manipulate your view.
  356.      HOP will reward you with an infinite world of complexity and beauty.
  357.  
  358.      "
  359.  
  360.     There are several settings you can play with, manipulating the size and
  361.     shape of the drawn pels, the size and shape of the fractal image and so
  362.     on. They are easy to understand by learning-by-doing.
  363.  
  364.  B. Revision History HOPOK.SSM
  365.  
  366.     1.0  *** 16-Aug-94 *** initial release
  367.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  368.  
  369.  
  370.  RAUPE.SSM
  371.  ─────────
  372.  
  373.  A. Purpose and Configuration
  374.  
  375.     RAUPE.SSM is a very special screen saver module. The German word 'raupe'
  376.     ('caterpillar') moves across the screen and blanks it subsequently.
  377.  
  378.     Be aware that "raupe" is a poem by the famous Austrian writer Ernst
  379.     Jandl. Please check the copyright section of this file below!
  380.  
  381.  B. Revision History RAUPE.SSM
  382.  
  383.     1.0  *** 03-Sep-94 *** initial release
  384.     1.1  *** 21-Sep-94 *** module configuration screen fixed for VGA desktops
  385.  
  386. ┌──────────┐
  387. │Disclaimer│
  388. └──────────┘
  389.  
  390.  The authors assume no responsibility for any damage or loss caused by
  391.  the use of this program. THIS PROGRAM IS PROVIDED AS IS WITHOUT ANY
  392.  WARRANTY, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO FITNESS
  393.  FOR A PARTICULAR PURPOSE.
  394.  
  395. ┌────────────┐
  396. │Distribution│
  397. └────────────┘
  398.  
  399.  As the sole copyright holders of these modules, Olaf Koch and Michael Peters,
  400.  reserve all rights to the program. However, this freeware version may be
  401.  freely distributed by commercial vendors, user groups, BBS operators,
  402.  or individuals, with the following restrictions:
  403.  
  404.  - SSOK.ZIP must be distributed in unmodified form in its entirety,
  405.    including all files that are listed in the 'File List' chapter of this
  406.    documentation. No other programs or files may be included. The
  407.    files may be distributed in a compressed or library format.
  408.  
  409.  - SSOK.ZIP may not be included in combination with any other software
  410.    or hardware product as an enticement or for any other reason,
  411.    without special permission from the authors.
  412.  
  413.    [Permission granted to Siegfried Hanisch (ScreenSaver), Peter Wansch
  414.    (Blanker).]
  415.  
  416.  - No fee or payment may be charged or accepted for SSOK.ZIP, other than
  417.    a small disk distribution fee. This is especially true for the module
  418.    RAUPE.SSM which is based on a copyrighted poem. It is a contractual
  419.    obligation to publish the poem 'raupe' without charging.
  420.  
  421.  - SSOK.ZIP cannot be rented or leased.
  422.  
  423.  - SSOK.ZIP may not be packaged or distributed with any of its supporting
  424.    documentation pre-printed for the end-user.
  425.  
  426. ┌───────┐
  427. │Support│
  428. └───────┘
  429.  
  430.  If you have any suggestions or questions please drop me a mail:
  431.  
  432.     100010.2732@compuserve.com
  433.     olafk@ibm.net
  434.  
  435.  Anyway, I provide the ScreenSaver modules "as is" and just for fun, so 
  436.  there's no "guaranteed support". I'll answer mail and may look into bugs.
  437.  But that it is.
  438.  
  439. ┌───────┐
  440. │Credits│
  441. └───────┘
  442.  
  443.  Siegfried Hanisch           - for giving us "ScreenSaver", "porting" my
  444.                                modules to EMX, and distributing them.
  445.  Michael Peters              - for giving us "Hop".
  446.  Luchterhand Literaturverlag - for allowing me to use Ernst Jandl's poem
  447.                                'raupe'. (At least it's not quite usual that
  448.                                publishers allow someone to place commercial
  449.                                and copyrighted material in the net!)
  450.  Peter Wansch                - for distributing my modules.
  451.  
  452. ┌──────────┐
  453. │Copyrights│
  454. └──────────┘
  455.  
  456.  All modules except HOPOK.SSM are Copyright (C) by Olaf Koch. All rights
  457.  reserved.
  458.  
  459.  *
  460.  
  461.  HOPOK.SSM is Copyright (C) by Michael Peters and Olaf Koch. All rights
  462.  reserved.
  463.  
  464.  *
  465.  
  466.  The poem 'raupe' on which the module RAUPE.SSM is based is Copyright (C)
  467.  1985, 1990 by Luchterhand Literaturverlag. All rights reserved.
  468.  
  469.  Quelle: Ernst Jandl "raupe" aus: ders. "der künstliche baum" in: "Gesammelte
  470.          Werke in 3 Bänden" Bd. 1 (hrsg. von Klaus Siblewski)
  471.  Source: Ernst Jandl "raupe" ('caterpillar') from: the same
  472.          "der kuenstliche baum" ('the artficial tree') in:
  473.          "Gesammelte Werke in 3 Bänden" ('Complete Works') Bd. 1
  474.          (hrsg. von/edited by Klaus Siblewski)
  475.  
  476.  RAUPE.SSM as a software module it still copyrighted by Olaf Koch.
  477.  
  478.