Home My Page Projects Code Snippets Project Openings 3D graphics for Standard ML
Summary Activity SCM

SCM Repository

[sml3d] Diff of /trunk/sml3d/README
ViewVC logotype

Diff of /trunk/sml3d/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 225, Sun Sep 7 11:13:58 2008 UTC revision 288, Mon Sep 29 14:50:00 2008 UTC
# Line 6  Line 6 
6    
7    This library requires the MLton SML compiler (mlton.org).  Because of    This library requires the MLton SML compiler (mlton.org).  Because of
8    a bug in handling of 8-bit signed integers, it does not build using    a bug in handling of 8-bit signed integers, it does not build using
9    the 20070826 release, but will build under the latest version from svn.    the 20070826 release, but will build under the latest version of MLton
10      from svn.
11    
12    After unpacking, run the configure script and then make.  You can then    After unpacking, run the configure script and then make.  You can then
13    try out some of the example programs.    try out some of the example programs.
14    
15      The process is a bit more complicated if you are installing sml3d from
16      the SVN repository.  See the instructions below for details.
17    
18  USAGE  USAGE
19    
20    Depending on which components of the SML3D library you are using, you    Depending on which components of the SML3D library you are using, you
# Line 49  Line 53 
53    variable as an argument to the mlton command.    variable as an argument to the mlton command.
54    
55    
56    WINDOWS
57    
58      The sml3d library has been ported to work on Windows XP and Windows
59      Vista using the MinGW/MSys installation that comes with the MLton
60      MSI files (http://mlton.org/Experimental).  When using the GLUT library
61      on Windows, you need to make sure that Windows can find the GLUT DLL.
62      If your sml3d tree is in
63    
64            c:\Users\yourlogin\sml3d
65    
66      then add
67    
68            c:\Users\yourlogin\sml3d\windows\bin
69    
70      to your PATH variable.
71    
72    
73  DEPENDENCIES  DEPENDENCIES
74    
75    The SML3d library assumes that your system has OpenGL 2.0 available.    The SML3d library assumes that your system has OpenGL 2.1 available.
76    Optionally it can be configured to use other libraries:    It can be configured to use other libraries:
77    
78          GLUT            Available with most OpenGL systems.  An alternative          GLUT            Available with most OpenGL systems.  An alternative
79                          is available from http://freeglut.sourceforge.net.                          is available from http://freeglut.sourceforge.net.
# Line 82  Line 103 
103            tests         - test programs            tests         - test programs
104            util          - various utility modules            util          - various utility modules
105          examples/       - some example programs          examples/       - some example programs
106            gen/            - code to generate the FFI glue code for OpenGL.
107          windows/        - extra support files for Windows systems (requires          windows/        - extra support files for Windows systems (requires
108                            MinGW)                            MinGW)
109    
110  TODO:  BUILDING FROM SVN
111    
112      If you have downloaded the sml3d sources from svn, then you need a few
113      extra steps to build the system.
114    
115            1) generating glue code.  The FFI glue code is generated from
116               a XML description.  To build the glue code, you will need a
117               recent version of SML/NJ (110.68+).  Then execute the following
118               steps.
119    
120                    % cd gen
121                    % sml
122                    - CM.make "sources.cm";
123                    - Gen.default ();
124    
125            2) The next step is to generate the configure file.  From the
126               sml3d directory,
127    
128                    % autoconf -Iconfig
129    
130            3) follow the INSTALLATION instructions from above.
131    
132    
133    TODO
134          image loaders (ppm, pgm, png, jpeg)          image loaders (ppm, pgm, png, jpeg)
135          model loaders (obj and mtl files)          model loaders (obj and mtl files)
136          SDL          SDL

Legend:
Removed from v.225  
changed lines
  Added in v.288

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0