Release Notes

• Introduction
• Version
• Downloads
• Requirements
• Main Changes
• Installation
• Usage
• Managed XP
• Own Computer
• Instructions in Brief
• Interface
• Features
• Priority To-Dos
• Some Other To-Dos (Very abbreviated list)
• Known Bugs
• Feedback

Release 4 introduces a number of extra features, usability enhancements and bug fixes. The benefits over previous versions should be apparent quite soon after you start using this program. In particular, I have taken steps to make the user interface more practical based upon my observations of how Dr. Olivier Pascalis used previous versions as well as his own comments.

Most of the underlying morphing code is unchanged from the previous release. the next version is intended to have variations on this code, such as a preview/fast mode and control over how the lines affect the morph (their weights).

This program should work on any platform supporting Jave Runtime Environment version 1.4 or above, but where platform-specific instructions are given a Windows PC is assumed. Other platforms are likely to use similar methods to those stated. Instructions are also available for using the morphing tool on the MacLab computers.

(Still trying to think of a program name)
Release 4
Build 0.4.20031028

The files are now stored in a JAR archive. If you have a version prior to release 3b then you might find it beneficial to delete your previous installation before installing the current version.

Main program (391KB, ZIP archive containing JAR file)

This program requires a computer with Java Virtual Machine version 1.4 or higher installed. Due to the amount of graphics and computation involved it is preferable to be using a fast computer with a fair amount of free memory. Note that when rendering the computer may appear to freeze for several minutes. This is normal.

• Numerous bug fixes, including lines outside image and blank render on featureless image
• Select mode added - now lines can be selected on Macs and other computers with only one mouse button
• Selection tools in the Edit menu
• New Features menu (previously Edit menu) with mode submenu
• Default lines colours changed
• Line colours can be customised
• Contrast drawing mode to make lines stand out from their background
• About menu option
• Spawned windows are now modal dialogue boxes
• Render window has returned to a single render option, render mode can be chosen from the menus
• Subtle efficiency improvements caused by 'black render on featureless image' bug fix
• Image background colour defaults to white
• Lines can be displayed on the rendered image
• Better suppression of console messages
• Menu bars integrates into the unified Mac menu bar
• Mouse goes busy while rendering
• Mouse pointer responds to image boundaries
• Program quits correctly
• Image A and B labelled correctly

To use this software you must have Java 1.4+ installed. You may already have this. If you are able to install software on your computer then you can download the latest version of Java from http://java.com - look for the download of the Java Runtime Environment (JRE) or Java Virtual Machine (JVM). This should exist on Managed XP systems.

To install the morphing program:

1. Download the main program (a ZIP file)
2. Unzip the file to a memorable location, e.g. U:\morphing\

You can safely install the current version over any previous version, although you may first want to delete old files to reduce clutter and confusion.

1. First load the application menus using the Start menu.
2. Once the menu becomes available select Start/Applications/CIS/JRE 1.4.2. If this is the first time this program has been run on your computer then you may have to wait several minutes while it is distributed.
3. Continue with the instructions below.

To start the program on almost any Java platform go to (program location) and load the start.jar file.

Failing that:

If for some reason this doesn't work, rename the start.jar file as start.zip and decompress its contents to (program location). Now try and run (program location)/Morpher1.class. You can typically do this by opening a command prompt (on a Windows PC click Run on the Start menu or look for a reference to Command Prompt or MS DOS in the program menus) and typing:

cd "(program location)\"
(driveletter): (if the prompt doesn't change to the program location)
java Morpher1 silent

The initial program window should pop up after a couple of seconds.

See the separate instructions.

The interface consists of a window with three images, labelled Image A, Image B and Zoom. Morphs are created between the first two, and the zoom image is an aid to picking out the points to morph. Images can be scaled by dragging the scale slider or (for Image A and Zoom) by dragging the dividers between the images.

If you wish to change the default images then go to the project menu and select the load option for the image you want to replace.

By default Draw mode is enabled. This allows you to draw features on the images. You can draw on either image, but you will probably find it easier to work with the larger one. To draw a line you can either click at the start point and then click at the end point, or you can 'drag' a line from the start to the end. When you draw a line on one image it will be mirrored on the other.

For precision control, use the zoom image to see exactly where the mouse cursor is. At the bottom right the co-ordinates of the mouse within the image are shown, along with a sample of the colour under the cursor and it's component values (red, green and blue, with each on a scale of 0-255).

You can click the Edit button to switch to line editing mode. The line nearest the mouse pointer will be highlighted in red on all images. When the mouse is near either end of a line a circle will appear. This means that the point can be dragged by holding the left mouse button down, moving it, and then releasing at the new position. Only the line on the current image (and zoom) is actually moved.

Lines can be selected by right-clicking when the desired line is highlighted, or simply by left-clicking when in selection mode. The line will change colour. Repeating this deselects the current line. You can select all lines using a third mouse button/wheel. Selected lines can be deleted by clicking the button marked delete.

A good way to edit images is to draw lines on one image, swap the images, and then move the lines to corresponding points on the second image. You can swap the images by clicking the swap button.

To generate the morph click the Render button. A new window will pop up. In this you can select how far between each image you want the morphed image to be, generate the image, and save a copy. To generate the morph click Render. You can also use the menus to generate warps (distortions of the source images). To save click Save Image and enter the name of a JPEG file. If you don't specify a standard extension then .jpg will be appended to the filename.

Note that morphing is a computationally intensive process, and it may take a few minutes for the image to appear after you click Render. The rendering time is roughly proportional to the number of lines, the width and the height of the image. Certain warps and morphs may be cached. This will reduce rendering time for some images. To cross-blend the two images don't place any lines and then render as normal.

The lines you draw should mark out identical features on both images. You can think of each line as having a 'field of influence' so that points near a line will move with it. The area between two lines that move towards one another will be squashed and the area between two lines that move apart will be stretched - of course, as lines rotate they can move both towards and away from each other. You may need to experiment to decide how many lines to place and where to put them, but note that the rendering time is proportional to the number of lines on the image. You might want to use lines to trace contours, e.g. around the eyes, or more generally to set image ratios, e.g. a line connecting the centre of the two eyes.

Take care not to cross lines or make them rotate excesively (check that the line is oriented the same way as the corresponding line on the other image by checking that corresponding points are circled). Generally it is best to keep contour lines close but not touching, although the best way to get a feel for the technique is to experiment.

The nature of the feature-based distortions means that parts of the image beyond its bounds may be requested. These are taken as black points. As a result the useable part of the morphed image may well be less that that of the two input images. The best way to deal with this is to put in images larger than the desired resultant and then crop the final morphed image. If you wish to minimise these effects then try drawing a frame of lines around the boundaries of the images. (Keep the lines the same on each image). This will give the edges of the images a degree of 'stickiness', but will also affect the rest of the image. For a stronger effect you can double or triple frame the borders.

• Note that many aspects of the User Interface are likely to change and these instructions may have little bearing on future releases.

• Bug fixes
• Image-feature loading/saving
• Batch processing for consecutive frames
• Weight parameter control
• Memory for settings
• Morph enhancements, including improved speed, preview option and time estimation

• Background colour selection
• Targeted and experimental enhancements following feedback
• Implement the menu bar as a Dockable
• Reorganise menus for greater Mac integration
• Enable web applet functionality

• Under certain circumstances lines can be drawn outside the image being edited, and lines released outside this area may snap to unexpected positions.
• Toolbars cannot be detached as this may cause a NullPointerException. Until this is resolved the context menus are also disabled, but dragging is not.
• Cursor on Zoom panel may be slightly out from the actual mouse cursor's location.
• Leftmost image may resize in a jump on first mouseover.
• Colour indicator looks incorrect on Mac

I am keen to hear any feedback you have. Please contact me with any comments.