home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / graphuti / rmorf4.zip / RMORF.DOC < prev    next >
Text File  |  1993-07-29  |  15KB  |  348 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                             Documentation for Rmorf
  19.  
  20.                                   Version 0.4
  21.  
  22.                                  July 29, 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 (Rmorf Version 0.4 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.           GIRL.GIF
  67.           CHEETA.GIF
  68.           GIRLCHTA.MTX
  69.           RMORF.DOC
  70.           REGISTER.DOC
  71.           AAPLAY.EXE
  72.  
  73.      If any of these files are missing, then you have an incomplete copy of
  74. Rmorf and should contact Fascinations Software to receieve a full copy.
  75.  
  76.      Despite the unlikelyhood of your computer blowing up when you run this
  77. program: Fascinations Software, and Richard Goedeken, are not in any way
  78. liable for any damages incurred by the use of this software.  The user
  79. assumes full responsibility for the use of this software.
  80.  
  81.  
  82.  
  83. ***************************************************************************
  84.  
  85. History of the program:
  86.  
  87.      Once upon a time I was flipping through a magazine, and saw a small
  88. little box on morphing, which looked like an interesting topic to me, so I
  89. logged on to a large computer system and downloaded some files on morphing.
  90.  
  91. The software that I got was very interesting, but it was slow and it
  92. crashed frequently.  So I started programming, and 11 days later Rmorf is
  93. done!
  94.  
  95. Version 0.1 was the first release, distributed 4/19/93
  96.  
  97. Version 0.2 fixed compatibility bug with Dos 5.00 not allowing the user to
  98.             load and save matrices.  Distributed 4/20/93
  99.  
  100. Version 0.3 Displays each morphed frame for a very brief time after         
  101.             morph is completed to show the the program was actually         
  102.             working.  Now outputs Targa files, Gif files, and FLI animation
  103.             files.  Also allows user to specify full morph or just a warp.
  104.             New matrix Flip button which swaps the matrices.  Allows        
  105.             user to press Escape while specifying a filename to load/save. 
  106.             Also fixes matrix bug which locked up computer occasionally    
  107.             while morphing matrices with points very close together.
  108.             Distributed 5/8/93
  109.  
  110. Version 0.4 Finally got the last of the matrix bugs (to my knowledge.) Added
  111.             the .CHR and .BGI files into the .EXE.  Added support for GIF
  112.             input.
  113.  
  114. ***************************************************************************
  115.  
  116. History of Fascinations Software and Upcoming Software:
  117.  
  118.      Fascinations software is a privately owned company formed about 6
  119. months ago by Richard Goedeken.  We do all kinds of programming, and our
  120. favourite language is assembly language.  I have written two programs in my
  121. business series. The first is a product inventory system, and the second
  122. program in this series, an extremely advanced checkbook program, is due for
  123. release in a couple of weeks.  The Midnight Hacker division of Fascinations
  124. software company, my video game subsidiary, is also going to release a
  125. ground-breaking Super-VGA action game by November first or so.  Rmorf is
  126. my first try at image processing software.
  127.  
  128. ***************************************************************************
  129.  
  130. How to reach the author:
  131.  
  132.      Since Fascinations software is very new, I would like to hear any
  133. comments or suggestions from the users of my software.  I appreciate your
  134. feedback very much.
  135.  
  136.      The author (Richard Goedeken) may be reached several ways.  The best
  137. way to contact me is through Compuserve [70304,1065].  Another good way is
  138. to call my support BBS, The Digital Phantom, at 319-396-4492 and leave a
  139. message to the Sysop or Richard Goedeken.  You may also write to me at the
  140. following address:
  141.  
  142.           Richard Goedeken
  143.           6400 North Glen Drive
  144.           Palo, IA 52324-9720
  145.  
  146.      It is also possible but unlikely that you could reach me by phone.  My
  147. home phone number is 319-396-4798.  You can try to call after 4:00pm (CST)
  148. on weekdays or all day weekends, but you don't have a very good chance of
  149. contacting me (I tend to be very busy.)
  150.  
  151.  
  152. ***************************************************************************
  153.  
  154. Registration benefits:
  155.  
  156.      This is the unregistered version of Rmorf.  You are free to use it
  157. and distribute it, but it only supports 320x200 images.  If you register
  158. this program, you will be able to morph images with higher resolutions
  159. (up to 1024x768 with enough XMS), you will have your own registered copy,
  160. and you will receive master disks.
  161.  
  162.     As an incentive to register, there are several features which the
  163. registered version of Rmorf supports but the shareware version does not.
  164. These features include: The ability to morph images with resolutions other
  165. than 320x200, total command-line control, and ANTI-ALIASING!! Actually,
  166. the anti-aliasing isn't in the registered version yet, but it will only take
  167. a day or so to add, and I expect it to be done by August 15.  If you really
  168. want to register but want to make sure you get a version that supports
  169. anti-aliasing, just put a note on the registration form and I will hold
  170. the order until the new version is complete.
  171.  
  172. To register, simply print out the REGISTER.DOC file, fill it out, and send
  173. it to me with $25 in U.S. currency.  If you live in the United States, please
  174. send me a check or money order.  If you live outside the U.S. then send
  175. either $30 in U.S. cash in a security envelope, a check for US$ written at a
  176. U.S. bank, or a check for the equivalent amount in your country's currency
  177. but drafted at one of your country's banks.
  178.  
  179. ***************************************************************************
  180.  
  181.  
  182. Overview of program:
  183.  
  184.      Basically, this program takes two images and smoothly blends them into
  185. each other.  There are several limitations to this program, however:
  186.  
  187.    1. Only 320x200 images are supported in the unregistered version.
  188.    2. Input files MUST be 320x200x24bit uncompressed targa images
  189.       or 320x200 GIFs.
  190.  
  191.    3. You must have 938k of XMS.
  192.       (If you wonder why I chose XMS rather than EMS, it is because XMS is 
  193.       faster, easier to program, and much better than EMS)
  194.  
  195.    4. Output files are 320x200x24 bit Targa files, Gif files, or FLI        
  196.       animation files.
  197.  
  198.      Despite these small limitations, the program does have a BIG
  199. advantage: speed.  This software was written in C with all of the crucial
  200. parts in assembly language.  Consequently, I can morph a frame every 7.2
  201. seconds on my 386 33mhz computer WITHOUT a math coprocessor. (A math
  202. coprocessor wont speed things up, because I used integer math rather than
  203. floating point.) 
  204.  
  205.  
  206. How to use the software:
  207.  
  208.      The format for running Rmorf is:
  209.  
  210. RMORF filename.TGA [or .GIF] filename.TGA [or .GIF]
  211.  
  212.      As stated earlier, the targa files must be 320x200x24 bits
  213. uncompressed or GIFs, or otherwise you will get an error. I have included two
  214. files, GIRL.GIF and CHEETA.GIF.
  215.      Once you have run the program, you should get a 640x350x16 screen with
  216. your pictures in gray at the top.  There should be red borders around the
  217. images.  There will also be a menu at the bottom.
  218.      Now that you have loaded your two graphic files, you will want to
  219. start putting up a grid.  The process of morphing two images together is
  220. not difficult.  You need to first get some lines on your grid.  To do this,
  221. just put the mouse cursor close to the border of one of the images (it has
  222. to be withing several pixels), and hit the right mouse button.  This will
  223. put a line on the image. If you clicked on the vertical edge of the
  224. picutre, a horizontal line will appear.  If you clicked on the horizontal
  225. edge of the picture, a vertical line will appear.  (You can have a maximum
  226. of 32 horizontal lines and 32 vertical lines.)  You will need to put
  227. several (10-20 depending on the complexity of the image) horizontal lines
  228. and vertical lines on the grids.  Note that when you put a new line on one
  229. image, a new line will also appear on the other image.
  230.      Once you have the grid lines done, you need to move the points around.
  231.  
  232. To move a point, just place the mouse cursor close to it (within 10
  233. pixels), press the left mouse button, drag it to where you want it, and
  234. release the mouse button.  You need to place the points so they correspond
  235. between the two grids.  For example, if you were doing a morph between the
  236. included girl and cheeta, you would put several points outlining the eyes
  237. of the girl, and you place the corresponding points on the other image
  238. around the eyes of the cheeta.
  239.      If the above made no sense to you, just run the program with the
  240. following command:
  241.  
  242.    RMORF GIRL.GIF CHEETA.GIF
  243.  
  244.      Then, load the 'GIRLCHTA' matrix.  When this matrix pops up, you
  245. should understand what I mean.
  246.  
  247.  
  248.      So that is the basic concept behind morphing.  Once you have placed
  249. all of your grid points, you should probably save the grid (just click on
  250. the save matrix box and enter a filename).
  251.      After you have saved the matrix, you will probably want to set the
  252. number of frames.  Note that each frame takes up 192,018 bytes, and there
  253. must also be an extra 100,000 bytes or so on your hard drive to hold the
  254. transfer matrices.  To change the number of frames, the starting frame, or
  255. the ending frame, just click on the appropriate box (the box that says
  256. 'ENDING FRAME' or whatever, NOT the box with the number in it).  After you
  257. have selected the number of frames, just click on the box that says 'GO',
  258. and you're off!  As the program does the actual morphing, several pixels in
  259. the very upper-left hand corner should switch colors.  So if your computer
  260. has been sitting for several minutes, the hard drive light isn't on, and
  261. those pixels aren't moving, then it probably crashed.  (This shouldn't
  262. happen, though.)
  263.  
  264.      If, for some reason, you decide that you don't want to do a morph
  265. while the program is morphing, you can press the <Esc> key and wait
  266. patiently for the program to finish the current frame, then it will
  267. relinquish control to you.
  268.  
  269.  
  270. Notes on new features for Version 0.4:
  271.      New GIF support!  Should be relatively transparent to the user.  Also
  272. finally got rid of all of those dumb matrix-crashing bugs.
  273.  
  274. Notes on new features for Version 0.3:
  275.  
  276.      FLI support is now available!!  I have included a public domain FLI
  277. viewing utility called AAPLAY so you can view the resulting FLI animation
  278. files.  There is a small button below the message box on the main screen of
  279. rmorf which will say 'TGA' on it.  At this point Rmorf outputs 24bit Targa
  280. files.  If you click it once, it will say Gif, and the output files will be
  281. Gifs.  If you click it again, the button will say FLI, and Rmorf will
  282. output FLI files
  283.      Generating Gif and Fli files takes longer than just TGA files because
  284. Rmorf has to remap the colors in the images and compress them.  If you are
  285. generating a Fli file, after the morphing is completed, the program will
  286. remap the colors, then it will convert all of the separate images into a
  287. Fli.  This takes a lot of hard drive space.  You should leave at least 200-
  288. 260k free per frame for the Fli file.  The resulting Fli will (obvoiusly)
  289. be smaller than this though, generally around 20-60k per frame.
  290.      If you are generating Gif files, after each frame is morphed, the
  291. computer will remap the image and save it as a Gif.  It may look as if the
  292. computer has locked up, but it probably hasn't.  It takes about 5-10
  293. seconds on my 386-33DX to do a color remap, so it takes a while.  Note that
  294. it must remap each frame individually, unlike the Fli, which only needs to
  295. remap once.
  296.      There is another new button underneath the message box which will say
  297. 'Morph' on it when you first run the program.  If you click this button, it
  298. will toggle to say 'Warp'.  In the warp mode, Rmorf only warps one matrix,
  299. and it doesn't mix the colors.  So now you can have fun by just morphing. 
  300. There are lots of possibilities for this option:  animations of pop cans
  301. crushing, re-arranging somebody's face, etc.
  302.      The last new button says 'Flip' on it.  This just swaps the two
  303. matrices when you click on it.
  304.  
  305. ****************************************************************************
  306. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  307. 7/29/93:
  308.  
  309. Observations from the Author:
  310.  
  311. Hello, all.  It has been two months since I have released a new shareware
  312. version of Rmorf.  I have been receiving huge amounts of e-mail from users
  313. notifying me that there are matrix bugs which cause the program to crash. I
  314. finally got tired of answering all of that e-mail when the bugs were already
  315. fixed in the registered version, so I wanted to put out a new shareware
  316. version, but thought it would be lame to completely re-distribute the whole
  317. program just for a bug fix.  So I decided to add in the GIF support, which
  318. works pretty nice.  
  319.  
  320. When I started Rmorf, I did not envision it ever becoming this big.  I
  321. acutally began work on Rmorf as an aside, between other programs, but it has
  322. expanded and taken large amounts of my time.  I certainly didn't expect to
  323. have as large of a distribution of Rmorf as I do now.  There have been over
  324. 1,400 downloads of Rmorf off of Compuserve alone in the past couple of
  325. months.  I have had many different offers to market Rmorf commercially,
  326. but have resisted because I like the idea of shareware.  Because of all of
  327. the registrations which I have received I have been able to purchase a
  328. brand new Comtrade 486-66 DX2, which cuts down on compile time a lot. In
  329. return, I have been able to supply you out there in computerland with quality 
  330. software at a very low price.  A program similar to this selling retail at a
  331. software shop would probably be around $100-150.  So I guess what I'm trying
  332. to say is thank you to all of the people who registered, sent me e-mail, etc.  
  333. I have had many calls from folks just wanting to say that I have done a good
  334. job with the program, and that makes it worth staying up until 2:00 am 
  335. working on eradicating a bug or adding in a new feature.  So until the next
  336. version of Rmorf, party on and be excellent to each other.
  337.  
  338. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  339. ****************************************************************************
  340.  
  341.  
  342.      Be watching for upcoming Fascinations Software releases.
  343.  
  344.  
  345.                                    Sincerely,
  346.                                    Richard Goedeken
  347.                                    (President, Fascinations Software)
  348.