home *** CD-ROM | disk | FTP | other *** search
/ TopWare 18: Liquid / Image.iso / liquid / top1193 / cmorph.doc < prev    next >
Text File  |  1994-02-21  |  84KB  |  2,374 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                               The Complete Morph v2.10
  8.  
  9.                                     User's Guide
  10.  
  11.                          Copyright 1993, 1994 Paul D. Nettle
  12.  
  13.  
  14.                                       _______
  15.                                  ____|__     |                (R)
  16.                               --|       |    |-------------------
  17.                                 |   ____|__  |  Association of
  18.                                 |  |       |_|  Shareware
  19.                                 |__|   o   |    Professionals
  20.                               -----|   |   |---------------------
  21.                                    |___|___|    MEMBER
  22.  
  23.  
  24.                          Document dated:  February 21, 1994
  25.  
  26.                                    Paul D. Nettle
  27.                                  9668 Washington St.
  28.                                   Romulus, MI 48174
  29.                                    (313) 941-9223
  30.  
  31.                            Author's name:  Paul D. Nettle
  32.                          Author's Compuserve ID:  72163,2442
  33.  
  34.                This document also Copyright 1993, 1994 Paul D. Nettle
  35.  
  36.           A limited license is granted to reprint short extracts from  this
  37.           document as long as credit is given to the above mentioned party.
  38.           Individuals, BBSs and User Groups  may distribute copies of  this
  39.           software, it's  documentation  and associated  files  (originally
  40.           distributed in an archive) freely as long as the files remain in-
  41.           tact, unmodified, are not re-named and are not made part of  some
  42.           larger work without the written permission of Paul D. Nettle.   A
  43.           BBS may rearchive the unmodified archived file's contents as long
  44.           as the  resulting archive  is named  CMORPH20.ZIP,  CMORPH20.ARC,
  45.           CMORPH20.LZH or CMORPH20.???
  46.  
  47.  
  48.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  49.  
  50.  
  51.                                   TABLE OF CONTENTS
  52.  
  53.           Introduction.............................................4
  54.                What is Morphing?...................................4
  55.                How does it work?...................................4
  56.           CMorph is a full-featured morphing program.  Take a look:5
  57.                System Requirements.................................6
  58.           Ombudsman Statement......................................7
  59.           Definition of Shareware..................................7
  60.           Disclaimer - Agreement...................................8
  61.           Getting Started..........................................9
  62.           Running CMorph from the command line.....................10
  63.           Configuring CMorph's Memory..............................11
  64.                Virtual Memory......................................11
  65.           Protected Mode Switching.................................13
  66.                Fine Control of Memory Usage........................14
  67.                Specifying a Range of Extended Memory...............14
  68.           A Note On the GUI........................................16
  69.           A Few Notes On the Mouse.................................17
  70.           The Go Menu..............................................18
  71.                Go menu category SYSTEM.............................18
  72.                     LEAVE button...................................18
  73.                     DOS SHELL button...............................18
  74.                     GO button......................................18
  75.                Go menu category OTHER..............................18
  76.                     HELP button....................................18
  77.                     ABOUT button...................................18
  78.           Preferences Menu.........................................19
  79.                Preferences menu category:  SPLINE SETTINGS.........19
  80.                     Submenu category:  MESH........................19
  81.                          CATMULL, BICUBIC and STRAIGHT buttons.....19
  82.                          TIGHTNESS text box........................19
  83.                     Submenu category:  INTERPOLATION...............19
  84.                          CATMULL, BICUBIC and STRAIGHT buttons.....19
  85.                          TIGHTNESS text box........................19
  86.                Preferences menu category:  SCREEN SETTINGS.........19
  87.                     DISPLAY CURVES button..........................19
  88.                     ZOOM button....................................19
  89.                     KWIK-SCREEN button.............................19
  90.                     SOUNDS button..................................19
  91.                     CURSOR COLOR buttons...........................20
  92.                     MESH COLOR buttons.............................20
  93.                Preferences menu category:  OUTPUT IMAGE FORMAT.....20
  94.                     IMAGE FORMAT buttons...........................20
  95.                     TGAs BOTTOM-UP button..........................20
  96.                Preferences menu category:  OPERATION...............20
  97.                     OPERATION buttons..............................20
  98.                     FAST MORPH button..............................20
  99.                Preferences menu category:  OUTPUT CONFIGURATION....20
  100.                     FADE 50% text box..............................20
  101.                     FADE START % text box..........................20
  102.                     FADE END % text box............................20
  103.                     WARP 50% text box..............................20
  104.                     WARP START % text box..........................21
  105.  
  106.  
  107.                                        Page 2
  108.  
  109.  
  110.  
  111.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  112.  
  113.  
  114.                     WARP END % text box............................21
  115.                Preferences menu category:  FRAME CONTROL...........21
  116.                     TOTAL FRAMES text box..........................21
  117.                     START FRAME text box...........................21
  118.                     END FRAME text box.............................21
  119.                     FRAME OFFSET text box..........................21
  120.           The Other Menus..........................................22
  121.                The Edit Menu.......................................22
  122.                The File Menu.......................................22
  123.                The Filters Menu....................................22
  124.                The Preview Menu....................................22
  125.                The FLICs Menu......................................23
  126.           Creating a Mesh..........................................24
  127.           Filter file (FILTERS.TXT) format.........................25
  128.           AnimComp -- The Animation Compiler.......................27
  129.           LAnim -- The Animation Player............................29
  130.           Convert -- The Image Conversion Tool.....................30
  131.           TurboFlic (TFlic) -- The Flic Builder....................31
  132.           IPI File Format..........................................33
  133.           Future Enhancements......................................34
  134.           Contacting Customer Support..............................35
  135.           Ordering Information.....................................36
  136.                What you will get when you register.................36
  137.                Non-registered vs registered users..................36
  138.           How to Register..........................................38
  139.                How to register with the author.....................38
  140.                How to register on-line with the CompuServe.........38
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.                                        Page 3
  170.  
  171.  
  172.  
  173.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  174.  
  175.  
  176.                                     INTRODUCTION
  177.  
  178.           Thank you for choosing  "The Complete Morph."   I hope that  this
  179.           product will be as useful for you as it was fun for me to  write.
  180.           I'll try to keep this document  from being dry, so forgive me  if
  181.           the jokes get bad.
  182.  
  183.           From  now  on,  lets  just  call  "The  Complete  Morph"   CMorph
  184.           (pronounced "See-Morph".)
  185.  
  186.           What is morphing?
  187.  
  188.                Morphing is the process of slowly  fading from one image  to
  189.                another, while warping the contents  of both images so  that
  190.                they "metamorphasize."
  191.  
  192.           How does it work?
  193.  
  194.                Morphing is, in theory, actually very simple.  Understanding
  195.                how morphing works internally will aid you in creating high-
  196.                quality morph animations.
  197.  
  198.                For a  good quality  morph, start  by taking  your time  and
  199.                finding  a  pair  of  similar  images  that  have  the  same
  200.                resolution.  As an example, try  to find two 320x200  images
  201.                that both contain a full-screen face that is facing the same
  202.                way, has the same orientation, and who's major points (eyes,
  203.                etc.) line up pretty close to each other if they were to  be
  204.                overlaid.
  205.  
  206.                Now that you  have two images,  a mesh must  be placed  over
  207.                each one.   This  is the  "manual-labor" part  of  morphing.
  208.                Take your time, this mesh defines the quality of the morph.
  209.  
  210.                A mesh is made up of horizontal and vertical lines  overlaid
  211.                onto both  images.   Each  vertex of  the  mesh can  be  re-
  212.                located.  The points are usually connected by a curved  line
  213.                to smooth the  bends.   But be careful  not to  let any  two
  214.                horizontal or any two vertical mesh lines cross.
  215.  
  216.                Once all of the mesh lines  are complete, the points in  the
  217.                mesh should  line up  with their  counterpart on  the  other
  218.                image (for example, the  point on the  source image that  is
  219.                centered in the left  eye should have  a counterpart on  the
  220.                destination image  that is  also on  the  left eye  in  that
  221.                image), the morphing is ready to  begin.  A hint for a  real
  222.                clean morph is to  align points in the  image that not  only
  223.                select the  features of  the image,  but also  outline  it's
  224.                features with the lines that connect the points together.
  225.  
  226.                Morphing is a three-step process.   The first two steps  are
  227.                the warping  steps.   The warping  is  done in  two  stages.
  228.                First, all of the horizontal mesh lines are used to break up
  229.                the image into "bands".  Since there are the same number  of
  230.  
  231.  
  232.                                        Page 4
  233.  
  234.  
  235.  
  236.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  237.  
  238.  
  239.                bands in each image, the destination  band is warped to  the
  240.                same shape as it's counterpart in  the source image, and  so
  241.                on through all the  bands.  Next,  the destination image  is
  242.                broken up into vertical bands using the vertical mesh lines,
  243.                and the process is repeated for the vertical direction.
  244.  
  245.                The last step in  this process is  to cross-fade the  images
  246.                into one.
  247.  
  248.           CMorph is a full-featured morphing program.  Take a look:
  249.  
  250.                o  Reads and writes GIF,  IMG, TGA, BMP, PCX  and IPI image
  251.                   files.
  252.  
  253.                o  CMorph  has  a  very  beautiful  and  easy-to-use  user-
  254.                   interface that  utilizes  all  256  colors  of the  SVGA
  255.                   palette, and on most video  cards can handle resolutions
  256.                   up to 800x600 (1024x768  mode is only  available on some
  257.                   video cards).
  258.  
  259.                o  A DOS-shell  helps you  with those  unexpected  needs to
  260.                   visit the DOS prompt.
  261.  
  262.                o  You control the  output.  Create  a morph, a  warp, or a
  263.                   simple fade.  Each of  these options utilizes parameters
  264.                   that let you control where in your animation most of the
  265.                   warping and the fading take place for super fine-tuning.
  266.  
  267.                o  An interface for external programs to perform tasks that
  268.                   CMorph doesn't already perform via the IPI file format -
  269.                   - explained later in this document.  This file format is
  270.                   also used in CImage, another of my products.
  271.  
  272.                o  CMorph has advanced spline meshes  giving you the option
  273.                   of three different spline types:   Catmull (used in most
  274.                   morphing software today), Bi-cubic splines, and straight
  275.                   lines.  Different  effects can  be obtained  by changing
  276.                   which spline  type is  used  for the  image  warping and
  277.                   which spline type  is used  for the interpolation.   The
  278.                   Bi-cubic splines make use of  a tightness parameter that
  279.                   allows  you  to  have  spline  meshes  that  are  almost
  280.                   straight to "very curvy".
  281.  
  282.                o  CMorph also has  advanced mesh editing  features such as
  283.                   mirrored cursors,  and cross  cursors for  aligning mesh
  284.                   points between  the two  images.   A Zoom  window tracks
  285.                   your cursor helping you get pixel-perfect output.
  286.  
  287.                o  CMorph uses ALL  available memory  by running  in 32-bit
  288.                   protected mode.  If  you need more memory,  you can turn
  289.                   on the Virtual Memory.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                        Page 5
  296.  
  297.  
  298.  
  299.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  300.  
  301.  
  302.                o  CMorph is complimented  by it's complete  suite of image
  303.                   processing filters.    There are  100  pre-defined, user
  304.                   definable filters.
  305.  
  306.                o  Color   selectable   overlays   and   color   selectable
  307.                   backgrounds allow you to  put your morph  into any scene
  308.                   and add your name to the animation with ease.
  309.  
  310.                o  Complete animation package, including animation compiler
  311.                   and viewer.
  312.  
  313.                o  The registered and Pro versions have these great extra
  314.                   features: -- Automatic FLI/FLC/FLX/FLH/FLT animation
  315.                   generation built-in to CMorph as well as a stand-alone
  316.                   program that has the same capabilities, but is not
  317.                   limited to CMorph's output.  An Image conversion utility
  318.                   that converts to and from BMP, IPI, PCX, GIF, TGA and
  319.                   IMG formats.  And a few extra demos.
  320.  
  321.           System Requirements:
  322.  
  323.                CMorph and it's tools  require at least a  386, and a  video
  324.                card that can  handle 256  colors in  640x400 mode,  640x480
  325.                mode, 800x600 mode, or 1024x768 mode is reccomended.  A math
  326.                co-processor is optional, but  highly recommended (can  mean
  327.                the  difference  between  5  minute  morphs  and  45  minute
  328.                morphs).  4MB of  memory is also  required (although 8MB  is
  329.                better, and any more is just great).
  330.  
  331.           I hope you enjoy using The Complete Morph!
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.                                        Page 6
  359.  
  360.  
  361.  
  362.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  363.  
  364.  
  365.                                  OMBUDSMAN STATEMENT
  366.  
  367.           This program is produced by a member of the Association of
  368.           Shareware Professionals (ASP).  ASP wants to make sure that the
  369.           Shareware principle works for you. If you are unable to resolve a
  370.           Shareware-related problem with an ASP member by contacting the
  371.           member directly, ASP may be able to help. The ASP Ombudsman can
  372.           help you resolve a dispute or problem with an ASP member, but
  373.           does not provide technical support for members' products.  Please
  374.           write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI
  375.           49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via
  376.           CompuServe Mail to ASP Ombudsman 70007,3536.
  377.  
  378.                                DEFINITION OF SHAREWARE
  379.  
  380.           Shareware distribution  gives  users  a chance  to  try  software
  381.           before buying it.  If you try  a Shareware  program and  continue
  382.           using it,  you  are  expected to  register.  Individual  programs
  383.           differ on  details  --  some request  registration  while  others
  384.           require  it,   some  specify   a  maximum   trial  period.   With
  385.           registration, you get anything from the simple right to  continue
  386.           using the software to an updated program with printed manual.
  387.  
  388.           Copyright laws apply to  both Shareware and commercial  software,
  389.           and the copyright holder retains all rights, with a few  specific
  390.           exceptions as stated  below. Shareware  authors are  accomplished
  391.           programmers, just like commercial  authors, and the programs  are
  392.           of comparable quality.  (In both cases,  there are good  programs
  393.           and  bad  ones!)  The  main  difference  is  in  the  method   of
  394.           distribution. The author  specifically grants the  right to  copy
  395.           and distribute the  software, either to  all and sundry  or to  a
  396.           specific  group.  For  example,  some  authors  require   written
  397.           permission  before  a  commercial  disk  vendor  may  copy  their
  398.           Shareware.
  399.  
  400.           Shareware is a distribution method, not  a type of software.  You
  401.           should find  software  that  suits  your  needs  and  pocketbook,
  402.           whether it's commercial or Shareware. The Shareware system  makes
  403.           fitting your needs easier,  because you can  try before you  buy.
  404.           And because the overhead is low,  prices are low also.  Shareware
  405.           has the ultimate  money-back guarantee --  if you  don't use  the
  406.           product, you don't pay for it.
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                                        Page 7
  422.  
  423.  
  424.  
  425.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  426.  
  427.  
  428.                                DISCLAIMER - AGREEMENT
  429.  
  430.           Users of  The  Complete  Morph must  accept  this  disclaimer  of
  431.           warranty:  "The  Complete Morph is  supplied as is.   The  author
  432.           disclaims  all  warranties,  expressed  or  implied,   including,
  433.           without limitation,  the  warranties of  merchantability  and  of
  434.           fitness for  any purpose.  The author  assumes no  liability  for
  435.           damages, direct or consequential, which  may result from the  use
  436.           of The Complete Morph."
  437.  
  438.           The Complete Morph is a "Shareware program" and is provided at no
  439.           charge to the user  for evaluation.  Feel  free to share it  with
  440.           your friends, but please do not  give it away altered or as  part
  441.           of another system.  The  essence of "user-supported" software  is
  442.           to provide personal computer users with quality software  without
  443.           high prices,  and yet  to provide  incentive for  programmers  to
  444.           continue to  develop new  products.   If  you find  this  program
  445.           useful and  find  that  you are  using  The  Complete  Morph  and
  446.           continue to  use  The Complete  Morph  after a  reasonable  trial
  447.           period, you must make a registration payment of 35.00 to Paul  D.
  448.           Nettle.  The 35.00 registration fee will license one copy for use
  449.           on any  one  computer at  any  one time.    You must  treat  this
  450.           software just like a book.  An example is that this software  may
  451.           be used by any number of people and may be freely moved from  one
  452.           computer location to another, so long as there is no  possibility
  453.           of it  being  used at  one  location  while it's  being  used  at
  454.           another.  Just as a book cannot be read by two different  persons
  455.           at the same time.
  456.  
  457.           Commercial users of The Complete Morph must register and pay  for
  458.           their copies of The Complete Morph within 30 days of first use or
  459.           their license  is withdrawn.   Site-License  arrangements may  be
  460.           made by contacting Paul D. Nettle.
  461.  
  462.           Anyone  distributing  The   Complete  Morph  for   any  kind   of
  463.           remuneration must first  contact Paul  D. Nettle  at the  address
  464.           above  for   authorization.      This   authorization   will   be
  465.           automatically granted to distributors recognized by the (ASP)  as
  466.           adhering to its guidelines  for Shareware distributors, and  such
  467.           distributors may begin  offering The  Complete Morph  immediately
  468.           (However Paul  D.  Nettle  must still  be  advised  so  that  the
  469.           distributor can be kept up-to-date with the latest version of The
  470.           Complete Morph.).
  471.  
  472.           You are encouraged to pass a copy of The Complete Morph along  to
  473.           your friends for evaluation.   Please encourage them to  register
  474.           their copy if  they find that  they can use  it.  All  registered
  475.           users will receive a copy of  the latest version of The  Complete
  476.           Morph system.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.                                        Page 8
  485.  
  486.  
  487.  
  488.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  489.  
  490.  
  491.                                    GETTING STARTED
  492.  
  493.  
  494.           CMorph is ready to run.  All you have to do is install it.
  495.  
  496.           Installation is  simple.   Since you've  probably downloaded  the
  497.           CMorph archive and un-archived it (which  you needed to do to  be
  498.           reading this document) you're already set to go.
  499.  
  500.           To run CMorph, you need to  have both, CMORPH.EXE and  DOS4GW.EXE
  501.           in your path or in the current directory when you run it.  To run
  502.           it, just  type CMORPH  followed by  two image  file names.    For
  503.           example:
  504.  
  505.                C:\> CMORPH IMAGE1.TGA IMAGE2.TGA
  506.  
  507.           There are other  command-line options, check  the section  titled
  508.           "COMMAND LINE OPTIONS" for a complete description of them.
  509.  
  510.           If you're like me,  you may already have  a very large path,  and
  511.           wish not to make it larger.   Where there is  a will, there is  a
  512.           way!   Simply  create  a  batch file  that  runs  CMorph  in  the
  513.           following way:
  514.  
  515.           C:\CMORPH\DOS4GW C:\CMORPH\CMORPH %1 %2 %3 %4 %5 %6 %7 %8 %9
  516.  
  517.           This batch file runs DOS/4GW from the CMORPH directory, and tells
  518.           it to  run CMorph  from the  same  directory.   If you  just  run
  519.           CMorph, then it will not find the DOS Extender (which is what  it
  520.           tries to do if you just run CMorph).  So, you need to run the DOS
  521.           Extender manually.
  522.  
  523.           Just place that batch file someplace in your path, and you're all
  524.           set to go!
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.                                        Page 9
  548.  
  549.  
  550.  
  551.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  552.  
  553.  
  554.                         RUNNING CMORPH FROM THE COMMAND LINE
  555.  
  556.           Usage:
  557.                E:\CMORPH\CMORPH.EXE [options] <source> <target>
  558.  
  559.           <source> and <target> are required parameters, <source> being the
  560.           file name for the source image ("morphed from") and <target>
  561.           being the file name for the target image ("morphed to").  These
  562.           files must be in IPI, TGA, BMP, IMG, PCX or GIF format, and they
  563.           must have the same resolution.  The resolution of the output
  564.           images is derived from the resolution of the input images.
  565.  
  566.           All options may be expressed using the slash (/) or the minus (-)
  567.           characters.
  568.  
  569.           [Options] are:
  570.               [-? | -H]       List this help information
  571.  
  572.               [-B[X]]         Batch mode (auto morph on startup) [with auto
  573.                               eXit]
  574.  
  575.               [-C]            Force graphics mode to 16 colors
  576.                                    Default:  256 colors
  577.  
  578.               [-Gxxx]         Force vertical resolution to xxx scanlines
  579.                                Valid values:  400/480/600/768
  580.                                    Default:  auto-detect
  581.  
  582.               [-Mfilename]    Specify mesh filename
  583.  
  584.               [-Sx]           Set mouse sensativity (0=fastest -or-
  585.                               6=slowest)
  586.                                    Default:  4\n" );
  587.  
  588.               source          Source image (IPI/TGA/BMP/IMG/GIF/PCX)
  589.  
  590.               target          Target image (IPI/TGA/BMP/IMG/GIF/PCX)
  591.  
  592.  
  593.           NOTE:     [options] may be specified before, after or between the
  594.                     image names and may be specified by either the '-' or
  595.                     the '/' chars.
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.                                        Page 10
  611.  
  612.  
  613.  
  614.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  615.  
  616.  
  617.                              CONFIGURING CMORPH'S MEMORY
  618.  
  619.                CMorph an all  its related tools  (AnimComp, LAnim, TFlic  -
  620.                registered only,  and Convert  -  registered only)  use  the
  621.                DOS/4GW DOS  Extender  from  Rational  Systems.    This  DOS
  622.                Extender places CMorph into "386 Flat Model" protected  mode
  623.                where the 80386 executes instructions faster, and has access
  624.                to LOTS of larger chunks of  memory.  With access to all  of
  625.                this  memory,  CMorph  can  run  faster,  and  perform  more
  626.                complicated tasks than it would if it were written for a 286
  627.                or less processor.
  628.  
  629.                Lets assume you have 8 MEG.  CMorph loads above the first
  630.                MEG (this is where most systems keep their faster memory).
  631.                As memory is needed, CMorph gets it from the memory above
  632.                that first MEG.  If that runs out, then CMorph starts
  633.                looking for memory in the DOS 640K area.  DOS's memory is
  634.                used last because it is usually slower, and also because
  635.                CMorph can run DOS programs if you shell out to DOS, so you
  636.                will want to save as much DOS memory as possible.  Virtual
  637.                Memory (VMM) is also available (see VIRTUAL MEMORY).
  638.  
  639.                Note that programs that use Extended or Expanded memory
  640.                (like Disk Cache programs) will take memory away from
  641.                CMorph.  You may want to limit the memory that they use to
  642.                allow a comfortable amount for both.
  643.  
  644.  
  645.                                    VIRTUAL MEMORY
  646.  
  647.                CMorph was written with the Watcom C/C++32 9.5 and uses  the
  648.                DOS/4GW DOS Extender from  Rational Systems.  This  royalty-
  649.                free DOS  Extender  (DOS4GW.EXE)  offers  a  Virtual  Memory
  650.                Manager (VMM).  When  CMorph runs out of  memory, it can  be
  651.                configured so that it automatically starts swapping to disk.
  652.                In this  way,  you  can actually  use  more  RAM  than  your
  653.                computer has!
  654.  
  655.                This configuration MUST take place before CMorph is run.  If
  656.                CMorph runs out of memory while running, you must save  what
  657.                your are doing, exit CMorph and configure for VMM before re-
  658.                starting CMorph.
  659.  
  660.                To enable VMM,  you only need  to set  a single  environment
  661.                variable.   Might I  suggest that  you create  a  CMORPH.BAT
  662.                batch file that  sets this variable  before running  CMorph,
  663.                then clears it afterwards  just in case  you're not one  for
  664.                having all these  environment variable  hanging around  when
  665.                they aren't (like me) necessary.
  666.  
  667.                I have found a drawback to using the VMM.  It tends to slows
  668.                CMorph down, even when not swapping to disk.
  669.  
  670.  
  671.  
  672.  
  673.                                        Page 11
  674.  
  675.  
  676.  
  677.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  678.  
  679.  
  680.                To enable VMM with default values, just "SET DOS4GVM=1" from
  681.                within DOS before entering CMorph.  It's that simple.   But,
  682.                like all other things,  there is a way  to complicate it  by
  683.                configuring it (it's not that bad, actually).
  684.  
  685.                Usage:
  686.                   SET DOS4GVM=[option[#value]] [option[#value]]...
  687.  
  688.                (the '#' is used with options that take values since the DOS
  689.                command shell will not accept "=")
  690.  
  691.                Setting the  DOS4GVM=1  will  use  default  values  for  all
  692.                options.  Here are some control options:
  693.  
  694.                MINMEM         The minimum  amount of  RAM managed  by  VMM.
  695.                               The default is 512K
  696.                MAXMEM         The Maximum  amount of  RAM managed  by  VMM.
  697.                               The default is 4MB.
  698.                SWAPMIN        The minimum or initial size of the swap file.
  699.                               If this option is not  used, the size of  the
  700.                               swap  file  is  based  on  VIRTUALSIZE   (see
  701.                               below).
  702.                SWAPINC        The size by which the swap file grows.
  703.                SWAPNAME       The swap  file name.    The default  name  is
  704.                               "DOS4GVM.SWP".  By default the file is in the
  705.                               root directory of the current drive.  Specify
  706.                               the complete path  name if you  want to  keep
  707.                               the swap file on another drive.
  708.                DELETESWAP     Whether the swap file is deleted when  CMorph
  709.                               exits.  By default  the file is NOT  deleted.
  710.                               Program startup is quicker if the file is NOT
  711.                               deleted.
  712.                VIRTUALSIZE    The size of  the virtual  memory space  (swap
  713.                               file plus allocated memory).  The default  is
  714.                               16MB.
  715.  
  716.                If you wish to have a  temporary swap file, and only use  no
  717.                more than 4 MEG of RAM, then use the example below:
  718.  
  719.                   SET DOS4GVM=DELETESWAP maxmem#8192
  720.  
  721.                NOTE:  This DOS Extender is especially advantageous for
  722.                programmers.  I HIGHLY RECOMMEND the Watcom C/C++32 9.5
  723.                compiler to developers.  I own Borland C/C++ 3.1, Microsoft
  724.                C/C++ 7.0, and Watcom C/C++32 9.5.  My choice development
  725.                tools are the Watcom Tools (although I hate to give up the
  726.                Turbo Debugger).  Take the time to learn them, they are
  727.                wonderful!
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.                                        Page 12
  737.  
  738.  
  739.  
  740.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  741.  
  742.  
  743.                                  PROTECTED MODE SWITCHING
  744.  
  745.                The following section is almost exactly as it appears in the
  746.                manual for Watcom C/C++ 32-bit v9.5a.
  747.  
  748.                In almost all cases, CMorph can  detect the type of  machine
  749.                that is  running  and automatically  choose  an  appropriate
  750.                real- to protected-mode switch technique.  For the few cases
  751.                in which this default setting does  not work, I provide  the
  752.                DOS16M DOS environment variable, which overrides the default
  753.                setting.
  754.  
  755.                Change the  switch mode  setting  by issuing  the  following
  756.                command:
  757.  
  758.                   set DOS16M=value
  759.  
  760.                Do not insert a space between DOS16M and the equal sign.   A
  761.                space to the right of the equal sign is optional.
  762.  
  763.                The table  below lists  the machines  and the  settings  you
  764.                would use with them.   Many settings have mnemonics,  listed
  765.                in the column "Alternate Name", that you can use instead  of
  766.                the number.   Settings  that you  must set  with the  DOS16M
  767.                variable have  the notation  "req'd"  in the  first  column.
  768.                Settings you may use are marked "option," and settings  that
  769.                will automatically be set are marked "auto."
  770.  
  771.                                              Alternate
  772.             Status  Machine         Setting  Name         Comment
  773.  
  774.             auto    386/486 w/DPMI  0        None         Automatic if DPMI is active
  775.             req'd   NEC 98-series   1        9801         Must be set for NEC 98-seri
  776.             auto    PS/2            2        None         Set automatically for PS/2
  777.             auto    386/486         3        386, 80386   Set automatically for 386/4
  778.             auto    386             INBOARD  None         386 with Intel Inboard
  779.             req'd   Fujitsu FMR-70  5        None         Must be set for Fujitsu FMR
  780.             auto    386/486 w/VCPI  11       None         Set automatically for VCPI
  781.             req'd   Hitachi B32     14       None         Must be set for Hitachi B32
  782.             req'd   OKI if800       15       None         Must be set for OKI if800
  783.             option  IBM PS/55       16       None         May be needed for some PS/5
  784.  
  785.                The following procedure shows you how to test the switch
  786.                mode setting.
  787.  
  788.                1.   If you have one of the  machines listed below, set  the
  789.                     DOS16M environment variable to the value shown for that
  790.                     machine and specify  a range of  extended memory.   For
  791.                     example, if  your  machine  is  a  NEC  98-series,  set
  792.                     DOS16M=1 @2M-4M.   See  the section,  "Fine Control  of
  793.                     Memory  Usage"   later  in   this  chapter   for   more
  794.                     information about setting the memory range.
  795.  
  796.                               Machine                  Setting
  797.  
  798.  
  799.                                        Page 13
  800.  
  801.  
  802.  
  803.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  804.  
  805.  
  806.                               NEC-98-series            1
  807.                               Fujitsu FMR-60,-70       5
  808.                               Hitachi B32              14
  809.                               OKI if800                15
  810.  
  811.                Before running  CMorph, check  the  switch mode  setting  by
  812.                following this procedure:
  813.  
  814.                2.   Run PMINFO and note the switch setting reported on  the
  815.                     last line of the display.
  816.  
  817.                     If PMINFO runs, the setting is usable on your machine.
  818.  
  819.                3.   If you changed the switch setting, add the new  setting
  820.                     to your CMORPH.BAT file, or your AUTOEXEC.BAT file.
  821.  
  822.                Note:     PMINFO will run successfully on 286 machines.   If
  823.                          CMORPH does not  run, and PMINFO  does, check  the
  824.                          CPU  type  reported  on  the  first  line  of  the
  825.                          display.
  826.  
  827.                               FINE CONTROL OF MEMORY USAGE:
  828.  
  829.                In addition to setting the  switch mode as described  above,
  830.                the DOS16M environment variable enables you to specify which
  831.                portion of extended  memory CMorph will  use.  The  variable
  832.                also allows  you  to instruct  CMorph  to search  for  extra
  833.                memory and use it if it is present.
  834.  
  835.                           SPECIFYING A RANGE OF EXTENDED MEMORY
  836.  
  837.                Normally, you don't need to specify  a range of memory  with
  838.                the DOS16M variable.  You must use the variable, however, in
  839.                the following cases:
  840.  
  841.                     1.   You are running on  a Fujitsu FMR-series, NEC  98-
  842.                          series,  OKI  if800-series,  or  Hitachi  B-series
  843.                          machine.
  844.  
  845.                     2.   You have older programs  that use extended  memory
  846.                          but don't follow one of the standard disciplines.
  847.  
  848.                     3.   You want to  shell out  of CMorph  to use  another
  849.                          program that requires extended memory.
  850.  
  851.                If none of  these conditions applies  to you,  you can  skip
  852.                this section.
  853.  
  854.                The general syntax is:
  855.  
  856.                set DOS16M=[switch_mode][@start_address[-end_address]]
  857.                [:size]
  858.  
  859.  
  860.  
  861.  
  862.                                        Page 14
  863.  
  864.  
  865.  
  866.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  867.  
  868.  
  869.                In the  syntax shown  above, "start_address",  "end_address"
  870.                and "size"  represent numbers,  expressed in  decimal or  in
  871.                hexadecimal (hex requires a 0x prefix).  The number may  end
  872.                with a K to indicate an address or size in kilobytes, or  an
  873.                M to indicate megabytes.  If no suffix is given, the address
  874.                or size is assumed to be in kilobytes.  If both a size and a
  875.                range are specified, the more restrictive interpretation  is
  876.                used.
  877.  
  878.                The most  flexible  strategy  is to  specify  only  a  size.
  879.                However, if you  are running with  other software that  does
  880.                not follow a convention for indicating it's use of  extended
  881.                memory, and these  other programs start  before CMorph,  you
  882.                will need to  calculate the range  of memory  used by  other
  883.                programs and specify a range for CMorph to use.
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.                                        Page 15
  926.  
  927.  
  928.  
  929.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  930.  
  931.  
  932.                                   A NOTE ON THE GUI
  933.  
  934.           A few  things  need  mentioning regarding  the  GUI's  new  radio
  935.           buttons.  There are two uses for the new radio buttons.
  936.  
  937.           First, they are used  to toggle on or  off certain options,  like
  938.           the zoom window (located in the  Preferences menu).  Clicking  on
  939.           this radio button will toggle it up  and down.  If the button  is
  940.           in the up position, then the feature is off, or disabled, and  if
  941.           the button  is  in the  down  position,  the feature  is  on,  or
  942.           enabled.
  943.  
  944.           The second use for  radio buttons is  to choose between  multiple
  945.           settings for a single option.   An example of this is the  cursor
  946.           color.  Selecting a color  will de-select the currently  selected
  947.           color and select the  selected color (lots  of "selects" in  that
  948.           one!)
  949.  
  950.           There are also keys  that allow you  to navigate through  CMorph.
  951.           Pressing F1 will bring up a help window that displays them.  They
  952.           are:
  953.  
  954.                 F1/ALT-H    Gets this help information on-line
  955.                 ALT-A       Show About Box
  956.                 ALT-D       DOS Shell
  957.                 ALT-E       Enter Edit menu
  958.                 ALT-F       Enter File menu
  959.                 ALT-G       Enter Go menu
  960.                 ALT-I       Enter Filters menu
  961.                 ALT-L       Enter the FLICs menu (registered/pro only)
  962.                 ALT-P       Enter Preferences menu
  963.                 ALT-R       Enter Preview menu
  964.                 ALT-S       Start morphing
  965.                 ALT-V       Start a preview
  966.                 ALT-X       Exit to DOS
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                        Page 16
  989.  
  990.  
  991.  
  992.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  993.  
  994.  
  995.                               A FEW NOTES ON THE MOUSE
  996.  
  997.           When the mouse is in the source or the target image windows,  the
  998.           mouse becomes a cross-hair  cursor that spans  both images.   The
  999.           cross-hair has two crosses.   The first is  the cross that  shows
  1000.           where  the  cursor  actually  is,  and  the  second  is  a  less-
  1001.           significant cross in the opposite image.   This cross points  out
  1002.           where in the opposite image where the corresponding pixel is.
  1003.  
  1004.           Also, by placing the cursor within one of the two image  windows,
  1005.           you'll see  a filled  circle.   This  circle follows  the  cursor
  1006.           around and is placed  on the nearest mesh  point.  When the  left
  1007.           mouse button is depressed (unhappy?...NAW!), the cursor  position
  1008.           jumps to where that point is, so it may be relocated.
  1009.  
  1010.           When you have  a menu up,  you may back  up to the  main menu  by
  1011.           pressing the right button or escape.
  1012.  
  1013.           Pressing the  right  button inside  one  of the  two  information
  1014.           windows (located directly below their respective image) will hide
  1015.           the meshes.  And if  you don't bother to  read this in the  docs,
  1016.           then you'll never know this.  See, there actually is an advantage
  1017.           to reading the docs.  (Not like I ever read them, either.)
  1018.  
  1019.           The  last  note  that  needs   mentioning  is  that  in   certain
  1020.           circumstances, you'll be promoted by a message box for a "yes" or
  1021.           a "no" (like  when you exit  CMorph, for example).   When one  of
  1022.           these prompts are up, pressing the left button always means "yes"
  1023.           and the right button always means "no".
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.                                        Page 17
  1052.  
  1053.  
  1054.  
  1055.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1056.  
  1057.  
  1058.                                      THE GO MENU
  1059.  
  1060.           You'll notice that  there are four  categories in  this menu  (in
  1061.           case you haven't done  this yet, you'll need  to take your  mouse
  1062.           and click on the Operations button to get the menu to appear).
  1063.  
  1064.           Go menu category "System":
  1065.                "Leave" button:
  1066.                     Exit to DOS.
  1067.  
  1068.                "DOS Shell" button:
  1069.                     Shell to DOS.  This will run a temporary copy of DOS.
  1070.                     Once you are at in DOS, you may return to CMorph by
  1071.                     typing "EXIT" on the DOS command line.
  1072.  
  1073.                "Go" button:
  1074.                     Start the actual morphing, warping, or fading.
  1075.  
  1076.           Go menu category "Other":
  1077.                "Help" button:
  1078.                     Displays a help window of available keys for navigating
  1079.                     through the menus.
  1080.  
  1081.                "About" button:
  1082.                     Displays an about box with version and copyright
  1083.                     information.
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.                                        Page 18
  1115.  
  1116.  
  1117.  
  1118.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1119.  
  1120.  
  1121.                                   PREFERENCES MENU
  1122.  
  1123.           The Preferences menu allows you to change all of CMorph's
  1124.           preferences and options.  You'll notice that there are six
  1125.           categories in this menu.  They are:
  1126.  
  1127.           Preferences menu category "Spline Settings":
  1128.                Sub menu category "Mesh":
  1129.                     "Catmull", "BiCubic" and "Straight" buttons:
  1130.                          These buttons select the type of spline used
  1131.                          during the mesh warping stage.  Use these
  1132.                          different spline types for different effects.
  1133.  
  1134.                     "Tightness" text box:
  1135.                          Selects the amount of gravity used when drawing
  1136.                          the Bi-cubic mesh lines.  Valid values for this
  1137.                          option can range from 1 (very little gravity;
  1138.                          almost straight lines) to 100 (lots of gravity;
  1139.                          very curvy lines).  This only effects the mesh
  1140.                          warping when the BiCubic mesh type is selected.
  1141.  
  1142.                Sub menu category "Interpolation":
  1143.                     "Catmull", "BiCubic" and "Straight" buttons:
  1144.                          These buttons select the type of spline used
  1145.                          during the interpolation (or resampling) stage.
  1146.                          Use these different spline types for different
  1147.                          effects.
  1148.  
  1149.                     "Tightness" text box:
  1150.                          Selects the amount of gravity used when resampling
  1151.                          the output.  Valid values for this option can
  1152.                          range from 1 (very little gravity; almost straight
  1153.                          lines) to 100 (lots of gravity; very curvy lines).
  1154.  
  1155.           Preferences menu category "Screen Settings":
  1156.                "Display Curves" button:
  1157.                     Toggles the displayed meshes from curves to straight.
  1158.                     This option does not effect the Morphing, just what is
  1159.                     displayed on the screen.  Use this option to speed up
  1160.                     the display when needed.
  1161.  
  1162.                "Zoom" button:
  1163.                     Toggles the zoom window.  When the zoom window is ON,
  1164.                     the display and the cursor can be slow.  Use this
  1165.                     option when you need precise placement of mesh points.
  1166.  
  1167.                "Kwik-screen" button:
  1168.                     Toggles the Kwik-screen option on/off.
  1169.  
  1170.                "Sounds" button:
  1171.                     Toggles the sounds on/off.
  1172.  
  1173.                "Cursor color" buttons:
  1174.  
  1175.  
  1176.  
  1177.                                        Page 19
  1178.  
  1179.  
  1180.  
  1181.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1182.  
  1183.  
  1184.                     Toggles the cursor color from Red, to Green, to Blue to
  1185.                     XOR.
  1186.  
  1187.                "Mesh color" buttons:
  1188.                     Toggles the mesh color from Red, to Green, to Blue to
  1189.                     XOR.
  1190.  
  1191.           Preferences menu category "Output Image Format":
  1192.                "Image Format" buttons:
  1193.                     Select the output image file format.  Available choices
  1194.                     are:  TGA, IPI, IMG, GIF, PCX and BMP.
  1195.  
  1196.                "TGAs Bottom-Up" button:
  1197.                     Enables or disables the TGA files from being written
  1198.                     out in Bottom-up format.
  1199.  
  1200.           Preferences menu category "Operation":
  1201.                "Operation" buttons:
  1202.                     Select the operation to perform.  Available choices
  1203.                     are:  Morph, Warp and Fade.
  1204.  
  1205.                "Fast Morph" button:
  1206.                     Enables or disables a "draft mode" for morphing.  It's
  1207.                     a faster, but lower quality morph.
  1208.  
  1209.           Preferences menu category "Output Configuration":
  1210.                "Fade 50%" text box:
  1211.                     This option will select at what percent of the morph
  1212.                     the fade will reach 50%.  For example, if this option
  1213.                     is set to 10, then at 10% of the morph, the fade will
  1214.                     reach 50%, hence, most of the fading is done early on
  1215.                     in the morph.  Note that this option sets the center of
  1216.                     the fade between the start and end of the selected fade
  1217.                     range (described below).
  1218.  
  1219.                "Fade start %" text box:
  1220.                     This option will select at what percent of the morph
  1221.                     the fade will start.  For example, if this option is
  1222.                     set to 10, then at 10% of the morph, the fade will
  1223.                     begin.
  1224.  
  1225.                "Fade end %" text box:
  1226.                     This option will select at what percent of the morph
  1227.                     the fade will end.  For example, if this option is set
  1228.                     to 90, then at 90% of the morph, the fade will reach
  1229.                     the end.
  1230.  
  1231.                "Warp 50%" text box:
  1232.                     This option will select at what percent of the morph
  1233.                     the warp will reach 50%.  For example, if this option
  1234.                     is set to 10, then at 10% of the morph, the warp will
  1235.                     reach 50%, hence, most of the warping is done early on
  1236.                     in the morph.  Note that this option sets the center of
  1237.  
  1238.  
  1239.  
  1240.                                        Page 20
  1241.  
  1242.  
  1243.  
  1244.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1245.  
  1246.  
  1247.                     the warp between the start and end of the selected warp
  1248.                     range (described below).
  1249.  
  1250.                "Warp start %" text box:
  1251.                     This option will select at what percent of the morph
  1252.                     the warp will start.  For example, if this option is
  1253.                     set to 10, then at 10% of the morph, the warp will
  1254.                     begin.
  1255.  
  1256.                "Warp end %" text box:
  1257.                     This option will select at what percent of the morph
  1258.                     the warp will end.  For example, if this option is set
  1259.                     to 90, then at 90% of the morph, the warp will reach
  1260.                     the end.
  1261.  
  1262.           Preferences menu category "Frame Control":
  1263.                "Total Frames" text box:
  1264.                     This text box simply selects the total number of frames
  1265.                     to create for this morph.  The starting frame and
  1266.                     ending frame are always saved separately.
  1267.  
  1268.                "Start Frame" text box:
  1269.                     This text box simply selects the first frame within the
  1270.                     number of total frames.  If the total frames is set to
  1271.                     30, and the start frame is set to 20 with the end frame
  1272.                     set to 25, then 6 frames (20-25 inclusive) will be
  1273.                     generated.
  1274.  
  1275.                "End Frame" text box:
  1276.                     This text box simply selects the last frame within the
  1277.                     number of total frames.  If the total frames is set to
  1278.                     30, and the start frame is set to 20 with the end frame
  1279.                     set to 25, then 6 frames (20-25 inclusive) will be
  1280.                     generated.
  1281.  
  1282.                "Frame Offset" text box:
  1283.                     This text box simply allows you to select an offset
  1284.                     number to start naming the output filenames.  There is
  1285.                     no correlation between the start, end or total frames
  1286.                     numbers.  This simply changes what the filenames will
  1287.                     be.  This is useful for generating a multi-part
  1288.                     animation.
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.                                        Page 21
  1304.  
  1305.  
  1306.  
  1307.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1308.  
  1309.  
  1310.                                    THE OTHER MENUS
  1311.  
  1312.           I won't bother going through the different buttons in the rest of
  1313.           the menus since they are very  self explanatory, I don't want  to
  1314.           insult  your   intelligence,   and,   basically,   nobody   reads
  1315.           documentation anyway (including myself!)
  1316.  
  1317.           So here's a brief description of each menu:
  1318.  
  1319.                                    THE EDIT MENU:
  1320.           The edit menu  allows you to  swap, copy and  flip the  different
  1321.           meshes and images.
  1322.  
  1323.                                    THE FILE MENU:
  1324.           The file menu allows you to:
  1325.                1.   Load/Save/Import (load v1.20) meshes
  1326.                2.   Load/Save images
  1327.                3.   Set the  base filename.   There  is a  maximum of  five
  1328.                     chars (the last three of the first 8 are used for frame
  1329.                     numbering),  but  you  may  point  to  a  path,   like:
  1330.                     "C:\ANIMS\MORPH" will  place  output  images  into  the
  1331.                     directory ANIMS on drive C:,  and they will start  with
  1332.                     "MORPH",   creating    images    named    MORPH001.TGA,
  1333.                     MORPH002.TGA, etc.
  1334.                4.   Select the  name  of,  and  enable  arithmetic  images.
  1335.                     Arithmetic images  are added  to, subtracted  from,  or
  1336.                     averaged with each  output image  as it  is written  to
  1337.                     disk.  You  may also select  to overlay the  arithmetic
  1338.                     image with a color range.  This color range will select
  1339.                     the range of  color values that,  if the  color in  the
  1340.                     arithmetic image falls  inside that range,  then it  is
  1341.                     directly overlaid on top of the output image.  This  is
  1342.                     useful when you want to add credits to your morph.  The
  1343.                     Background image  is calculated  BEFORE the  arithmetic
  1344.                     image is.
  1345.                5.   Select the  name  of,  and  enable  background  images.
  1346.                     Background images work similar  to the overlay  images,
  1347.                     except that the  color range is  compared with each  of
  1348.                     the output frames,  rather than  the background  image.
  1349.                     If a pixel  in the output  image is  inside the  range,
  1350.                     then it is replaced by  the corresponding pixel in  the
  1351.                     background image.  The background is calculated  BEFORE
  1352.                     the arithmetic image is.
  1353.  
  1354.                                   THE FILTERS MENU:
  1355.           This menu allows you to select a filter file (described later  in
  1356.           this documentation),  and the  appropriate filters  contained  in
  1357.           that file for use on each of the source and target images.
  1358.  
  1359.                                   THE PREVIEW MENU:
  1360.           A preview is  very convenient for  deciding where  to place  mesh
  1361.           points, and  where flaws  may be.   To  preview an  image from  a
  1362.           morph, simply select which image in  the morph you want to  view,
  1363.           (in the form of a % value, 50% for the center image), and  select
  1364.  
  1365.  
  1366.                                        Page 22
  1367.  
  1368.  
  1369.  
  1370.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1371.  
  1372.  
  1373.           the button "Show  Preview".  The  preview will be  viewed in  the
  1374.           current video mode.  When the preview is done, a beep will  sound
  1375.           (assuming you haven't disabled it),  and pressing a mouse  button
  1376.           or any key will return you to CMorph's main menu.
  1377.  
  1378.                                    THE FLICs MENU:
  1379.           This menu is only available from the Registered and PRO versions.
  1380.           FLIC files  are animation  files  that originated  from  AutoDesk
  1381.           Animator.   These  files can  be  played back  by  the  free-ware
  1382.           program AAPLAY.EXE.  This player, however, is limited to the  FLI
  1383.           format only.  To view FLX files, you will need Tempra's animation
  1384.           program (they developed the extensions  from FLC for FLX  files).
  1385.           This software  still cannot  play  the FLH  and  FLT files.    At
  1386.           current, the  FLH and  FLT  files are  the  sole product  of  DTA
  1387.           (Dave's Targa Animator),  DFV (Dave's Flic  Viewer), with  CMorph
  1388.           being the first and only product out (at the time of the  writing
  1389.           of this document) to  support the extra features  of the FLH  and
  1390.           FLT files.  DFV is available today, and can play back all of  the
  1391.           currently supported FLIC files that get generated from CMorph:
  1392.  
  1393.                FLI  320x200 - 256 color
  1394.                FLC  no resolution limit - 256 color
  1395.                FLX  no resolution limit - HiColor
  1396.                FLH  no resolution limit - HiColor (enhanced compression  on
  1397.                first frame)
  1398.                FLT  no resolution limit - True-Color (16.8 million  colors,
  1399.                24-bit)
  1400.  
  1401.           The FLICs menu allows you to select the FLIC type, the FLIC speed
  1402.           (0 = fast, 10 = very slow, 99 = wait a long time between frames),
  1403.           the output FLIC filename, whether the FLIC is color or Monochrome
  1404.           (monochrome is great for first  draft animations, it's very  fast
  1405.           to generate), turn "Ping-Pong" on/off (morph from SOURCE->TARGET-
  1406.           >SOURCE for  auto  repeating  morphs), and  the  FLIC  generation
  1407.           on/off switch.   If the  FLICs are turned  off, no  FLIC will  be
  1408.           generated.
  1409.  
  1410.           If the FLICs are  turned on, then they  will be generated  during
  1411.           the morphing  process in  a second  phase.   If you  have had  an
  1412.           earlier version of CMorph, then you may notice a slight  decrease
  1413.           in speed  during  the morphing  process  when FLICs  are  enabled
  1414.           because CMorph has to  perform color reduction  on each image  it
  1415.           generates before it can add all the images to the FLIC file.
  1416.  
  1417.           This FLIC file will be created in addition to the separate  image
  1418.           files, so make sure to leave plenty of disk space available.
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.                                        Page 23
  1430.  
  1431.  
  1432.  
  1433.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1434.  
  1435.  
  1436.                                    CREATING A MESH
  1437.  
  1438.           Morphing relies on high quality meshes for high quality morphs.
  1439.           So, before you create a mesh, start by examining where you want
  1440.           to place your most important mesh points.
  1441.  
  1442.           Once you have decided where you want your primary mesh points,
  1443.           you can start adding mesh points.  Once all of your primary mesh
  1444.           points have been added, you can add support points to help clean
  1445.           up the morph even more.
  1446.  
  1447.           To add a mesh line, move the mouse to the border of the image
  1448.           that you want to add a mesh line to, and click the right button.
  1449.           To add a horizontal mesh line, click in the left or right side
  1450.           border.  To add a vertical mesh line, click in the top or bottom
  1451.           border.
  1452.  
  1453.           The mesh lines that get added will be placed between the two
  1454.           lines that you were located between when you clicked on the
  1455.           mouse.  Most of the time, straight-through mesh lines cannot be
  1456.           added to the image, so the mesh line is bent at each intersection
  1457.           so that it may maneuver through the maze of mesh points.
  1458.  
  1459.           You may notice that there were actually two mesh lines added, one
  1460.           for each image.  This is because CMorph requires that there be an
  1461.           equal number of mesh lines in each image.  This should be taken
  1462.           into consideration when adding mesh lines.
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.                                        Page 24
  1493.  
  1494.  
  1495.  
  1496.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1497.  
  1498.  
  1499.                              FILTER FILE (FILTERS.TXT) FORMAT
  1500.  
  1501.           The filters are contained in the filter file.
  1502.  
  1503.           The filter description format for a 3x3 filter is as follows:
  1504.                     FILTER NAME <filtername> <size>
  1505.                     <upper-left>  <upper-center>  <upper-right>
  1506.                     <center-left> <center-center> <center-right>
  1507.                     <lower-left>  <lower-center>  <lower-right>
  1508.                     <operator> <operand> <bias>
  1509.  
  1510.                     Any text following semicolons are comments
  1511.  
  1512.           Where <filtername> is  the name  of the  filter.   This is  where
  1513.           CMorph looks for the filter name  (in the filters menu).   <size>
  1514.           is the size of the filter (3,  5 or 7 only, others are  ignored).
  1515.           For 5x5 and 7x7 filters, the  above example is incomplete,  since
  1516.           from <upper-left> to <lower-right> would be a 5x5 or 7x7 "grid".
  1517.  
  1518.           Convolutions are quite simple.  For  each pixel in an image,  the
  1519.           filter grid is overlaid onto that  pixel and it's neighbors  with
  1520.           the <center-center> element of the  filter grid aligned onto  the
  1521.           current pixel in the image, and the outer elements in the  filter
  1522.           grid overlaying the current pixel's neighbors.  The next step  is
  1523.           to  multiply  each   element  in  the   filter  grid  with   it's
  1524.           corresponding overlaid pixel value.   Once all these values  have
  1525.           been calculated, add them together and perform the operation (/ 8
  1526.           for an <operator> of '/' and  an <operand> of '8'.)  Lastly,  add
  1527.           the <bias> value.  If the  addition of <bias> (or subtraction  of
  1528.           <bias> if it is negative) takes the result above 255 or below  0,
  1529.           then the value is clipped to 0 or 255, respectively.
  1530.  
  1531.           A good trick  for trying your  own is to  take a current  filter,
  1532.           copy it, change the new copy's name, and modify it.  If you  have
  1533.           problems getting usable resulting images,  try adding all of  the
  1534.           values in the filter's grid and  placing that value in  <operand>
  1535.           with an <operator> of '/'
  1536.  
  1537.           NOTES:
  1538.                The valid range for <bias> is 0-255.
  1539.  
  1540.                Valid <operator> values are:
  1541.                     +.......Add <operand>
  1542.                     -.......Subtract <operand>
  1543.                     *.......Multiply by <operand>
  1544.                     /.......Divide by <operand>
  1545.                     M.......Sort all multiplied grid elements, and use  the
  1546.                             median. Ignore <operand> -- Operand MUST still
  1547.                             be present
  1548.                     <.......Sort all multiplied grid elements, and use  the
  1549.                             lowest. Ignore <operand> -- Operand MUST still
  1550.                             be present
  1551.  
  1552.  
  1553.  
  1554.  
  1555.                                        Page 25
  1556.  
  1557.  
  1558.  
  1559.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1560.  
  1561.  
  1562.                     >.......Sort all multiplied grid elements, and use  the
  1563.                             highest.  Ignore  <operand>  --  Operand  MUST
  1564.                             still be present
  1565.  
  1566.                CMorph will  search for  the filter  file in  the  following
  1567.                order:
  1568.                     1. The current directory
  1569.                     2. The default  CMorph directory  (where CMORPH.EXE  is
  1570.                     stored)
  1571.  
  1572.                CAUTION:  The  median ('M'),  dilate ('>')  and erode  ('<')
  1573.                functions take a LONG  TIME in 5x5 or  7x7 filters.  Try  to
  1574.                stick with using 3x3 filters for these operators.
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.                                        Page 26
  1619.  
  1620.  
  1621.  
  1622.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1623.  
  1624.  
  1625.                          AnimComp -- The Animation Compiler
  1626.  
  1627.           AnimComp allows you to build monochrome animations from the
  1628.           morphs that you generate from within CMorph.  When you create a
  1629.           morph animation in CMorph, what you're doing is generating a
  1630.           series of animation "cells."  These "cells" need to be compiled
  1631.           into a single file called an "animation file."  The standard
  1632.           extension for this format is ANM.  The ANM files can then be
  1633.           played back with the LAnim program.  LAnim will sequentially jump
  1634.           through each frame in the animation very quickly giving the
  1635.           illusion of movement.
  1636.  
  1637.           This entire process is performed in the DEMO.BAT file.
  1638.  
  1639.           NOTE:  AnimComp is limited to monochrome animations and a
  1640.           resolution of 320x200 only.  This is NOT a limitation of CMorph.
  1641.           CMorph's output images are still full-color.  These same output
  1642.           files can also be used to create full-color any-sized animations
  1643.           if you use a different animation program.
  1644.  
  1645.           For convenience, if you register CMorph.  The registered version
  1646.           of CMorph has automatic creation of all the different FLIC
  1647.           formats.  And even comes with a separate FLIC creation utility
  1648.           called TFlic ("Turbo Flic") that allows you to generating morph
  1649.           FLICs, or you can use it on any other set of images to create
  1650.           dramatic animation effects.  There are other features and
  1651.           programs that are only available in the registered versions, so
  1652.           look near the end of this document for the complete list of
  1653.           registration incentives and options.
  1654.  
  1655.           Another of these animation programs is called DTA (Dave's Targa
  1656.           Animator).  With this program, you can easily create full-color
  1657.           animations from CMorph's output.
  1658.  
  1659.           AnimComp allows you to specify options such as a Difference
  1660.           Minimum and Ping-Pong animations.  The ANM files (like FLIC
  1661.           files) only store the first frame, then the differences between
  1662.           each consecutive frame, keeping the file smaller, and ideal for
  1663.           fast playback (as you will see when running LAnim).  The
  1664.           Difference Minimum is used to specify the difference that must
  1665.           take place before that pixel is stored in the ANM file.  If the
  1666.           difference between two pixels is less than the value specified,
  1667.           the pixel is not stored, and remains.  This will degrade the
  1668.           quality of the animation file generated, but will reduce it's
  1669.           size, in some cases, a great deal.
  1670.  
  1671.           The Ping-Pong Option will tell AnimComp to generate an animation
  1672.           that goes from start to end, then end back (in reverse order) to
  1673.           start.  For morphs, this is ideal for generating an animation
  1674.           that repeats.  Since the end of the animation is the same as the
  1675.           start, the animation won't appear to "jump" back to the
  1676.           beginning.
  1677.  
  1678.           The usage for AnimComp is as follows:
  1679.  
  1680.  
  1681.                                        Page 27
  1682.  
  1683.  
  1684.  
  1685.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1686.  
  1687.  
  1688.  
  1689.           AnimComp [options] <filespec> [outfile]
  1690.  
  1691.           <filespec>  Describes input animation cells to be compiled.
  1692.                       Formats supported are IPI/IMG/GIF/TGA/PCX/BMP, in
  1693.                       320x200 ONLY.  Wild cards allowed. Files are
  1694.                       compiled in alphabetical order (maximum of 100
  1695.                       files).
  1696.  
  1697.           [outfile]   File name of animation file.  Default is
  1698.                       ANIMFILE.ANM
  1699.  
  1700.           [options]   ?|H   Get this help information
  1701.                       P     Generate Ping-Pong animation
  1702.                       Dxx   Difference minimum
  1703.  
  1704.           NOTES:      1. All files MUST be located in the current
  1705.                       directory.
  1706.                       2. THIS PROGRAM WILL ONLY CREATE GRAY SCALE
  1707.                       ANIMATIONS FROM A SERIES OF COLOR IMAGES.
  1708.  
  1709.           To illustrate, please consider the following example:
  1710.  
  1711.           AnimComp -p -d16 morph*.tga morphout.anm
  1712.  
  1713.           In this example, AnimComp will generate MORPHOUT.ANM based on all
  1714.           TGA files that begin with "MORPH" using a difference minimum of
  1715.           4.
  1716.  
  1717.           Also note that all input images for AnimComp are sorted in
  1718.           alphabetical order, before processing begins, and that AnimComp
  1719.           uses the image files' extensions to determine the format of each
  1720.           file.
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.                                        Page 28
  1745.  
  1746.  
  1747.  
  1748.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1749.  
  1750.  
  1751.                             LAnim -- The Animation Player
  1752.  
  1753.           LAnim allows you to play-back the animations that you've created
  1754.           with AnimComp.  LAnim cannot handle any other program's output.
  1755.           This program pair are the only programs that can deal with the
  1756.           animation file format that is used here.  It's my own concoction
  1757.           from years ago.  The idea is to allow you to view your morphs
  1758.           without any extra software.  There is, of course, extra software
  1759.           available in Shareware that will allow you to have complete
  1760.           control over your animations.  One of these being the software
  1761.           that comes with CMorph's registered versions, TFlic (described
  1762.           later in this document).  You're not forced to register if you
  1763.           need this capability.  There is other Shareware out there.
  1764.  
  1765.           Using LAnim is very simple.  Since the animation files don't
  1766.           support a playback speed or repeat count, you'll have to enter
  1767.           this on the command line for LAnim.  The usage for LAnim is as
  1768.           follows:
  1769.  
  1770.           LAnim <animfile> <speed> [<repeat>]
  1771.  
  1772.                <animfile> is animation file you created with AnimComp
  1773.  
  1774.                <speed> is delay between frames (in ms.)
  1775.  
  1776.  
  1777.           For complete animations:
  1778.                [<repeat>] is optional number of times to repeat (1 - 65535)
  1779.  
  1780.           For segmented animations:
  1781.                - if <repeat> is "FIRST", then LAnim will not restore the
  1782.                     graphics mode and will not print the copyright when
  1783.                     completed.
  1784.                - if <repeat> is "NEXT", then LAnim will not set or restore
  1785.                     the graphics mode and will not print the copyright when
  1786.                     completed.
  1787.                - if <repeat> is "LAST", then LAnim will not set the
  1788.                     graphics mode but will restore it and print the
  1789.                     copyright when completed.
  1790.  
  1791.           Also note that LAnim requires that you have enough memory to load
  1792.           the entire animation file into memory at once.  So, look at your
  1793.           animation file size.  If you have that much memory, it should
  1794.           load and run OK.
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.                                        Page 29
  1808.  
  1809.  
  1810.  
  1811.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1812.  
  1813.  
  1814.                         Convert -- The Image Conversion Tool
  1815.  
  1816.           Convert (only available in registered versions of CMorph) is a
  1817.           simple image conversion utility that allows you to convert images
  1818.           from format to format.
  1819.  
  1820.           Convert will read these image file formats:  IPI, IMG, TGA (type
  1821.           2, non-compressed only), GIF, BMP and PCX (256 color and 24-bit
  1822.           only).  These same image formats are supported for writes, except
  1823.           that the image files are always written out in 24-bit color only.
  1824.           The only exception to this is GIF files, since they currently
  1825.           only support 256 colors.
  1826.  
  1827.           Running convert is simpler than copying a file.  Simply type:
  1828.  
  1829.           Convert [infile] [outfile]
  1830.  
  1831.           Convert uses the file extension to determine what format the
  1832.           image file uses.  So <infile> is the filename of the input file
  1833.           that you want converted to <outfile>.  That's all there is to it.
  1834.  
  1835.           Note that if you run Convert with fewer than two parameters, it
  1836.           will automatically prompt you for the missing parameter(s).
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.                                        Page 30
  1871.  
  1872.  
  1873.  
  1874.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1875.  
  1876.  
  1877.                         TurboFlic (TFlic) -- The Flic Builder
  1878.  
  1879.           TurboFlic (only available in registered versions of CMorph) is  a
  1880.           fast FLIC file builder.
  1881.  
  1882.           FLIC files  are animation  files  that originated  from  AutoDesk
  1883.           Animator.   These  files can  be  played back  by  the  free-ware
  1884.           program AAPLAY.EXE.  This player, however, is limited to the  FLI
  1885.           format only.  To view FLX files, you will need Tempra's animation
  1886.           program (they developed the extensions  from FLC for FLX  files).
  1887.           This software  still cannot  play  the FLH  and  FLT files.    At
  1888.           current, the  FLH and  FLT  files are  the  sole product  of  DTA
  1889.           (Dave's Targa Animator),  DFV (Dave's Flic  Viewer), with  CMorph
  1890.           being the first and only product out (at the time of the  writing
  1891.           of this document) to  support the extra features  of the FLH  and
  1892.           FLT files.  DFV is available today, and can play back all of  the
  1893.           currently supported FLIC files that get generated from TFlic:
  1894.  
  1895.                FLI  320x200 - 256 color
  1896.                FLC  no resolution limit - 256 color
  1897.                FLX  no resolution limit - HiColor
  1898.                FLH  no resolution limit - HiColor (enhanced compression  on
  1899.                first frame)
  1900.                FLT  no resolution limit - True-Color (16.8 million  colors,
  1901.                24-bit)
  1902.  
  1903.           TFlic's usage is as follows:
  1904.  
  1905.           TFlic [options] <filespec> [outfile]
  1906.  
  1907.           <filespec>
  1908.                Describes input animation cells to be compiled. Formats
  1909.                supported are IPI, IMG, GIF, TGA, PCX and BMP.  Wild cards
  1910.                are allowed. Files are compiled in alphabetical order
  1911.                (maximum of 3000 files).
  1912.  
  1913.           [outfile]
  1914.                File name of animation file (excluding extension).  The
  1915.                     default is "ANIM."
  1916.  
  1917.           [options]
  1918.                ?|H  - Get this help information
  1919.                M    - Use monochrome animation (great for a quick preview,
  1920.                     only on FLI/FLC).
  1921.                P    - Generate a Ping-Pong animation.
  1922.                S??  - Set FLIC speed, default is 0.
  1923.                FLI  - Make a FLI
  1924.                FLC  - Make a FLC
  1925.                FLX  - Make a FLX
  1926.                FLH  - Make a FLH
  1927.                FLT  - Make a FLT
  1928.  
  1929.           Note that all of the <filespec> files must be located in the
  1930.           current directory.
  1931.  
  1932.  
  1933.                                        Page 31
  1934.  
  1935.  
  1936.  
  1937.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  1938.  
  1939.  
  1940.  
  1941.           Example:  If you have 30 frames to an animation that are named
  1942.           "FRAME000.TGA", "FRAME001.TGA", "FRAME002.TGA", through
  1943.           "FRAME029.TGA" and you want to generate a Ping-Pong FLH file from
  1944.           them called "MORPHED.FLH", then this is what you would type:
  1945.  
  1946.           TFlic -FLH -P FRAME*.TGA MORPHED
  1947.  
  1948.           Lastly, note that the -M parameter will not perform color
  1949.           quantization on the image files, generating a monochrome FLI or
  1950.           FLC file.  This is much faster, but, it's also monochrome.  This
  1951.           feature was meant to be used for quick previews of a morph, or, a
  1952.           'draft' copy, if you will.
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.                                        Page 32
  1997.  
  1998.  
  1999.  
  2000.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  2001.  
  2002.  
  2003.                                    IPI FILE FORMAT
  2004.  
  2005.                The IPI (pronounced "ipee") file format is used to store 24-
  2006.                bit images. This format was designed  to be the simplest  to
  2007.                decode for programmers so that they may add functionality to
  2008.                CMorph  via  external  programs.    This  file  format   was
  2009.                originally designed for use  in CImage (The Complete  Image,
  2010.                another of my products).  If you don't own a copy of  CImage
  2011.                (I won't try to sell you one, I promise), then you will most
  2012.                likely have no use for this file format.
  2013.  
  2014.                The IPI format is as follows:
  2015.                   X resolution (WORD - MSB first)
  2016.                   Y resolution (WORD - MSB first)
  2017.                   Image data:
  2018.                      FOR EACH PIXEL IN THE SCREEN (XRES * YRES)
  2019.                      {
  2020.                         Red Element   (BYTE)
  2021.                         Green Element (BYTE)
  2022.                         Blue Element  (BYTE)
  2023.                      }
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.                                        Page 33
  2060.  
  2061.  
  2062.  
  2063.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  2064.  
  2065.  
  2066.                                  FUTURE ENHANCEMENTS
  2067.  
  2068.           o    Add import/export to meshes from Dmorf
  2069.  
  2070.           o    Add new Nettleman spline
  2071.  
  2072.           o    Add TIFF
  2073.  
  2074.           o    Add sine wave addition to splines
  2075.  
  2076.           o    Add vertical resolution to preferences screen
  2077.  
  2078.           o    Delete mesh lines
  2079.  
  2080.           o    Different sizes for each input file and different size for
  2081.                output files
  2082.  
  2083.           o    Gamma for both images
  2084.  
  2085.           o    ListBox for mesh files and image files
  2086.  
  2087.           o    Morphs of animations
  2088.  
  2089.           o    Move entire mesh lines
  2090.  
  2091.           o    Targa - Compressed versions (and other versions not
  2092.                currently supported)/32-bit
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.                                        Page 34
  2123.  
  2124.  
  2125.  
  2126.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  2127.  
  2128.  
  2129.                              CONTACTING CUSTOMER SUPPORT
  2130.  
  2131.           I'm available in the evenings, I have the standard 9-5 job
  2132.           (eastern time).  If you need to reach me during the day, you can
  2133.           do so by calling and leaving a message.  I call in to my voice
  2134.           mail about three times per day, however, on hectic days, it's not
  2135.           so easy, and I may not get any messages at all until the evening.
  2136.  
  2137.           Tech Support is available for all registered users for one full
  2138.           year following the purchase.  For non-registered users (and
  2139.           registered users over one year), tech support is not officially
  2140.           available.  But if I'm not swamped, I'll try to get back to you.
  2141.           Registered users over one year have priority over non-registered
  2142.           users.  So, please state your status.  It can be verified on
  2143.           computer.
  2144.  
  2145.           To contact me, just call (313) 941-9223.
  2146.  
  2147.           You may also mail your support questions to:
  2148.  
  2149.                Paul D. Nettle
  2150.                9668 Washington St.
  2151.                Romulus, MI  48174
  2152.  
  2153.           Also, don't forget about CompuServe.  My address there is
  2154.           72163,2442, your best chances of reaching me are on CompuServe.
  2155.           I tend to hang out in the GRAPHDEV forum.  This is also where you
  2156.           can be sure to find the latest version of CMorph.
  2157.  
  2158.           My phone number and address are for support, comments,
  2159.           suggestions, questions, registration information, and of course,
  2160.           orders.
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.                                        Page 35
  2186.  
  2187.  
  2188.  
  2189.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  2190.  
  2191.  
  2192.                                 ORDERING INFORMATION
  2193.  
  2194.  
  2195.           What you will get when you register through the author:
  2196.  
  2197.           o    The registered version of CMorph on disk (your choice of
  2198.                disk format -- 1.2M or 1.44M).
  2199.  
  2200.           o    A printed manual.
  2201.  
  2202.           o    The next update of CMorph -- free of charge (Including
  2203.                printed documentation).
  2204.  
  2205.           o    Extra features: -- Automatic FLI/FLC/FLX/FLH/FLT animation
  2206.                generation built-in to CMorph as well as a stand-alone
  2207.                program that has the same capabilities, but is not limited
  2208.                to CMorph's output.  An Image conversion utility that
  2209.                converts to and from BMP, IPI, PCX, GIF, TGA and IMG
  2210.                formats.  And a few extra demos.
  2211.  
  2212.           o    Peace of mind.
  2213.  
  2214.  
  2215.           What you will get when you purchase CMorph Pro! (Commercial)
  2216.  
  2217.           o    The registered version of CMorph on disk (your choice of
  2218.                disk format -- 1.2M or 1.44M).
  2219.  
  2220.           o    A printed manual.
  2221.  
  2222.           o    Extra features: -- Automatic FLI/FLC/FLX/FLH/FLT animation
  2223.                generation built-in to CMorph as well as a stand-alone
  2224.                program that has the same capabilities, but is not limited
  2225.                to CMorph's output.  An Image conversion utility that
  2226.                converts to and from BMP, IPI, PCX, GIF, TGA and IMG
  2227.                formats.  And a few extra demos.
  2228.  
  2229.           o    Peace of mind.
  2230.  
  2231.  
  2232.           Non-registered vs registered users:
  2233.  
  2234.           o    Registered versions don't display the registration notice
  2235.                upon startup of CMorph.
  2236.  
  2237.           o    Registered versions are marked with an "r" after the version
  2238.                number in the title rather than a "u".
  2239.  
  2240.           o    Registered users are allowed free technical support priority
  2241.                via phone, by mail, or e-mail.  Non-registered users are
  2242.                given no official technical support.  (see Contacting
  2243.                Customer Support).
  2244.  
  2245.  
  2246.  
  2247.                                        Page 36
  2248.  
  2249.  
  2250.  
  2251.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  2252.  
  2253.  
  2254.           o    Non-registered users dont get these great extra features: --
  2255.                Automatic FLI/FLC/FLX/FLH/FLT animation generation built-in
  2256.                to CMorph as well as a stand-alone program that has the same
  2257.                capabilities, but is not limited to CMorph's output.  An
  2258.                Image conversion utility that converts to and from BMP, IPI,
  2259.                PCX, GIF, TGA and IMG formats.  And a few extra demos.
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.                                        Page 37
  2311.  
  2312.  
  2313.  
  2314.               The Complete Morph -- Copyright 1993, 1994 Paul D. Nettle
  2315.  
  2316.  
  2317.                                    HOW TO REGISTER
  2318.  
  2319.           How to register with the author:
  2320.                To order a copy of The Complete Morph, just print out the
  2321.                REGISTR.FRM, fill it in, and send it with you check or money
  2322.                order for $38.00 ($35.00 + $3.00 S&H).
  2323.  
  2324.           How to register on-line with CompuServe:
  2325.                To register a copy of The Complete Morph on-line, just log
  2326.                onto CompuServe and "GO SWREG".  Once in the forum, you'll
  2327.                have a short menu.  Select the option labeled "Register
  2328.                Software".  The Registration ID is #1629.  The fee is $38.00
  2329.                (inculdes S&H).
  2330.  
  2331.           Where to purchase CMorph Pro! (Commercial/German Language):
  2332.                Pearl Agency
  2333.                Am Kalischacht 4
  2334.                79426 Buggingen
  2335.                Germany
  2336.  
  2337.                Tel: 07361 360 200
  2338.                Fax: 07361 360 444
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.                                        Page 38
  2373.  
  2374.