home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / NEWS / 2294 / DOC / MANUAL.US next >
Text File  |  1993-10-07  |  5KB  |  137 lines
  1.                 *****************************************
  2.                 *              User Manual of           *
  3.                 *                                       *
  4.                 *                  BMORPH               *
  5.                 *                                       *
  6.                 *             by Benoît HOZJAN          *  
  7.                 *****************************************
  8.                 
  9.  
  10.  
  11. INTRODUCTION
  12.  
  13.         Bmorph works in VESA 640 x 400 256 colors, so you need to use a 
  14. VESA TSR to use it. You must use the Logitech 6.2 mouse driver too.
  15.         You must use 320 x 200 gray-scale pictures.
  16.         This software has been written in Turbo Pascal with ASM video 
  17. routines.
  18.  
  19.  
  20. I - How to Install BMorph on your HD  (for example C: and A:)
  21.  
  22.         Make a directory        C:\>MD BMORPH
  23.  
  24.         Change directory        C:\>CD BMORPH
  25.  
  26.         Copy the floppy disk    C:\BMORPH>XCOPY A:*.* C:\BMORPH /E /S
  27.  
  28.         Install the right VESA TSR driver in your AUTOEXEC.BAT
  29.  
  30.         Install the Logitech 6.2 Mouse drivers in your AUTOEXEC.BAT after the
  31.                 VESA driver.
  32.  
  33.  
  34. II - How to launch BMorph.
  35.  
  36.         The command line needs to have 4 or 5 parameters :
  37.  
  38.         Parameter n°1 : Name of the initial photo file
  39.         Parameter n°2 : Name of the final photo file
  40.         Parameter n°3 : Number of frame
  41.         Parameter n°4 : Name of the save file
  42.         Parameter n°5 : Name of the grid file [optionnal]
  43.  
  44.         Example 1 :
  45.                 BMORPH PHOTO1 PHOTO2 15 SAVE
  46.         This line will launch a morphing between PHOTO1.BMP and PHOTO2.BMP
  47. with 15 frames and the result will be stored to a SAVE.BEN file.
  48.  
  49.         Example 2 :
  50.                 BMORPH PHOTO1 PHOTO2 15 SAVE PHOTO1-2
  51.         Idem but a grid of control will be loaded. The grid file PHOTO1-2.GRI
  52. must exist.
  53.  
  54. III - Different files.
  55.  
  56.         Extensions are forbidden for all files of the command line. 
  57. They must be : 
  58.                 BMP for a pictures file
  59.                 GRI for a grid file
  60.                 The animation will be with a BEN extension.
  61.                 Sources' photos must be in BMP uncompressed (RGB encoded)
  62. format. It is in fact a screen copy. There are as many bytes as pixels on the
  63. screen. For a 320 x 200 256 color picture, the size of such a file is 
  64. 65078 bytes.
  65.  
  66. IV - How to use BMorph.
  67.  
  68.         As soon as the program will be launched, the screen turn on 640 x 400
  69. 256 colors video mode and the two photos are displayed on the top of the 
  70. screen.
  71.         After, the two grids are displayed. In case of the 5th parameter does
  72. not exist, the grid will be regular, or else the grid will be modified.
  73.         Some information are displayed on the bottom of the screen.
  74.         You can now modify the grid by using your mouse. You must try to 
  75. follow as good as possible features.
  76.         Click on a point and drag it to the new position.
  77.         Press a key to begin the morphing. If you did not give a name to
  78. the grid file, your modified grid will be stored in a default file called 
  79. SAVE.GRI. Otherwise, your grid will be saved in the same file where it was 
  80. loaded.
  81.  
  82. V - Calculation
  83.  
  84.         A part of calculation uses integers instead of reals. The result is
  85. displayed progressively.  
  86.         Speed test for the morphing makes with DEMO.BAT :
  87.  
  88.                 2'50''  on a 386 SX 33
  89.                 2'33''  on a 386 DX 25
  90.                 1'53''  on a 386 DX 33
  91.                   40''  on a 486 DX 66
  92.  
  93.         Speed test for FBmorph (which needs a fcpu) :
  94.  
  95.                 1'56''  on a 386 DX 25
  96.                 1'26''  on a 386 DX 33
  97.                   30''  on a 486 DX 66
  98.  
  99.  
  100. VI - How to see the result.
  101.  
  102.         You must use the ANIM_BEN.EXE program to show an animation file. For
  103. example, to show the SAVE.BEN file, you must type the following command
  104. line :
  105.                         ANIM_BEN SAVE
  106.         I would advise to use memory cache as SMARTDRV.EXE because it is 
  107. faster.
  108.  
  109. ANNEXES
  110.  
  111. A - Bugs
  112.         A bad grid can generate a bug.
  113.  
  114. B - Evolutions
  115.         correcting bugs
  116.  
  117. C - Registration
  118.  
  119.         For 10$ or more, you will receive :
  120.                 Sources of BMorph
  121.                 Sources of ANIM_BEN
  122.                 Sources of VOIR_BMP which displays 320 x 200 BMP files
  123.                 Program DEFORME which makes caricatures with 320 x 200 
  124.                         BMP files in colors.
  125.                 Latest versions and FBMorph which needs a coprocessor.
  126.                 A fascicule which explains how BMorph makes morphing.
  127.  
  128.                 And especially my everlasting gratitude !
  129.  
  130.         Sincerely.
  131.  
  132.                                                 Benoît HOZJAN
  133.                                                 33 Route de Vallan
  134.                                                 89000 AUXERRE
  135.                                                 FRANCE
  136.  
  137.