         -----------------------------------------------------------
       Inertia/TMT real-time 3D rendering engine trouble shooting guide
         -----------------------------------------------------------

This document discusses some common mistakes that can be made when you're using
Inertia. If you experience any problems, consult this guide first before
writing us a bug-report. If there's a problem that you think should be included
here, feel free to contact us.


--------------------------------------------------------------------------------

Problem : I get a general protection fault whenever I assign a texture surface
          type to an object.

Cause   : You haven't loaded a texture or you haven't assigned one to this
          object. 


Problem : I get a general protection fault whenever I assign phong-shading to
          an object.

Cause   : You haven't created a phong-map or you haven't assigned one to this
          object. 


Problem : I did load a texture and I did create a phong-map. But I still get
          a general protection fault.

Cause   : Be sure to check the results of the Load..... and MakePhongMap
          functions. If they detect an error (Out of memory, file not found
          etc.), they don't halt the program, but merely return an error value.
          Check the Inertia.ref file for error codes.

Problem : I loaded all the textures and objects properly, but I get nothing
          on the screen.

Cause   : The object does not have texture coordinates. Add textures coordinates
          with the TMAP program or make sure the original object has texture
          coordinates.

Problem : I can't get perspective texture mapping to work.

Cause   : Thats because its not implemented yet. While writing Inertia/TMT
          I designed a scheme to make writing polygon fills as painless as
          possible. This is why the 24 polygon fills which are included are
          int 100% assembly code. Writing all this code gives me a headache
          so I decided to put this part on hold.


Problem : When is the Watcom C version of Inertia going to be out.

Cause   : Unless someone else converts this, it will never be out.

