home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / DOS / GRAFISCH / CRUMB20S / CRUMBL20.DOC < prev    next >
Text File  |  1994-11-18  |  28KB  |  599 lines

  1.  
  2.                                 
  3.                                 CRUMBLER
  4.                                 ========
  5.  
  6.                                release 2.0
  7.  
  8.                     written in September-October 1994
  9.                              
  10.                                    by
  11.                         
  12.                               Carlo Moretti
  13.  
  14.                      e-mail:  moretti@cobra.csr.unibo.it
  15.                      or:      moretti@zeus.csr.unibo.it
  16.                  (PLEASE forget the old e-mail addresses!!)
  17.  
  18.  
  19.  
  20.  CONTENTS
  21.  ========
  22.  
  23.          0 - INTRO
  24.          1 - WHAT'S NEW
  25.          2 - WHAT'S "OBSOLETE"
  26.          3 - WHAT'S CRUMBLER
  27.          4 - INPUT/OUTPUT FILE FORMAT
  28.          5 - SYNTAX
  29.          6 - USING CRUMBLER AFTER A 3D PROGRAM
  30.          7 - USING CRUMBLER AFTER A 2D PAINTING PROGRAM
  31.          8 - EMBOSS, FILTERS & 2D IMAGES
  32.          9 - PATTERN FILE
  33.         10 - INPUT DEPTH IMAGE
  34.         11 - OUTPUT FILE COMPRESSION
  35.         12 - POSSIBLE PROBLEMS ? ---> POSSIBLE CAUSES !
  36.         13 - IN CRUMBLER'S FUTURE
  37.         14 - BEWARE !!!
  38.         15 - PLEASE REGISTER
  39.         16 - CREDITS
  40.         17 - GREETINGS
  41.  
  42.  
  43.  0 - INTRO.
  44.  ==========
  45.  
  46.  CRUMBLER is a simple program that creates SIRDS and SIS (STEREOGRAMS or
  47. HOLUSIONS). The first versions of CRUMBLER (releases 1.x) were implementing
  48. by using the simpler algorithm to create stereograms. Unfortunately, as it
  49. was easy to write it involved a lot of unwanted "ECHO" on the final result.
  50.  CRUMBLER 2.0 uses a 'new' algorithm which avoids the unwanted echo. The
  51. implemented algorithm is the 'hidden surface removal' modified to obtain a
  52. "true-depth" appearance, so it avoids echoes and other nasty 'sliced' effect.
  53.  CRUMBLER 2.0 is written in C language and compiled to work on every MS-DOS
  54. compatible computer and it DOESN'T require any kind of graphic board (well,
  55. you need one just when want to see the output image...).
  56.  
  57.  
  58.  1 - WHAT'S NEW
  59.  ==============
  60.  
  61.  This is the third release of CRUMBLER and it has been updated quite a bit
  62.  
  63.  The following update were made from CRUMBLER 1.0 to CRUMBLER 1.1:
  64.  
  65. . Crumbler 1.1 was able to produce SIRDS (without using a pattern file).
  66. . +f<> option was added (IN 2.0 THIS OPTIONS HAS BEEN REMOVED)
  67. . There was a 'Skeleton method' to create 'skeleton-like' effects.
  68. . There was a 3D Studio Material Library to map your 3d objects correctly.
  69. . There were 5 'gradient' images to map 3d objects in POV-Ray, and other 3d
  70.   programs.
  71. . There were few pattern images ready to use.
  72. . There were input files to use as example.
  73.  
  74.  Here are the lastest updates  in CRUMBLER 2.0:
  75.  
  76. . Hidden surface removal algorithm, which reduces the echo.
  77. . A PATTERN-MAKER program has been added to the package, it's called PMAKER 1.0
  78. . REMOVED the +f<> option!!
  79. . Transformed the +wXXX option!! (Based on DPI!!)
  80. . ADDED the +rXXX option (DPI resolution)
  81. . ADDED the +zXX.XX option (Depth of field)
  82. . ADDED +b (black & white SIRDS) and +g (grey shade SIRDS) options
  83. . ADDED +c option for CROSS-EYED holusions (Very quick too!)
  84. . Now crumbler reads compressed RLE, uncompressed, greyscale, 256-indexed,
  85.   true-colour 24-bit TARGA files and writes 24-bit compressed RLE or
  86.   uncompressed ones.
  87. . ADDED the +RLE option (Run-LEnght output TGA compression)
  88. . Crumbler 2.0 is SLOWER than 1.x!!! (Is this so great??)
  89. . ADDED a normal 'integer' (+INT option) stereogram (SIRDS and SIS) algorithm
  90.   (produces classic sliced stereograms). Avoids blur effect on SIRDS.
  91. . A bug have been removed (the +o option didn't remove the old file and caused
  92.   problems in previous versions)
  93.  
  94.  
  95.  2 - WHAT'S "OBSOLETE"
  96.  =====================
  97.  
  98.  As CRUMBLER 2.0 have been completely rewritten, lots of things changed.
  99.  The .MLI file (Material Library for 3D-Studio) has been unchanged.
  100.  The +p, +o, +s and +d options remain the same.
  101.  
  102.  
  103.  3 - WHAT'S CRUMBLER
  104.  ===================
  105.  
  106.  The REALLY GREAT thing is that CRUMBLER is able to generate stereograms with
  107. !!!!! 16777216 !!!!! (read: 'more than 16 millions'!!!) of depth planes.
  108.  Usually stereograms were generated with a limited number of depth planes
  109. (20 - 64 planes), and in 3d objects you may have problems to mark out small
  110. details.
  111.  This new technique used, makes the program able to create a continuous 3d
  112. effect.
  113.  
  114.  CRUMBLER generates compressed or uncompressed TRUECOLOR .TGA files and reads
  115. 256 indexed, grey-scale or truecolor input and pattern files (compressed or
  116. uncompressed). The compression is quite simple, it's called Run-LEnght (RLE)
  117. and is very useful when you have a lot of pixels of the same colour, so it can
  118. be used for input images (for example, with a black flat background) but it's
  119. not very good for output SIRDS (in which all the pixels are different).
  120.  
  121.  CRUMBLER is easy to use after 3D Studio or other 3D good software's.
  122.  It takes about one minute to 'crumble' a 1024x768 image on a 486DX2/66,
  123. by using 'SMARTDRV' or other I/O-buffers or either a CACHE controller, but
  124. it's generally quite slower than CRUMBLER 1.x. This because of the new
  125. algorithm. The execution time also depends on the source image complexity.
  126.  
  127.  CRUMBLER is able to crumble Targa files of ANY RESOLUTION: the only limit is
  128. your available memory.
  129.  
  130.  
  131.  4 - INPUT/OUTPUT FILE FORMAT
  132.  ============================
  133.  
  134.  As said before, the input images MUST be: "compressed or uncompressed 256,
  135. grey or 24 bit colour .TGA". For the RLE types, try using NO MASK: mask can
  136. cause problems to input file reader.
  137.  Output images can be ONLY: "compressed or uncompressed 24 bit Targa files"
  138. (check +RLE option above).
  139.  
  140.  These are some of the programs that let you create the right source images:
  141. . 3D Studio (r1, r2, r3,...)
  142. . P.O.V.ray (r1.0, r2.0, r2.1, r2.2 and every other compatible version)
  143. . Alchemy (every version I know) by typing "alchemy -a10" or "alchemy -a1"
  144. . Photo Styler (1.0, 1.1, 2.0 ...)
  145. . PhotoShop (2.5, ...?)
  146. . Imagine 2.0, 3.0 (PC's versions)
  147. . many others...
  148.  
  149. NOTE!!! that TGA 15, 16 and 32 bit colours ARE NOT considered readable!!
  150.  
  151.  
  152.  5 - SYNTAX
  153.  ==========
  154.  
  155.  CRUMBLER 2.0 requires 2 ORDERED file names and 7 optional parameters:
  156.  
  157.         > CRUMBLER  <input[.TGA]>  <output[.TGA]>  [+options]
  158.  
  159.  Input file is the same of version 1.x (see  INPUT DEPTH IMAGE);
  160.  output file is checked (see +o flag);
  161.  pattern file is an option (see "+p<>").
  162.  When the end of the pattern file is reached, CRUMBLER 2.0 will re-start from
  163. its beginning.
  164.  
  165.  [OPTIONS]:
  166.  
  167.  +wXXX  is only used to calculate the RESOLUTION in DPI (see +r option).
  168.         Use this option (without "+r") if you have to create a SIS with a
  169.         FIXED pattern file, so set "+w" as the X_res of the pattern file
  170.         you want to use. But... *** This causes ECHO!!***
  171.  
  172.  +rXXX  is the resolution (DPI) for the output image. Consider, for a 14 inch
  173.         monitor, a standard resolution of 72 DPI at 1024x768. 
  174.         If you set the "+w" option, you can't set the "+r" one.
  175.         This option replaces the old "+w": the distance between two repeated
  176.         pixels depends on the distance between your eyes (fixed in about
  177.         2.5 inches) and on the resolution of the output device (72 DPI for
  178.         monitors, 150, 300, 600... for laser printers...)
  179.         Anyway you can use "+r60" for a laser printer and "+r120" for a
  180.         monitor, but you know that:
  181.         - Higher the +r value, deeper becomes the stereogram.
  182.         - Lower values decrease the output depth.
  183.         Lower values can be easier to see, higher values could be hard!
  184.         but, ->REMEMBER:<-
  185.  
  186. *******************************************************************************
  187. ********* DON'T STRAIN YOUR EYES TO RESOLUTIONS THAT ARE TOO HIGH *************
  188. ******* WARNING ** THIS CAN CAUSE PROBLEMS TO YOUR EYESIGHT!!!!!!!! ***********
  189. *******************************************************************************
  190.  
  191.  +zXX.XXX  is the Depth of Field. Now, with "+z" you can specify the depth
  192.            of the stereogram, in this way:
  193.            The lowest value is 1.0 and creates the most deeper stereogram.
  194.            Higher the value, squashed the output.
  195.            Values greater than 10.0 make the stereogram appear flat.
  196.            Default values: 2.0 for wall-eyed stereograms (def.) and 4.0 for
  197.            cross-eyed ones (+c option).
  198. ********* ONCE AGAIN, THIS OPTION CAN BE DANGEROUS FOR EYESIGHT!!!! ***********
  199.  
  200.  +p<pattern_file_name[.TGA]> If specified, this  tells crumbler to create
  201.                              a SIS using the given pattern file. If NOT used,
  202.                              crumbler will create and use a random pattern 
  203.                              to produce SIRDS.
  204.                              Obviously, without the "+w" option, pattern
  205.                              file works in a different way! Every 'pattern raw'
  206.                              is copied few time over the same 'output raw' and
  207.                              the "width" or the distance between two repeated
  208.                              patterns is different for each "+r" value.
  209.                              Suggested width for pattern files is THE SAME of
  210.                              the input file to avoid echoes on SIS (OFTEN WILL
  211.                              BE USED ONLY THE <n> RIGHTEST PIXELS, depending
  212.                              on the +r value).
  213.                              This options WON'T work with "+b" or "+g".
  214.  
  215.  +b   creates black & white SIRDS, but neither "+p<>" and "+g" must be set.
  216.  
  217.  +g   creates grey-shade SIRDS, but neither "+p<>" and "+b" must be set.
  218.  
  219.  +dXXXX tells about source image:
  220.  
  221.         '256'  will use a source image 'averaging' the RGB values for each
  222.                pixels (more the pixel is bright, more it becomes near)
  223.                This is common to use with a grey scale source image: 
  224.                every of the 256 Grays (from [0,0,0] to [255,255,255]) 
  225.                represents a depth level.
  226.                A RGB colour (R=100, G=30, B=80) is like a 'grey=70' value and
  227.                the depth level used is the 70th from background.
  228.  
  229.         '768'  will 'add' the RGB values (R+B+G) to perform 768 levels
  230.                (example: R=5, G=100, B=230 is evaluated as the 335th depth
  231.                plane from background; more brighter, more near)
  232.                With this option the RGB colour (R=10, G=70, B=123) is 
  233.                exactly equal to (R=40, G=102, B=61) and means the 203th 
  234.                depth plane from back.
  235.  
  236.         '4096' will evaluate the formula: r*16+g+b/16. This will give you
  237.                4096 depth levels. It's hard to create a source images of
  238.                this type without a 3d program and an image map!
  239.  
  240.         '64k'  this feature lets you create 65536 depth levels with a
  241.                smoother appearance. There's a new map image for 3d software's
  242.                which let CRUMBLER recognise 3d software's colours approximation
  243.                like antialiasing or motion blur. It uses RED and GREEN primary
  244.                colours: for each even RED values GREEN values are 0..255, while 
  245.                for odd RED values GREEN becomes 255..0
  246.              *** THIS ONE I SUGGEST!! ***
  247.  
  248.         '16m'  tells CRUMBLER to evaluate: r*65536+g*255+b. Red is the most
  249.                significant primary colour, blue could be omitted (I'm sure
  250.                you can't see 'blue variation').
  251.                This is done for images created with 3d software's and mapping
  252.                the objects with a given image map. 
  253.                DON'T try to use strange colour configurations if you
  254.                want to see a nice result (read "a normal stereogram"). 
  255.  
  256.  +f[l|c|r]   Is not available anymore!!
  257.  
  258.  +o     If the specified output file already exists, crumbler will now remove
  259.         it and create a new file if '+o' is used; otherwise (if +o is omitted)
  260.         it returns an error message.
  261.  
  262.  +INT   Tells crumbler to use an integer classical algorithm.
  263.         This will avoid possible problems like BLUR EFFECTS for large images,
  264.         but doesn't create those "true-depth" effect. Nice for SIRDS.
  265.  
  266.  +RLE   Tells crumbler to write compressed .TGA files. (see  I/O file format)
  267.  
  268.  +sXXX  tells crumbler to 'slice' the 3d object in "XXX" slices and
  269.         inverting them. This will give a 'skeleton' appearance to your object
  270.         (try using this and you'll understand what I mean!)
  271.         +s0 means OFF (Default), every other values are good.
  272.         +s1 means a CROSS-EYED view (just one big inverted slice)
  273.         Suggested values between 10 and 30.
  274.  
  275.  +c     tells CRUMBLER to generate a CROSS-EYED stereogram. This option is 
  276.         available ALSO with "+sXXX".
  277.  
  278.  
  279.  
  280.  6 - USING CRUMBLER AFTER A 3D PROGRAM
  281.  =====================================
  282.  
  283.  If you are able to use a 3d program like 3D Studio (this is from AutoDesk
  284. and it's NOT a PD software), POV-Ray, Vivid, DKB, Imagine, LightWave or other
  285. 'render/raytracing' programs, I suggest you to use an image map as a texture
  286. for your entire scene as shown:
  287.  
  288.  
  289. (Back)  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ Black (0,0,0)
  290.         ░░Top,░Bottom,░Left░or░Right░view.░░░░░░░░░░░░░░ ^
  291.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ |
  292.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ |  (...Dark grays...)
  293.         ░░░░░░░░░/-----------------\░░░░░░░░░░░░░░░░░░░░ |
  294.         ░░░░░░░░/░░░░░░░░░░░░░░░░░░░\░░░░░░░░░░░░░░░░░░░ |
  295.         ▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒\▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ DarkGray (63,63,63)
  296.         ▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒\▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ ^
  297.         ▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒----\▒▒▒▒▒▒▒▒▒▒▒▒ |
  298.         ▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒▒▒This▒▒▒▒▒▒▒▒▒▒▒▒▒\▒▒▒▒▒▒▒▒▒▒▒ |  (...MD grays...)
  299.         ▒▒▒▒▒▒▒▒|___▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒▒▒▒ |
  300.         ▒▒▒▒▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒is▒▒▒▒▒▒▒▒▒▒▒▒▒|▒▒▒▒▒▒▒▒▒▒▒ |
  301.         ▓▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓ MidGray (127,127,127)
  302.         ▓▓▓▓▓▓▓▓▓▓▓/▓▓▓▓▓▓▓▓your▓▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓ ^
  303.         ▓▓▓▓▓▓▓▓▓▓/▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓ |
  304.         ▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓3d▓▓▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓ |  (...ML grays...)
  305.         ▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓ |
  306.         ▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓object▓▓▓▓▓▓▓▓▓▓▓|▓▓▓▓▓▓▓▓▓▓▓ |
  307.         ██████████\█████████████████████████|███████████ LightGray (191,191,191)
  308.         ███████████\███████████████████████/████████████ ^
  309.         ████████████\_____________________/█████████████ |
  310.         ████████████████████████████████████████████████ |  (...Light grays...)
  311.         █████████████████████████ This is your mapping █ |
  312.         ████████████████████████████████████████████████ |
  313. (Fore)  ████████████████████████████████████████████████ White (255,255,255)
  314.                      \                    /
  315.                       \                  /
  316.                        \                /
  317.                         \              /
  318.                          \            /
  319.                           \          /
  320.                            \        /
  321.                             \      /
  322.                              \    /
  323.                           ------------
  324.                          | Place Here |
  325.                          | The camera |
  326.                          |____________|
  327.  
  328.  
  329.  The planar mapping and the camera should be parallel, and the object 
  330. should be lighter when near the camera and dark when away from it. 
  331.  
  332.  Crumbler 2.0 is provided 5 image maps:
  333. y 256__cru.tga is a grey scaled map to use with +d256 option
  334. . 768__cru.tga is the map shown above to use with +d768
  335. . 4096_cru.tga is to use with +d4096 (4096 raw to create 4096 depth levels)
  336. y 65536cru.tga for +d64k (again 16384 depth levels, but looks smoother)
  337. . 16384cru.tga to use with +d16m (creates 16384 depth levels)
  338.  
  339. *THE BEST TO USE IS 65536CRU.TGA, BECAUSE IT GIVES THE SMOOTHEST OUTPUT*
  340.  
  341.  Actually I can't find a program to create (and use) a TGA file with up to
  342. 65535 raws, so if you want more depth levels you must create your source
  343. file your own (good luck!).
  344.  No programs that I know can read a 16384 raw image file, so you should
  345. use a lower colour level map to obtain a lower depth levelled stereogram.
  346.  Please, DON'T try to convert those map files with a JPEG compression, 
  347. because it will cause a considerable amount of distortion in the input file.
  348.  
  349.  
  350. Hints :
  351.  
  352. . The 3d program scene must NOT include any kind of light.
  353. . You must use ONLY the ambient light at the max. value.
  354. . Don't use anti-aliasing because it changes the real pixel colour (changing
  355.   the depth too).
  356. . Don't use any kind f GAMMA CORRECTION too, to avoid any source image
  357.   distortion.
  358. . Avoid any kind of dithering (also truecolor dithering is BAD!) to make sure
  359.   you obtain a smoother output.
  360.  
  361.  
  362.  7 - USING CRUMBLER AFTER A 2D PAINTING PROGRAM
  363.  ==============================================
  364.  
  365.  If you can't use a 3d good software you can create your source images by
  366. using a normal 2d painting program. This will obviously make you obtain
  367. a lower quality stereogram.
  368.  You can work in 2 ways: a grey scaled source image (THE EASIEST WAY) or a
  369. coloured one.
  370. 1) Grey scale sources images could be created by using a black background 
  371.    and brightening the pixel you want to see nearest. Every grey level
  372.    corresponds to a depth level. 
  373.    This is right with the +d256 options and give out a 256 depth level
  374.    stereogram.
  375. 2) You can obtain a 768 depth level stereogram by 'emulating' an image map 
  376.    in this way: increasing a single value of the RGB palette you will work
  377.    on the depth level nearest the last one used (e.g. [0,100,0] appears
  378.    near [0,101,0]). In this way a [0,0,0] colour is the background, a
  379.    [255,0,0] or [0,255,0] or [0,0,255] colour is the 255th depth level (1/3 
  380.    from back), a [255,255,0] or [255,0,255] or [0,255,255] colour is the
  381.    512th level (2/3 from background) and [255,255,255] (white) is the 
  382.    last depth level (the nearest one to you).
  383.    This is right with the +d768 option (will make you able to work on 768
  384.    different levels).
  385.  
  386.  
  387.  8 - EMBOSS, FILTERS & 2D IMAGES
  388.  ===============================
  389.  
  390.  If you would like to use a 2d image like a photo and you want to try to
  391. 'stereogrammize' it, you can try to use an 'emboss' filter (PhotoStyler and
  392. other photoTouch programs are able to do that) before using crumbler. I don't
  393. suggest you use an heavy effect. This could give an interesting aspect to
  394. your stereograms.
  395.  Use the +d256 option with crumbler and try to diminish the source image
  396. contrast if the stereogram seems too crumbled.
  397.  Try also "blur" filters to smooth the output.
  398.  You can try also to use CRUMBLER without changing anything in your source
  399. image; you will see "something like"..... the source image, but a lot depends
  400. on the illumination, the light position, the colours and so on. Use a high +z
  401. value and +d256 options.
  402.  
  403.  
  404.  9 - PATTERN FILE
  405.  ================
  406.  
  407.  If you set the '+p<patternfile>' option you need to know how the pattern
  408. should be constructed.
  409.  The pattern file can be a compressed or uncompressed 256, grey or truecolor
  410. Targa image file, so you can convert any image you like using other programs
  411. like PhotoStyler, PhotoShop, Alchemy and many others, quoted before.
  412.  You can use any kind of image and you can experiment new particular pattern
  413. files (I've tried with a little navel image, but it was too less coloured). 
  414.  It's important that the pattern has DIFFERENT COLOURS and NOT TOO MANY PIXELS
  415. THE SAME. Remember !! that a random pattern is ideal.
  416.  It can also be done in black and white (right to be printed), but there must
  417. be irregular shapes in the pattern file.
  418.  A nice pattern file could be generated using FRACTINT or other fractal 
  419. programs. Try using 'PLASMA' and rielaborating the images with mirroring, 
  420. deforming and changing colours & contrasts.
  421.  
  422.  CRUMBLER 2.0 is provided with a new program called PMAKER, (PATTERN-MAKER)
  423. which generates .TGA files right to be used as pattern files for CRUMBLER.
  424. This is a VERY useful tool to create nice stereograms, it is also VERY
  425. powerful ,if you know the right techniques to use.
  426.  
  427. See PMAKER.DOC for more.
  428.  
  429.  
  430.  10 - INPUT DEPTH IMAGE
  431.  ======================
  432.  
  433.  The input image must be a depth image, so that it has gradient coloured 3d 
  434. shapes to tell CRUMBLER how far to place that shape and how thick it should be.
  435.  The input image should appear something like this:
  436.  
  437.      ░░░░░░|░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  438.      ░░░░░░|░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  439.      ░░░░░░|░░░░░░░░▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  440.      ░░░░░░|░░░░░░░▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  441.      ░░░░░░|░░░░░░░▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  442.      ░░░░░░|░░░░░░░▒▒▒▓▓▓▓▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  443.      ░░░░░░|░░░░░░░▒▒▒▒▓▓▓▓▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  444.      ░░░░░░|░░░░░░░▒▒▒▒▒▓▓▓▓▒▒░░░░░░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░|░░░░░░
  445.      ░░░░░░|░░░░░░░▒▒▒▒▓▓▓▓▒▒▒░░░░░░░▒▒▓▓▓▓▓▓▓▓▓▓▓▓▒▒░░░░░░░░░░░|░░░░░░
  446.      ░░░░░░|░░░░░░░▒▒▒▓▓▓▓▒▒▒▒░░░░░░░▒▒▓▓████████▓▓▒▒░░░░░░░░░░░|░░░░░░
  447.      ░░░░░░|░░░░░░░▒▒▒▒▒▒▒▒▒▒▒░░░░░░░▒▒▓▓████████▓▓▒▒░░░░░░░░░░░|░░░░░░
  448.      ░░░░░░|░░░░░░░▒▒▒▒▒▒▒▒▒▒░░░░░░░░▒▒▓▓▓▓▓▓▓▓▓▓▓▓▒▒░░░░░░░░░░░|░░░░░░
  449.      ░░░░░░|░░░░░░░▒▒▒▒▒▒▒▒▒▒░░░░░░░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░|░░░░░░
  450.      ░░░░░░|░░░░░░░░▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  451.      ░░░░░░|░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░|░░░░░░
  452.      ░░░░░░|▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒|░░░░░░
  453.      ░░░░░░|▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓|░░░░░░
  454.      ░░░░░░|████████████████████████████████████████████████████|░░░░░░
  455.      | Not |                                                    | Not |
  456.      | used|            Draw here your painting                 | used|
  457.      |<--->|<-------------------------------------------------->|<--->|
  458.      0                                                               X_res.
  459.  
  460.  CRUMBLER 2.0 won't use the rightist and the leftist zone of the input image,
  461. while CRUMBLER 1.x didn't use the righter "+w" pixels. The unused pixels are
  462. about the same, it depends on the "+r" value you set.
  463.  If you were using YASM by Mitchell Brandsma you'll notice that it works with
  464. the same input images, in facts if you set +d256 option you could use the 
  465. same pictures you were using with YASM as input for CRUMBLER (after
  466. converting them into .TGA).
  467.  
  468.  I suggest you to compress the input file: for a 24 bit input image it's easy
  469. to obtain a drastically compressed file (also 40:1 for simple scenes without
  470. dithering!!!) although RLE is not a great compression method.
  471.  I don't suggest to use a JPeG compression for input images, because you will
  472. loose a LARGE amount of data, degrading the stereogram quality.
  473.  
  474.  
  475.  11 - OUTPUT FILE COMPRESSION
  476.  ============================
  477.  
  478.  Output is a truecolor TGA RLE or uncompressed, and now you can compress it
  479. how you like. I suggest an high quality JPeG ("Alchemy -j80" or "-j100") or
  480. a scaled colour GIF. (high quality JPeG compression will NOT allow you to
  481. loose important information, and will help save disk space!! GIF format will
  482. make you loose more data, because of the colour scaling!!).
  483.  Obviously, if you are using "+b" or "+g" options, you better convert to a
  484. black & white or gray-shade .GIF file.
  485.  
  486.  
  487.  12 - POSSIBLE PROBLEMS ? ---> POSSIBLE CAUSES !
  488.  ===============================================
  489.  
  490.  Crumbler could have bugs, I didn't find any. Check to see if you find
  491. a 'strange' (read 'jagged', 'overcolored', 'undercolored', 'tooMuchCrumbled',
  492. 'echoed' and so on) output file:
  493.  
  494. 0) If CRUMBLER stops working after the first rows (and you CAN'T <CTRL-BREAK>
  495.    it) check for the input .TGA: CRUMBLER has problems by reading COMPRESSED
  496.    targa files WITH MASK!!! Try converting the "masked" .TGA to uncompressed
  497.    or to "unmasked".
  498.  
  499. 1) If the output file doesn't seem to be a stereogram and on the left side
  500.    the pattern appears 'distorted' and quite different from the right side,
  501.    it could depend on the '+d' parameter: check it to use the correct value.
  502.  
  503. 2) If you see a non-continuous 3D object, first check the "+INT" option (must
  504.    be omitted for the 'true-depth' effect), then check for the "+s" option
  505.    (it inverts the slices it creates, breaking the 3D obj.).
  506.  
  507. 3) If you find a soft echo when you are generating SIS, change the X_resolution
  508.    of the pattern file you are using or generate a new one with a different
  509.    "+x" value (inside PMAKER), or else, change the "+r", "+w" or "+z" value;
  510.    that's because SIS are 'repeated patterns' and cannot be randomly selected,
  511.    so a closely repeated little strip may appear giving an unwanted echo.
  512.  
  513. 4) If you don't use a pattern file and you find the output SIRDS is not
  514.    bright enough, you can compute the SIRDS by increasing the contrast or by
  515.    transparency adding colours, gradient fitting or every kind of 2d image.
  516.    This will cause you to see stereogram not so clearly but it will give you
  517.    a nice appearance to the SIRDS.
  518.  
  519. 5) If you don't use a pattern file and find the output too blur, try to set
  520.    the "+INT" option. This will make SIRDS easier to see but not true-depth.
  521.  
  522. 6) If the output image looks distorced, or looks like "sliced", sometimes
  523.    black & white too, check for your input files: CRUMBLER 2.0 is not
  524.    able to read 15, 16 and 32 bit .TGA, so convert them to 8 or 24 bit per
  525.    pixel (256 or 16.7m colors).
  526.  
  527.  
  528.  13 - CRUMBLER'S FUTURE
  529.  ==================
  530.  
  531.  I'm going to releasing another version of CRUMBLER, but I'm working on it
  532. ONLY in my spare time, so I think NOTHING before JANUARY 1995!
  533.  
  534. Here's some new features that you can look forward too:
  535.  
  536. . a DXF2TGA utility to convert ACAD files for CRUMBLER!!! (Thanx to Leandro!)
  537. . an easy-to-use GUI
  538. . a GIF file read/write option (I NEED HELP!!)
  539. . a PCX file read/write option (I NEED HELP!!)
  540. . a BMP file read/write option (I don't think someone needs another
  541.   uncompressed feature, but...)
  542. . a TIFF file read/write option (I NEED HELP!!)
  543. . a WIN version
  544. . perhaps something else....
  545.  
  546.  
  547.  14 - BEWARE!!!
  548.  ==============
  549.  
  550.  I feel I must say that watching stereograms IS DANGEROUS for your eyes,
  551. so don't dedicate too much time to viewing stereograms. Your eyes are
  552. more important than the SIRDS!.
  553.  
  554.  
  555.  15 - PLEASE REGISTER
  556.  ====================
  557.  
  558.  This software is SHAREWARE (or DEMOWARE) and it's limited to images up to
  559. 640x480, so, if you use CRUMBLER after a trial evaluation period of 30 days,
  560. or if you need to use it on images larger than 640x480, i encourage you to
  561. pay a little registration fee.
  562.  See REGISTER.DOC for more.
  563.  
  564.  
  565.  16 - CREDITS
  566.  ============
  567.  
  568.  Mega-thanx to:
  569.     - Duzy Patel
  570.  
  571.  Special thanx to:
  572.     - Peter Jennings for his feedback
  573.     - Stefano Vitali, Simone Grassi, and all other testers.
  574.     - Mitchell Bransdma for forst idea on SIRDS
  575.     - Leandro Dardini (for the future!)
  576. and everyone else helped me realizing CRUMBLER project.
  577.  
  578.  
  579.  17 - GREETINGS
  580.  ==============
  581.  
  582.  I would like to thank any one will e-mail
  583.  
  584.       moretti@cobra.csr.unibo.it
  585. or    moretti@zeus.csr.unibo.it
  586.  
  587.  (PLEASE DON'T USE OLD E-ADDRESSES ANYMORE!!!)
  588.  
  589. or mail
  590.  
  591.           Carlo Moretti
  592.           v. R. Medri 2050 Gattolino, Cesena (FO)
  593.           C.A.P. 47020   ITALY.
  594.  
  595. by sending observations, suggests, answers of any kind, results, new P.D.
  596. SIRDS makers information's and documentation about new algorithms and what
  597. else can interest 3D and stereograms world.
  598.  
  599.