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