home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / graphuti / pcube1.zip / READ.ME < prev    next >
Text File  |  1993-08-30  |  7KB  |  178 lines
  1. -------------------------------------------------------------------------
  2. PCUBE1.EXE
  3.  
  4. Copyright 1993, Joel Duerksen, All Rights Reserved.
  5.  
  6. Joel Duerksen
  7. 11030 Hunters Blvd.
  8. Indianapolis, Indiana. 46236, USA
  9.  
  10. Internet:  duerksen@lilly.com
  11.  
  12. -------------------------------------------------------------------------
  13.  
  14. Requirements:        386 or better
  15.                      VGA or better
  16.  
  17. Limitations:         64k per picture (actual pixels, does not 
  18.                      include palette or other data) 
  19.  
  20.                      A 300x100x256 picture takes 30000 bytes
  21.  
  22.                      Probably won't run under WinDoze,
  23.                      OS Ptuey, etc.  I didn't use an
  24.                      alias for my Code segment?  ;-)
  25.                      
  26. Shareware fee:       $20 for personal use
  27.                      (for business or other use please contact me...)
  28.  
  29.  
  30. What is pcube1.exe?
  31.  
  32. It is a program to display YOUR pictures on a rotating "picture" cube.
  33.  
  34. Seven pictures may be specified.  PCUBE1 can currently read 768
  35. palette files (RGB, RGB... format) ie. palette files generated by
  36. 256PAINT, or the "pal" file that comes with ACK3DKIT.
  37.  
  38. It can also read .VGA files (256paint's format), .IMG files
  39. (ACK3D's format), and 256 color PCX files (ZSoft PCX format).
  40.  
  41. It also recognizes, "nul" and "Time" as special filenames.
  42.  
  43. Options are processed in the order specified on the command line.
  44. Here are some examples
  45.  
  46. pcube1 nul my.pal Time -p
  47.  
  48.   Blank background with Time and Date on every side of the cube,
  49.   using perspective, and using my.pal palette file for colors.
  50.  
  51. pcube1 pal jfish.img m1.img side.img tree.img eye.img w1.img tv.img
  52.  
  53.   Display the listed .img files, using the "pal" palette file.
  54.  
  55.   NOTE:  The palette is aquired from a palette file (file with size
  56.   of 768) or, the first .PCX or .VGA which has a palette in it.
  57.   All following images (with a palette) are adjusted to display
  58.   using that palette. (3D RGB cube distance method)
  59.  
  60. The order the pictures are placed on the command line determines where
  61. they will be placed.
  62.  
  63. Pict 1      pict 2  pict 3  pict 4  pict 5  pict 6  pict 7
  64. background  top     front   left    right   back    bottom
  65.  
  66. Actually the program is now quite flexible, you can specify
  67. options, palettes, and image files (.img, .vga or .pcx) in
  68. any order.  Remember though that the options are processed in
  69. the order received, and all options are processed.  If you
  70. want to use a specific palette specify it before the pictures.
  71.  
  72. I have included three example batch files, one is a single
  73. picture of a rose, (original palette always looks better).
  74. I personally photographed and digitized ALL of the pictures,
  75. I already know that my images leave something to be desired,
  76. but I didn't want to worry about Joe Photo's laywer calling
  77. me up about a picture I used on the cube, for demoing it.
  78. Here is the complete option list, (run pcube1 with no options)
  79.  
  80.  options:   -p###    do perspective ### on 3D coordinates
  81.                      (-p0 turns perspective off)
  82.             -z##.#   set cube size to ##.# (5.0-80.0)
  83.             -a#      strict Affine texture mapping (1 on, 0 off)
  84.             -u#      turn off background Update (1 on, 0 off)
  85.             -r       Randomize the above flags
  86.             -s#      Simple picture cube rotation (1 on, 0 off)
  87.             -x###    x-axis rotation increment 0-255
  88.             -X###    x-axis angle 0-255
  89.             -y###    y-axis rotation increment 0-255
  90.             -Y###    y-axis angle 0-255
  91.             -i       Information on exit
  92. real-time options are most of the above (letter commands) and:
  93.              +       increase size
  94.              -       decrease size
  95.              [       decrease perspective
  96.              ]       increase perspective
  97.              f       freeze rotation
  98.  
  99.  
  100. History
  101. -------
  102.  
  103. The picture cube started out as a small program for me to demo
  104. my work on texture mapping for myself, to insure that it
  105. would work on all angles and sizes for 3D shapes.  Then I thought
  106. maybe other people would be interested in having a picture cube
  107. on their computer displaying their favorite pictures.
  108.  
  109. It is based on the most basic iterative technique from George
  110. Wolberg's book "Digital Image Warping". Therefore it does not
  111. handle perspective correctly.  I get the exact same warping as
  112. UW I.  It runs in mode 0x13, not mode X.  My last program ran
  113. in tweaked modes, and my next one probably will too, but not
  114. this one.  The program does use a (slightly) faster routine with
  115. source texture maps that are less than 128x128, but it is
  116. negligible.  (not the speed up I thought I would get)
  117.  
  118. Tools that may be helpful
  119. -------------------------
  120.  
  121. -  VPIC, will create .PCX images it can read. (Zsoft PCX option)
  122.  
  123. -  256paint, will read .pcx images (320x200 or less) and write
  124.    palette files and .VGA images
  125.  
  126. -  DTA (get version 2.0 if you can), will read *.gif,
  127.    create an optimal palette, resize all the images to less
  128.    than 64k (250x250 is my favorite), and then store them
  129.    all out as .PCX files.  On my computer, it takes a couple
  130.    of hours to process 6-7 pictures, it must use molasses
  131.    math. (FP)
  132.  
  133. -  pcx2img.c, not really needed anymore, (since it can read .PCX 
  134.    files now)
  135.  
  136.  
  137. Improvements that could be made
  138. -------------------------------
  139.  
  140. -  Fix pixel level errors incurred, because I used pixel centers in
  141.    source image scanline start and end pixels.
  142.  
  143. -  Add proper perspective.
  144.  
  145. -  If you buy me a 486DX66 local bus system,
  146.    I'll write a SVGA version :)
  147.  
  148. -  write planar version?
  149.  
  150.  
  151. Lots of options try them out.  Try your own pictures on the
  152. picture cube!  Let me know what you think of it.
  153.  
  154. Joel
  155. duerksen@lilly.com
  156.  
  157. -------------------------------------------------------------------------
  158.  
  159. Legal stuff:
  160.  
  161. Disclaimer:  In no event will I be responsible for any thing that
  162. may happen as a direct or indirect result of your use of this
  163. software, USE AT YOUR OWN RISK.  I have done everything that
  164. is reasonable with in my powers to assure that this software is
  165. bug free.
  166.  
  167. Copyright 1993, Joel Duerksen, All Rights Reserved.
  168.  
  169.   U.S. Goverment Restricted Rights
  170.   
  171.   Use, duplication or disclosure by the Government is subject to restrictions
  172.   set forth in subparagraph (a) through (d) of the Commercial Computer-
  173.   Restricted Rights clause at FAR 52.227-19 when applicable, or subparagraph
  174.   (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at
  175.   DFARS 252.227-7013, and in similar clauses in the NASA FAR supplement.
  176.  
  177. -------------------------------------------------------------------------
  178.