home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / Raytracing / Misc / makehaze.lha / makeHaze / makeHaze.doc < prev    next >
Encoding:
Text File  |  1995-09-22  |  4.3 KB  |  123 lines
  1. ####################################################################
  2. #                                                                  #
  3. #      makeHaze v0.3 (21 September 1995) - ©1995 by A.Maschke      #
  4. #                                                                  #
  5. ####################################################################
  6.  
  7. CONTENTS
  8.  
  9. 1. Introduction
  10. 2. Requirements
  11. 3. Command-line-options
  12. 4. Examples
  13. 5. Author/Registration
  14. 6. History/TODO
  15.  
  16. 1. Introduction
  17. --------------------------------------------------------------------
  18.  
  19.  This program operates on 24Bit-ILBM-pictures to create a
  20.  haze-like-effect. Imagine3.1+ features such an operator
  21.  called "haze" as global-F/X . This module works fine on single
  22.  images - but it is too slow for animations. So I tried to
  23.  create my own haze-effect. The result is the programm makeHaze.
  24.  It features no antialiasing but has better region-control than
  25.  Imagine's "haze". It's faster, of course.
  26.  
  27.  Summary:
  28.   Advantages:    - speed
  29.                  - good quality for animations
  30.                  - colors can be locked for the effect, this makes
  31.                    it possible to create haze-effects on overlapping
  32.                    objects
  33.                  - all clusters found in the image are processed
  34.                    separately pass by pass (This makes it so slow)
  35.                  - supports image-composing using other software
  36.   Disadvantages: - no antialiasing
  37.  
  38. 2. Requirements
  39. --------------------------------------------------------------------
  40.  -OS3.0+
  41.  -MC68030+ and MC68881+
  42.  -ixemul.library V41+
  43.  -iff.library V23+
  44.  -enough memory and MHz
  45.  
  46. 3. Command-line-options
  47. --------------------------------------------------------------------
  48.  
  49.        Usage: makeHaze <in> <out> <red> <green> <blue> .
  50.      Options: -lines <val>     (3<=val<=100)
  51.               -clearimage
  52.               -intensity <val> (0.0<val<1.0)
  53.               -keep <val> <val rgb-vectors>
  54.               -clearimage
  55.  
  56.  Description: -<red>, <green>, <blue> specify the color which is to search
  57.               -lines specifies the thickness of the haze
  58.                (good values 10..40)
  59.               -<intensity> specifies the base-color of the haze:
  60.                 (<red> <green> <blue>)*<intensity>
  61.                (0.2..0.5 are good values)
  62.               -<clearimage> causes the program to clear the whole image
  63.                before drawing the haze, this makes it possible to
  64.                apply some post-F/X (e.g. blur) to the haze
  65.               -the <keep>-parameter is an very useful feature,
  66.                pixels which have one of the specified colors
  67.                are not changed. This allows to create haze-effects
  68.                on overlapping objects, such as a rotating lightball.
  69.  
  70.      Example: haze pic pic2 255 0 0 -keep 2 0 255 0 0 0 255
  71.               ('Search the color red in picture "pic", create
  72.                picture "pic2", keep all pixels which have one
  73.                of the two colors green or blue')
  74.  
  75. 4. Examples
  76. --------------------------------------------------------------------
  77.  
  78.  a) pic.noHaze   - source-picture containing some "bright" objects
  79.  
  80.  b) pic.Imagine  - result of three haze-passes using Imagine
  81.  
  82.  c) pic.makeHaze - result of three haze-passes using makeHaze
  83.                    (the blue color was locked for the green haze)
  84.  
  85.  Time-comparison (all 3 passes, Imagine without rendering):
  86.   Imagine  : 558s (9mins 18secs)
  87.   makeHaze : 122s (2mins  2secs)
  88.  
  89. 5. Author/Registration
  90. --------------------------------------------------------------------
  91.  The makeHaze-package belongs to the Dust-project, to get
  92.  registered send $25+postage to the author:
  93.  
  94.                          Andreas Maschke
  95.                          Zenkerstraße 5
  96.                          06108 Halle/Saale
  97.                          Germany
  98.  
  99.                    Phone: ++49 (0)345/5170331
  100.                    EMail: epgbc@cluster1.urz.Uni-Halle.DE
  101.  
  102.  The following programs belong to the Dust-project
  103.   Dust (recent version: 2.31)
  104.   DustMD
  105.   Mesh2TDDD
  106.   makeHaze
  107.  
  108.  IF YOU PAID FOR ONE OF THIS PROGRAMMS YOU ARE REGISTERED
  109.  FOR ALL OTHERS IN THIS LIST.
  110.  
  111. 6. History/TODO
  112. --------------------------------------------------------------------
  113.  
  114. History
  115.  v0.1 (19 September 1995) - slow, ugly results
  116.  v0.2 (20 September 1995) - fast, better results, keep-option
  117.  v0.3 (21 September 1995) - speed-factor 2
  118.  
  119. TODO
  120.  -antialiasing
  121.  
  122. (22 September 1995)
  123.