@Remark $VER: Tutorial_guide 4.4 (23.2.97)

MPMorph Tutorial
****************

This is a (hopefully) easy to follow tutorial introduction to using MPMorph.

This tutorial assumes you have correctly installed all the software (either using Installer or as described in the Installation part of the documentation).

Use the DOIT button to demonstrate the required action. Use the Browse > button to go to the next step.

Or - Select @{"DEMO" RX "Tutorial/Tutorial.rexx ALL"} to run a demo.

Then go to Viewing to see the output.

First update some of the settings
*********************************

  * Run the MPRender-prefs program.

     @{"DOIT" RX "Tutorial/Tutorial.rexx a1"}.

  * Change the ARexx Script Pre to MPMorph:Rexx/PreAll.MPM (This ensures that the first and last frames are converted to the relevant format).

     @{"DOIT" RX "Tutorial/Tutorial.rexx a2"}.

  * Change the output format to BW16 (to render 16 grey scale images).

     @{"DOIT" RX "Tutorial/Tutorial.rexx a3"}.

  * Now click Save to save the settings.

     @{"DOIT" RX "Tutorial/Tutorial.rexx a4"}.

Now set up some points
**********************

  * Run the MPMorph program.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b1"}.

  * Click the gadget to the right of the first string gadget and choose the file Tutorial/cat.pic. This is the first frame to render.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b2"}.

  * Click the gadget to the right of the second string gadget and choose the file Tutorial/girl.pic. This is the last frame to render.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b3"}.

  * Change the Frames to 3. This means that a total of 5 frames (including the first and last) will be output, the first frame 0 and the last frame 4.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b4"}.

  * In the bottom string gadget enter directory/pic.%03ld (where directory is a directory of your choice). This means that the images will be rendered as directory/pic.000 to directory/pic.004.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b6"}.

  * Now click Edit Points to edit the control points.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b7"}.

  * Try playing around with the editing modes. Everything should be fairly self explanatory.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b8"}.

  * When you are happy and have at least 3 points left, select Save from the menu and save to the file name of your choice.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b9"}.

  * Now select Quit from the menu to quit.

     @{"DOIT" RX "Tutorial/Tutorial.rexx b10"}.

Rendering the output
********************

  * Run the MPRender program.

  * From the file requester choose the file you saved above.

  * Wait whilst the images are rendered.

     @{"DOIT" RX "Tutorial/Tutorial.rexx c1"}.

Viewing the output
******************

  * You should now have 5 files named directory/pic.000 to directory/pic.004.

  * These images can be viewed individually or built into an animation using e.g. DPaint.

     View images:

       * @{"0" link "ram:pic.000/main"}

       * @{"1" link "ram:pic.001/main"}

       * @{"2" link "ram:pic.002/main"}

       * @{"3" link "ram:pic.003/main"}

       * @{"4" link "ram:pic.004/main"}

Going further
*************

  * If you got this far then to go any further you need to read the docs.