UV Imaginator Relase Notes
==========================

WARNING - This is still currently an Alpha release. Please make sure you have saved your 
work before using this plugin.

Release: Version 1.0 Alpha 2 [1st July 2001]

Introduction
============

The "UV Imaginator" plugin for Lightwave 6.5b is designed to allow you to generate an image 
directly from a VMap in Modeler and save it to disk in one of the image formats supported by 
Lightwave. The current implementation works with UV Texture Maps only (hence the name UV 
Imaginator), but may be expanded to include other map types in future.


Installation
============

Ensure that modeler is not running. If you downloaded the ZIP file simply extract the 
uvimaginator.p file into the [Lightwave Root]\Programs\Plugins\Model. Or simply download the 
uvimaginator.p file into that directory. If you are upgrading then you dont need to do this 
next step. Then open modeler, and goto the "Modeler" -> "Plug-ins" -> "Add Plug-ins ..." 
menu option. Then find the uvimaginator.p file in the same directory as before. And double 
click on it. Then click on the "Done" button.


How to use it?
==============

Well the plugin is a "command sequence" class plugin for those that are interested. It 
allows you to choose any VMap currently available (whose type is a UV Texture Map). It will 
then work with the current object to produce an image that will be saved to disk. The image 
will contain all the mapped polygons from the object drawn as outlines of their VMap 
polygons. The default representation for which is white outlines on a black surface, with 
optional red points placed for each vertices on a polygon. At the moment it is possible for 
vertices to be drawn over by following outlines being drawn. You can change the colours to 
what ever you like using the three colour pickers, one each for the background, foreground 
and vertices colour.

You can select the size of the resulting image by altering the resolution value which is the 
height/width of the image. All calculation of the VMap are done sing floating point values 
and truncated to integers at the last possible moment to increase accuracy. It is advisable 
to use a large resolution for obvious reasons.

You can choose both the type and name of the image file to be created. The default location 
for the file to be saved if you dont choose a directory using the "Save as" button, is in 
the Modelers current image directory. Any of the lightwave image types are supported. I am 
not sure as to the state of plugin image savers, whether they will appear or not (as I dont 
have any I cant test this, feedback on this would be useful).

Currently the plugin is accesible by default from the "Construct" tab under the "Additional" 
menu. It doesnt appear to want to be a button in the sidebar, but this turns out to be a 
restriction in the current SDK.


Things worth mentioning
=======================

As pointed out in the main documentation the list of VMaps shown is that of all objects 
loaded (if this became a problem they could be filtered if necessary but I believe the 
overhead to be quite large). Currently the list will be all UV Texture Maps from loaded 
objects. If you select a UV map that is not used by the current object you will.

Also if there are no UV Maps currently loaded with any object then the plugin will fail to 
startup with an appropriate error message. I would like to disable the plugin in the menu 
but I cannot as this is controlled by Modeler.


Reporting Problems
==================

If you have a problem installing the Plugin or while using it. Please send an email to 
ascerriuk@yahoo.co.uk . As well as your description of the problem, please include the 
following information :-

	Lightwave Version
	Plugin Version
	Operating System
	CPU
	Memory


Releases
========

Current Release : Version 1.0 Alpha 2 [1st July 2001]

This release is a quick patch to correct a known bug and add some simple functions :-

Features:
Slight modification of GUI, moved image type down a bit.
You can now select background, foreground and vertices colours.
Also modified the drawing routines used for plotting the lines. Because everything is done 
as floating point numbers from 0 to 1, there was an error in precision when generating high 
res images.

Fixes:
File name when clicking on the "Save as" button is the same as in the filename box.

Known Problems:
Currently no known problems. 


Next Intended Release : Version 1.0 Alpha 3

These are the planned features for the next release, some depend on the kind of feedback I 
get from users. :-

Features:
Added support for weight and morph maps (if feasible/possible/wanted).
Vertices will not get obscured by other polygon edges being drawn over them.
Removal of most memory/resource leaks (time permitting)
Possible improvement to filter list of UV Maps (depending on feedback from users)
Possible improvement to allow selection of any object available (depending on feedback from 
users), and generate multiple files without closing plugin
Changing of default name for UV image to that of the UV maps name.
Place the generated image as the backdrop for the UV Map (I believe this is possible?!?!)
Might need to keep the selected colours for background, foreground and vertices.

Known Problems:
Wait and see


Previous Release : Version 1.0 Alpha 1 [30th June 2001]

This is the first release and handles the following functionality :-

Features:
Select of UV Texture Map only
Selectable image size
Selectable image format
Generated image supports marking of vertices as well

Known Problems:
If you edit the filename manualy or change image type, then click on "Choose file" it will 
display the old filename. The solution is to choose your filename first and then select the 
image type.
Although memory/resource leaks are bound to occur and need catching and tidying up


Copyright © 2001 Antony Scerri