home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / togl15.zip / README < prev    next >
Text File  |  2000-04-16  |  5KB  |  121 lines
  1.  
  2.                                Togl 1.5 for OS/2
  3.                                        
  4. Togl 1.5
  5.  
  6.    [1]Togl is a [2]Tk widget for OpenGL rendering.
  7.    
  8.    I have ported part of Togl to OS/2 using the PGL API in order to
  9.    develop my [3]CS 488 assignments at home. I have only ported the RGB
  10.    parts of Togl, and not the colour index modes, and not other features
  11.    of Togl.
  12.    
  13.    In Togl, versions for Windows and X exist simultaneously in the source
  14.    file. In my port I added an EMX version, so all three versions exists
  15.    simultaneously in the source file. I have not tested this version
  16.    under Windows, so it is possible I accidently broke that part of it. I
  17.    have done marginal testing of the X code in Togl.
  18.    
  19. How to get Togl 1.5 for OS/2
  20.  
  21.    Source for Togl 1.5 for OS/2 is available to [4]download in zip file
  22.    format.
  23.    
  24.    [5]Example code that uses Togl is available from the [6]CS 488/688
  25.    website.
  26.    
  27. How do I use Togl 1.5 for OS/2
  28.  
  29.   System Requirements
  30.   
  31.     Tcl/Tk
  32.     
  33.    First you will need [7]Tcl/Tk for OS/2. My port for Togl has only been
  34.    tested on the 8.0.5 beta version of Tcl/Tk, and probably will not work
  35.    with the 7.6/4.2 release.
  36.    
  37.    As part of the source code, I need tkOS2Int.h from the source files
  38.    for Tcl/Tk. If you use a newer version of Tcl/Tk, this file may need
  39.    to be replaced.
  40.    
  41.    Warning: Togl 1.5 for OS/2 uses internal code from Tcl/Tk 8.0.5
  42.    (tkOS2Int.h), and therefore it is subject to change. So be careful out
  43.    there.
  44.    
  45.     OpenGL
  46.     
  47.    OpenGL for OS/2 Warp is available by [8]FTP from IBM. I suggest
  48.    downloading [9]oglgold.zip.
  49.    
  50.     Compiler
  51.     
  52.    Togl is used to develop programs. So you will of course need a
  53.    compiler. Togl compiles under [10]emx and gcc.
  54.    
  55.   Interface
  56.   
  57.    The [11]C interface and [12]Tcl/Tk interface for Togl are described at
  58.    the [13]Togl homepage.
  59.    
  60. Bugs
  61.  
  62.    Many features of Togl probably do not work. But my assignments for my
  63.    [14]CS 488 run fine, and that is all I wanted. If you want to port
  64.    more features of Togl, go right ahead.
  65.    
  66. Legal Stuff
  67.  
  68.    Parts of this software are copyrighted by [15]Russell O'Connor.
  69.    
  70.    This software is copyrighted by Brian Paul (brianp@elastic.avid.com)
  71.    and Benjamin Bederson (bederson@cs.umd.edu). The following terms apply
  72.    to all files associated with the software unless explicitly disclaimed
  73.    in individual files.
  74.    
  75.    The authors hereby grant permission to use, copy, modify, distribute,
  76.    and license this software and its documentation for any purpose,
  77.    provided that existing copyright notices are retained in all copies
  78.    and that this notice is included verbatim in any distributions. No
  79.    written agreement, license, or royalty fee is required for any of the
  80.    authorized uses. Modifications to this software may be copyrighted by
  81.    their authors and need not follow the licensing terms described here,
  82.    provided that the new terms are clearly indicated on the first page of
  83.    each file where they apply.
  84.    
  85.    IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
  86.    FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  87.    ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
  88.    DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
  89.    POSSIBILITY OF SUCH DAMAGE.
  90.    
  91.    THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
  92.    INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  93.    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
  94.    NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, AND
  95.    THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
  96.    MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  97.      _________________________________________________________________
  98.    
  99.    
  100.     [16]Russell O'Connor: [17]roconnor@uwaterloo.ca
  101.  
  102. References
  103.  
  104.    1. http://Togl.sourceforge.net/
  105.    2. http://dev.scriptics.com/software/tcltk/
  106.    3. http://www.undergrad.math.uwaterloo.ca/~cs488/
  107.    4. file://localhost/u7/roconnor/public_html/togl/toglOS2.zip
  108.    5. http://www.undergrad.math.uwaterloo.ca/~cs488/a1.zip
  109.    6. http://www.undergrad.math.uwaterloo.ca/~cs488/OS2index.html
  110.    7. http://www.vaeshiep.demon.nl/
  111.    8. ftp://ftp.austin.ibm.com/pub/developer/os2/OpenGL/
  112.    9. ftp://ftp.austin.ibm.com/pub/developer/os2/OpenGL/oglgold.zip
  113.   10. http://hobbes.nmsu.edu/pub/os2/dev/emx/v0.9d/
  114.   11. http://togl.sourceforge.net/#Cfuncs
  115.   12. http://togl.sourceforge.net/#TclFuncs
  116.   13. http://togl.sourceforge.net/
  117.   14. http://www.undergrad.math.uwaterloo.ca/~cs488/
  118.   15. mailto:roconnor@uwaterloo.ca
  119.   16. http://www.undergrad.math.uwaterloo.ca/~roconnor/
  120.   17. mailto:roconnor@uwaterloo.ca
  121.