TesselSphere Files

================================================================================
File:        Readme.txt
Summary:     TesselSphere overview
Author:      Nicholas Shea
Copyright:   © Nicholas Shea 2006
Email:       bishopbarnabee@gmail.com
Web:         http://myweb.tiscali.co.uk/oaktree/butterfly
--------------------------------------------------------------------------------
Sun May 07 16:48:31 BST 2006 @700 /Internet Time/
================================================================================

CONTENTS:
  WHAT IS TESSELSPHERE?
  LICENSE & COPYRIGHT
  CREDITS
  RELEASE NOTES
  DOCUMENTATION
  BUILDING
  INSTALLING
  INTERNET
  GUI NOTES
  A BRIEF PLEA
  KNOWN BUGS
  POSSIBLE PROBLEMS
  EASTER EGGS?
  TRADEMARKS
 
--------------------------------------------------------------------------------
WHAT IS TESSELSPHERE?

   TesselSphere is an OpenGL spherical subdivision utility for MS Windows and
   Linux. It currently employs particle and geodesic tesselators. It uses
   morphers that split Delaunay and Voronoi hulls to create new cells in the
   lattice. Additionally, morphers can target individual cells to split or
   stellate. TesselSphere can be used to generate vertices for geodesic domes,
   pollen, radiolaria, viruses and other polyhedra. See the 'Doc' folder for
   examples, or alternatively, download the documenation as a separate file.

   Saves VRML 1.0, POV-Ray inc file and OBJ.

   TesselSphere was coded between 2000-2006 and is the precursor to Geodesica.
   I have no mathematical qualifications and TesselSphere was written as a
   mathematical recreation in my spare time.
--------------------------------------------------------------------------------

LICENSE & COPYRIGHT

   * <License.txt>
--------------------------------------------------------------------------------

CREDITS

   * <Credits.txt>
--------------------------------------------------------------------------------

RELEASE NOTES

   * <ReleaseNotes.txt>
   * <DevHistory.txt>
--------------------------------------------------------------------------------
DOCUMENTATION
   See inside the 'doc' folder.
--------------------------------------------------------------------------------

BUILDING

   * <Build-lnx.txt>       for Linux.
   * <Build-win.txt>       for Microsoft Windows
--------------------------------------------------------------------------------

INSTALLING

   * <Install.txt>
--------------------------------------------------------------------------------

INTERNET

   http://myweb.tiscali.co.uk/oaktree/butterfly
--------------------------------------------------------------------------------

GUI NOTES

   See GUI.txt
--------------------------------------------------------------------------------

A BRIEF PLEA

   If you find TesselSphere useful or have found a bug please let me know. I
   would like to make TesselSphere as robust and useful as possible. Feedback is
   always appreciated.
--------------------------------------------------------------------------------

KNOWN BUGS
   
   1) Geodesic Tesselator
      Start/End spinners on the Symmetry Table will only update geometric data
      when their values are changed.

   There are others, but none seem critical at the present time.
--------------------------------------------------------------------------------

POSSIBLE PROBLEMS

   SEGMENTATION FAULT USING NVIDIA DRIVER(S) ON LINUX

   You get a segmentation fault when the app starts or you get the following
   message:
   
        Error: Could not open /dev/nvidiactl because the permissions
        are too restrictive.  Please see the FREQUENTLY ASKED QUESTIONS
        section of /usr/share/doc/NVIDIA_GLX-1.0/README for steps
        to correct.
		
   Try running the program as root. If the app runs OK then there are 2
   possibilities.
   
   1) Permissions on your nvidia devices files are messed up. Here is the
      answer from /usr/share/doc/NVIDIA_GLX-1.0/README:
	  
      ************************************************************************
      It is likely that a security module for the PAM system may be
      changing the permissions on the NVIDIA device files.  In most cases
      this security system works, but it can get confused.  To correct this
      problem it is recommended that you disable this security feature.
      Different Linux distributions have different files to control this;
      please consult with your distributor for the correct method of
      disabling this security feature.  As an example, if your system has
      the file
           /etc/security/console.perms
      then you should edit the file and remove the line that starts with
      "<dri>" (we have also received reports that additional references to
      <dri> in console.perms must be removed, but this has not been verified
      by NVIDIA).  If instead your system has the file
          /etc/logindevperms
      then you should edit the file and remove the line that lists
      /dev/nvidiactl.  The above steps will prevent the PAM security system
      from modifying the permissions on the NVIDIA device files.  Next,
      you will need to reset the permissions on the device files back
      to their original permissions and owner.  You can do that with the
      following commands:
          chmod 0666 /dev/nvidia*
		  chown root /dev/nvidia*
      ************************************************************************
	  
	  When using Linux Mandrake 10.2 (Mandriva Limited Edition 2005), I found
	  that permissions on nvidia device files changed intermittently, despite
	  taking the steps reccommended bu NVIDIA. The solution that worked for me
	  was to add these lines to the file: /etc/rc.d/rc.local
	
	  chmod 0666 /dev/nvidia*
	  chown root /dev/nvidia*
	  echo "Set permissions for /dev/nividia*"
	
	  This shell script /etc/rc.d/rc.local gets executed *after* all the other
	  init scripts.
	
	  I also added custom permissions to all the /dev/nvidia files using the
	  permissions module of the Mandrake system configuration tool.

	2) Permissions on the prefs folder are messed up. Check the permissions on:
	   /home/yourhome/.fltk/foldernicholassheaATtiscali.co.uk
	   These will need to be set for the current user because the app obviously
	   needs write/read permission for all the preference files.
--------------------------------------------------------------------------------

EASTER EGGS?
   
   Just one on the about box.
--------------------------------------------------------------------------------

TRADEMARKS

    Microsoft and Windows are registered trademarks of Microsoft
    Corporation. UNIX is a registered trademark of the X/Open
    Group, Inc.  OpenGL is a registered trademark of Silicon
    Graphics, Inc.  MacOS is a registered trademark of Apple
    Computers, Inc.
--------------------------------------------------------------------------------