Edit3D 89

EDIT 3D

                      - Version Beta 0.96 -

                                                       2003 by David COZ

                                    http://membres.lycos.fr/dcoz
                                            coz.hubert@infonie.fr

Contents :

    I     . Some Notes...
   II    . What is Edit 3D ?
   III   . Features of this version
   IV   . Controls
   V    . To Begin
   VI   . Hints
   VII . Explanations on the Display Modes
   VIII.   How to put textures...
   IX   . About "Options" in SW
    X    .   Converting ships for Space Dementia...
   XI   .   Thanks To

I . Some Notes...

The Source of the Program is in the ZIP,but it is quite messy and you won't understand it if you have no knowledges in 3D Programming...
That's why I begin to write a set of tutorials on 3D Programming,the three first one, "Tutorial on 3D Programming I->III" are avaible at ticalc.org ....

Also,you can download examples made by users at ticalc.org ti89/ASM/graphic/edit3D users examples...

Since v 0.90,you can put,on each polygon,a texture (.TXTR ), you made with TEXTURE MAKER (avaible at ticalc.org/ti89/asm/graphic)... Open the file "Dice" or 'viper' and enable textures to have a glimpse of what you can do...

See "VIII.How to put textures..." for explanations.

See "Historic.txt" to know exactly what is new in this version...

Beware,the auto-archiving can lead to crashes !
For the users with AMS 1.xx,I suggest to let this option off,as you don't really need it.It was made especillay for AMS 2.xx , even if it crashes , your files will be saved.

The zip contains two programs : 'edit3d' and 'ed3dlib'...
'edit3d' is just the launcher, 'ed3dlib' is the compressed program (a great option in TIGCC :)...

This zip contains some examples.To open them,run the program , press 'F1' , 'Open' and enter the name of the example you want to see...

Anyway,I suggest you to archive your important files before running it. Also, the program need about 80 KB of free memory : 50 KB for decompressing and 30 KB for running.

What you MUSTN'T DO :

* Rename the 'ed3dlib' program (the launcher won't find it).

II.What is Edit3D?

Edit3D is a powerful editor,yet simple to use,that allows you to create quite sophisticated 3D Objects,from the simple cube up to the Formula One with more 300 triangles (see example).The program is divided in two parts: the Edit Zone,where you draw your object,enter its depth ... and the 3D Display Zone when you can see the Object you create in Real Time 3D,you can turn it,make it back and forth... You can display your object in wire-frame (fast),or in a solid form (no hidden surfaces),with the ability of using the Z-BUFFER technic and Textured Mode for a better display ! Note that you can put on each polygon a specific texture,you made with TEXTURE MAKER (avaible at ticalc.org/ti89/asm/graphic) ...
You can also see your Object in a Subjective view , as in Doom-Like Games ! Since v 0.95 you can convert your object (3DX) into ships useable by Space Dementia , go to this section to learn more ...
All the stuff can be archived.

III.Features of this version:

NEW ! Convert your objects into Ships useable by Space Dementia ... Go there to know more.

NEW ! You can put on each polygon a specific texture,you made with TEXTURE MAKER (avaible at ticalc.org/ti89/asm/graphic)...
(see VIII.How to put textures...)

NEW ! Option to enable/disable the auto archiving
(see IX .Options in sw)

* Use the program while it is archived.
* Draw Rectangle,Ellipse,Lines;
* Modify an Object Coordinates (also modify the object center);
* Color an object in Black or White;
* Display or not the border of an object;
* Save,open a 3DX File (File can be archived automatically);
* Enter the Depth of an Object;
* Delete,Translate,Rotate,Zoom an Object or All;
* Transform a Shape into a Cone (Pyramide...);
* See your Objects in Front,Top or Side View;
* Display your Object in wire-frame or solid mode (with clipping);
* You can adjust the Speed in all the display modes.
* Many Options avaible (perspective,distorsion...)
* Precise Rotation around the three Axis (X,Y,Z)..
* In 3D Mode,'ALPHA' performs the automatic rotation.
* Z-Buffer Mode enabled by pressing 'APPS' in Solid Mode.
* You can enter texture Mode !
Press APPS to enable 'Z-BUFFER',then 'MODE'

IV.Controls:

When Editing:

* Arrows     : Move the cursor to draw lines,ellipse....
                       Choose between the Objects when it's needed;

* Diamond : When it's hold,the cursor moves pixel by pixel;

* Enter        : Confirm a draw,an input...

* ESC          : Cancel a draw,an input...

In 3D Mode : ( It's becoming a mess :)

* Arrows           :   Turn your object around X and Y Axis;

* F1/F2             :   Turn your object around Z Axis;
(F2/F6 for ti92+/V200)

* 2nd : Move your Object away;
(F1 for ti92+/V200)

* Diamond : Bring your Object Closer;
(F5 for ti92+/V200)

* - (Minus)         :   More Precise Rotaion (Slow down);

* + (Plus)           :    Less Precise Rotation(Speed up);

* Shift                :    In Solid Mode only,invert the colours...
(2nd for ti92+/V200)

* Esc                  :    Show the Frame Rate,then return to the Edit Mode;

* Alpha             :    Enable/Diable the automatic Rotation...
(Hand for ti92+/V200)

* X,Y,Z              :    Object in Front,Top and Side view...

* APPS              :    Enable the Z-Buffer Mode in Solid Mode...

* Mode             :    If Z-Buffer is enabled,enable the 'Textured Mode'...

* CATALOG  (Clear   for ti92+/V200) :
When textures are enabled,allow you to put texture you made with TEXTURE MAKER (avaible at ticalc.org/ti89/asm/graphic) ...(see VIII.How to put textures...)

* ( and   )         :
Choose a polygon when the polygon selection is enabled.
( i.e. APPS -> Mode -> Catalog...)

V.To Begin :

Tape edti3d() in the home screen.
As an example , select 'Rectangle' (F2) tool and draw a rectangle on the form.Display it 'Wire-Frame' or 'Solid' Mode(F5) , turn it with the arrows,you can see the display is too fast , it's hard to see something . To correct this,play with the button '-' and '+' to adjust the speed .
Well , at first your object is flat . Return to the Edit Zone (ESC then Enter) and select 'Depth' (F3) . Press Enter to select your object an Enter the min and max Depths (in pixels) of your rectangle (ex: min:0 and max:50) .

Now display it,you can see it becomes a 3d object .
You can display it in the Solid mode (F5 then 3 or F5 then 4).
Now,you can see , your object in a realistic display .
You can invert the color by pressing ' - ' .
This is a begin , you can draw ellipses and lines too .
By using the different view , you can create quite sophisticted 3D Objects,as the Tank or the F1 given with the ZIP .
Analyse the examples given in the zip , it will help you making more complex 3d Objects ...

Note : If you think you created a good object,you can send it to me , I'll add it in "edit3d Users examples",at ticalc.org...

VI.Hints :

   * Save your file often, in order to go back when you want...

*   In 'Solid' display Mode , you can avoid some display bugs by dividing a big object into smaller ones...

*   Some display bugs occur with ellipses in 'Solid & BFC' mode ,
      they are not here in 'Solid & no BFC' mode.

*   To get a best display , use the Z-Buffer Mode,by pressing APPS...
      The best results (in quality) are obtained with
      Solid & no BFC and Z-Buffer enabled...

* If you color an object in black , it's often nicer to draw
     it 'without Border'.

VII.Explanations on the Display Modes:

*'Wire-Frame' :

Display in Wire Frame,only the lines between the points are drawn , the fastest mode.

*'First Person' :

Display in Wire Frame.You see the object as if you were in Doom-Like Games.

*'Solid & no BFC' :

Display with no Hidden Surfaces.You can now go over the Screen Limits.

*'Solid & BFC' :

Display with no Hidden Surfaces . You can now go over the Screen Limits . The Display is faster than the previous mode because of the use of the BFC technic(BackFace Culling) . However , the BFC make some display errors,especially with ellipses...

*'Z-Buffer' Mode :

This an advanced technic used in many 3D Games...
Instead of only testing a whole polygon depth , the Z-Buffer technic tests the depth of each pixels drawn on the screen ... The Z-Buffer is a buffer of 16KB , so if you haven't 16KB of free RAM,you can't run this mode ... The display is of course slower,but the quality better ...
For the moment(v0.81),it works good but some lines could be drawn not entirely...
To see what it changes,have a look at 'test' example ... display it without Z-Buffer , then with (APPS) , you should see the difference ...

* Textured Mode :

In this mode textures can be wrapped on each polygon . This technic also use the Z-BUFFER , so the display is quite good too ... Note that the less is the 'Distorsion' option , the more the texture appeared deformed...
I thought implement this would be slow,but the frame rate stays correct...
I made a prog to edit textures : TEXTURE MAKER,avaible at ticalc.org/ti89/asm/graphic
(see VIII.How to put textures...)

VIII.How to put textures...

First you must have edited a texture with TEXTURE MAKER (avaible at ticalc.org/ti89/asm/graphic) and it must be in the same directory as Solidworks ! Then display your object in 'Solid Mode'.Press 'APPS' then 'MODE' to enter the 'textured' mode , then press 'Catalog' to choose the face you want.Press '(' and ')' to change the face , you are still able to turn your object normally with the arrows .
When you select what you want,press ENTER . A dialog box appears . Enter the name of the texture you want to wrap on this face.You can also set a 'Shift Points' parameter . What is it ?
Well , imagine you created a texture like that :

1 p p p 2
      p
      p
4          3

where 'P' are the texture pixels set and 1,2,3,4 the 'Save Points' of your texture (see 'Texture Maker') .
Now if you set 'Shift Point' to 1 , the texture will be drawn like this :

4        p 1
   p p p
         p
3            2

All the 'Save Points' have been shifted by one place . This is useful and
faster than returning in 'Texture Maker' to re-enter the SavePoints correctly . This 'shift value' will be saved with your '3dx' file,of course :-)

So if your texture is wrapped weirdly , try to modifiate the 'shift points' parameter .

A last thing , if you put a texture on a face and want to withdraw it , select the face and enter "0" (the number) as a texture name .

IX . About Options in Edit3D.

By pressing F1 , 'Options' you can change some options , here is a little description of them :

* Perspective :

(ON/OFF) Enable or not the perspective distorsion .
ON : object far from you will apper smaller (realistic)
OFF: all objects are treated as if they were as the same distance from you . (this is what you have in TI '3D' Graph' mode.)

* Distorsion :

(Number) Set the perspective distorsion (or FOV)
More : Object will be less deformed when coming near from you.

* Show Grid :

(ON/OFF) Show or not the Edit Grid . Can be useful to disable , if you want to see your object better.

* Z-Buffer :

(ON/OFF) If ON just active the Z-Buffer automatically in 'Solid' Display.

* Center :

USER The object center will be the one defined in 'F3' Modify center' (if defined) Use this if you want your object to move in circles
DEFAULT The program will calculate your object center .

* Auto-Archive :

(ON/OFF) If set , whenever you 'leave' a file (i.e. when quitting , opening another one or beginning a new one) this file will be archived.

BEWARE ,the auto-archiving can lead to crashes !
For the users with AMS 1.xx , I suggest to let this option off , as you don't really need it . It was made especillay for AMS 2.xx , even if it crashes , your files will be saved.

X. Converting ships for Space Dementia...:

Since the 0.95 version , you can convert your objects ( 3DX files ) into 'SHIP' files useable by 'Space Dementia' . Space Dementia is a 3D action game where you " have to avoid the asteroids while trying to destroy a maximum of them with your weapons "

You can get Space Dementia for Ti89 , Ti92+ at ticalc.org or at Tibault Chevalier's website :
www.moitib.fr.st

When you download 'Space Dementia' you will get a readme who explain how to create your own ship and then play with it .

XI.Thanks To :

_ Alexandre DOMANGE <mrtrampo@hotmail.com> and
Ernest Carpenter <ernest.carpenter@mhs7.tns.co.za> for sending
me a Ti 92 Plus ROM !

_ Benjamin Hunees for sending me Ti-ROM ...

_ Greg Wrobel and Vincent <Vtryde@aol.com>
for sending me 2.04 and 2.05 VTI ROM !!!

_Tibaul Chevalier with its game 'Space Dementia' ( avaible at moitib.fr.st )
which gives this program a 'concrete' utility :)

_ Rusty Wagner for his wonderful VTI !

_ All those who contribute to the TiGCC Project.

_ Zeljko Juric for the great Tigcc's help.

_ Thomas Nussbaumer for his line drawing routine
and his improved triangle filling routine !

_ All the Users who send me congratulations mails!
I'll make better versions for You !

Once again :

If you think you create a good object , you can send it to me , I'll add it in "Edit3D Users examples" , at ticalc.org...

For the latest versions , news and others games and programs ,visit my website :
http://membres.lycos.fr/dcoz

For all critics , suggestions , ideas , explanations , feel free to mail me at :

coz.hubert@infonie.fr