__________________
UV Torus Suite 1.1

UV Torus Suite is a GUI python script that generates three  types
of tori with UV coordinates  and  vertex  colors. It can create a
standard torus (just like SurfDonut)  and  two  variations  (just
like those included with  LightFlow).   It  allows  the  user  to
specify the U/V resolution and a major/minor radius.  For the two
variations, a loop and loop radius can also be specified.

In order to be more consistent  with  Blender's  user  interface,
this script is  designed to be used with hotkeys! (Besides, there
is a bug in the Blender.Draw module of version 2.04 that prevents
toggle buttons from  working properly.) The following hotkeys are
available:

   Hotkey     What it does
   ------     ------------
   1KEY       Create a standard torus
   2KEY       Create a LightFlow torus #1 (mesh1.py)
   3KEY       Create a LightFlow torus #1 (bspline1.py)

   SKEY       Toggle generation of smooth faces
   UKEY       Toggle generation of UV coordinates
   VKEY       Toggle generation of vertex colors

   PAD_PLUS   Increase U and V resolution by 10
   PAD_MINUS  Decrease U and V resolution by 10
   PAD_STAR   Adjusts the V resolution in such a way that the
              generated faces are square rather than rectangular.
   QKEY       Exit script

Remember that these hotkeys work only if the  script  is  running
and the TextWindow is active.

________
Features

This script has some distinguishing features. One is that  it  is
fully interactive. This means  that as soon as a hotkey or button
is pressed, the mesh is generated instantly, without the need  to
press enter or click  on  an  "OK"  button. As an example, if you
need to increase the resolution of your torus, press PAD_PLUS and
the resulting mesh  is instantly regenerated and displayed in the
3Dwindow.

The second feature is that it creates an object named "UV  Torus"
and links it to a mesh (the object data) with the same name. This
makes it a little easier to select your  torus  in  the  OOPS  or
DataView windows.

______________
Quick Tutorial

The fastest way to  add  a  torus  with  smooth  faces   and   UV
coordinates to your scene is to activate the TextWindow and press
a|p 1KEY SKEY UKEY.  Now you can change the resolution  or  radii
and get immediate feedback. You can select a different torus type
from the drop down menu or by pressing a  hotkey.   Remember  the
loop and loop  radius  slider  buttons only work on the LightFlow
torus types.

Let's see how the UV coordinates are working. Press  F9  and  the
"sticky" option should be  highlighted in white. Now press F5 and
select the material called "Checker." Make sure  that  the  stick
option is also selected here.  Now you can render and see a torus
with an image map wrapped around it  perfectly.   If  you  select
another torus type  or  experiment with the other parameters, you
have to reselect the "Checker" material again.

As a final step, press  *  (on  the  keypad)  to  adjust  the   V
resolution in such a  way that the generated faces will be square
rather than long and thin rectangles. This feature is similar  to
Blender's "Beauty" button.

Send comments, suggestions, and bug reports to:
Anthony D'Agostino
scorpius@compuserve.com

October 20, 2000 - First release
January 22, 2002 - Fixed vertex color bug.