home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / graphuti / rmorph.zip / RMORF.DOC < prev    next >
Text File  |  1993-04-19  |  10KB  |  271 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                             Documentation for Rmorph
  19.  
  20.                                   Version 0.2
  21.  
  22.                                  April 18, 1993
  23.  
  24.                      Copyright (c) 1993 by Richard Goedeken
  25.  
  26.  
  27.                      A product of Fascinations Software Co.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Legal Stuff:
  59.  
  60.      This software (Rmorph Version 0.1 unregistered) is shareware.  You are
  61. allowed to copy it, distribute it, upload it to BBSs, and use it.  You may
  62. not, however change or alter the files in any way.  The archive should
  63. contain the following files:
  64.  
  65.           RMORF.EXE
  66.           EGAVGA.BGI
  67.           TRIP.CHR
  68.           SANS.CHR
  69.           GIRL.TGA
  70.           CHEETA.TGA
  71.           GIRLCHTA.MTX
  72.           RMORF.DOC
  73.           REGISTER.DOC
  74.  
  75.      If any of these files are missing, then you have an incomplete copy of
  76. Rmorph and should contact Fascinations Software to receieve a full copy.
  77.  
  78.      Despite the unlikelyhood of your computer blowing up when you run this
  79. program: Fascinations Software, and Richard Goedeken, are not in any way
  80. liable for any damages incurred by the use of this software.  The user
  81. assumes full responsibility for the use of this software.
  82.  
  83.  
  84.  
  85.           
  86. ***************************************************************************
  87.  
  88. History of the program:
  89.  
  90.      I was flipping through a magazine a couple weeks ago, and saw a small
  91. little box on morphing, which looked like an interesting topic to me, so I
  92. logged on to a large computer system and downloaded some files on morphing. 
  93. The software that I got was very interesting, but it was slow and it
  94. crashed frequently.  So I started programming, and 11 days later Rmorph is
  95. done!
  96.  
  97. Version 0.1 was the first release, distributed 4/19/93
  98.  
  99. Version 0.2 fixed compatibility bug with Dos 5.00 not allowing the user to
  100.             load and save matrices.  Distributed 4/20/93
  101.  
  102.  
  103. ***************************************************************************
  104.  
  105. History of Fascinations Software and Upcoming Software:
  106.  
  107.      Fascinations software is a privately owned company formed about 6
  108. months ago by Richard Goedeken.  We do all kinds of programming, and our
  109. favourite language is assembly language.  I have written two programs in my
  110. business series. The first is a product inventory system, and the second
  111. program in this series, an extremely advanced checkbook program, is due for
  112. release in a couple of weeks.  The Midnight Hacker division of Fascinations
  113. software company, my video game subsidiary, is also going to release a
  114. ground-breaking Super-VGA action game by November first or so.  Rmorph is
  115. my first try at image processing software.
  116.  
  117. ***************************************************************************
  118.  
  119. How to reach the author:
  120.  
  121.      Since Fascinations software is very new, I would like to hear any
  122. comments or suggestions from the users of my software.  I appreciate your
  123. feedback very much.
  124.  
  125.      The author (Richard Goedeken) may be reached several ways.  The best
  126. way to contact me is through Compuserve [70304,1065].  Another good way is
  127. to call my support BBS, The Digital Phantom, at 319-396-4492 and leave a
  128. message to the Sysop or Richard Goedeken.  You may also write to me at the
  129. following address:
  130.  
  131.           Richard Goedeken
  132.           6400 North Glen Drive
  133.           Palo, IA 52324-9720
  134.  
  135.      It is also possible but unlikely that you could reach me by phone.  My
  136. home phone number is 319-396-4798.  You can try to call after 4:00pm (CST)
  137. on weekdays or all day weekends, but you don't have a very good chance of
  138. contacting me (I tend to be very busy.)
  139.  
  140. ***************************************************************************
  141.  
  142. Registration benefits:
  143.  
  144.      This is the unregistered version of Rmorph.  You are free to use it
  145. and distribute it, but it only supports 320x200 images.  If you register
  146. this program, you will be able to morph images with higher resolutions
  147. (640x480 for sure, exactly how high depends upon how I decide to write it),
  148. you will have your own registered copy, and you will receive master disks.
  149.  
  150. To register, simply print out the REGISTER.DOC file, fill it out, and send
  151. it to me with $20 in U.S. currency.
  152.  
  153. (The registered version should be availabe around May 10th, 1993, but you
  154. can send in registrations any time.)
  155.  
  156. ***************************************************************************
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Overview of program:
  165.  
  166.      Basically, this program takes two images and smoothly blends them into
  167. each other.  There are several limitations to this program, however:
  168.  
  169.    1. Only 320x200 images are supported in the unregistered version.
  170.    2. Input files MUST be 320x200x24bit uncompressed targa images
  171.       (If you wonder why I chose uncompressed targas, the reason is because 
  172.       the uncompressed targas are usually smaller than the compressed       
  173.       ones!)
  174.    3. You must have 938k of XMS.
  175.       (If you wonder why I chose XMS rather than EMS, it is because XMS is  
  176.       faster, easier to program, and much better than EMS)
  177.    4. Output files are also in 320x200x24 bit uncompressed targa format.
  178.  
  179.      Despite these small limitations, the program does have a BIG
  180. advantage: speed.  This software was written in C with all of the crucial
  181. parts in assembly language.  Consequently, I can morph a frame every 7.2
  182. seconds on my 386 33mhz computer WITHOUT a math coprocessor. (A math
  183. coprocessor wont speed things up, because I used integer math rather than
  184. floating point.) The only other morphing program that I know about for the
  185. PC takes about 10-50 minutes per frame.
  186.  
  187.  
  188. How to use the software:
  189.  
  190.      The format for running Rmorf is:
  191.  
  192. RMORF filename.TGA filename.TGA
  193.  
  194.      As stated earlier, the targa files must be 320x200x24 bits
  195. uncompressed, or otherwise you will get an error. I have included two targa
  196. files, GIRL.TGA and CHEETA.TGA, if you don't have access to a targa
  197. convertor.
  198.      Once you have run the program, you should get a 640x350x16 screen with
  199. your pictures in gray at the top.  There should be red borders around the
  200. images.  There will also be a menu at the bottom.
  201.      Now that you have loaded your two graphic files, you will want to
  202. start putting up a grid.  The process of morphing two images together is
  203. not difficult.  You need to first get some lines on your grid.  To do this,
  204. just put the mouse cursor close to the border of one of the images (it has
  205. to be withing several pixels), and hit the right mouse button.  This will
  206. put a line on the image. If you clicked on the vertical edge of the
  207. picutre, a horizontal line will appear.  If you clicked on the horizontal
  208. edge of the picture, a vertical line will appear.  (You can have a maximum
  209. of 32 horizontal lines and 32 vertical lines.)  You will need to put
  210. several (10-20 depending on the complexity of the image) horizontal lines
  211. and vertical lines on the grids.  Note that when you put a new line on one
  212. image, a new line will also appear on the other image.
  213.      Once you have the grid lines done, you need to move the points around. 
  214. To move a point, just place the mouse cursor close to it (within 10
  215. pixels), press the left mouse button, drag it to where you want it, and
  216. release the mouse button.  You need to place the points so they correspond
  217. between the two grids.  For example, if you were doing a morph between the
  218. included girl and cheeta, you would put several points outlining the eyes
  219. of the girl, and you place the corresponding points on the other image
  220. around the eyes of the cheeta.
  221.      If the above made no sense to you, just run the program with the
  222. following command:
  223.  
  224.    RMORF GIRL.TGA CHEETA.TGA
  225.  
  226.      Then, load the 'GIRLCHTA' matrix.  When this matrix pops up, you
  227. should understand what I mean.
  228.  
  229.  
  230.      So that is the basic concept behind morphing.  Once you have placed
  231. all of your grid points, you should probably save the grid (just click on
  232. the save matrix box and enter a filename).
  233.      After you have saved the matrix, you will probably want to set the
  234. number of frames.  Note that each frame takes up 192,018 bytes, and there
  235. must also be an extra 100,000 bytes or so on your hard drive to hold the
  236. transfer matrices.  To change the number of frames, the starting frame, or
  237. the ending frame, just click on the appropriate box (the box that says
  238. 'ENDING FRAME' or whatever, NOT the box with the number in it).  After you
  239. have selected the number of frames, just click on the box that says 'GO',
  240. and you're off!  As the program does the actual morphing, several pixels in
  241. the very upper-left hand corner should switch colors.  So if your computer
  242. has been sitting for several minutes, the hard drive light isn't on, and
  243. those pixels aren't moving, then it probably crashed.  (This shouldn't
  244. happen, though.)
  245.  
  246.      If, for some reason, you decide that you don't want to do a morph
  247. while the program is morphing, you can press the <Esc> key and wait
  248. patiently for the program to finish the current frame, then it will
  249. relinquish control to you.
  250.  
  251.  
  252.  
  253. Closing comments:
  254.  
  255.      Well, that's it.  You've made it through the manual and should (if
  256. you've read it all) understand basically how this program works.  Version
  257. 0.1 is the first public release, and I realize that there are still a few
  258. bugs in this program.  But if you give me lots of user feedback (as I
  259. really hope you will), then I can improve this program and really make it
  260. good.
  261.  
  262.  
  263.      Please register.
  264.  
  265.      Be watching for upcoming Fascinations Software releases.
  266.  
  267.  
  268.                                    Sincerely,
  269.                                    Richard Goedeken
  270.                                    (President, Fascinations Software)
  271.