Added main README, updated source README, and cleaned up other code.

Author: coderforlife

README.md

@@ -0,0 +1,22 @@
+Program
+=======
+This program is based on the open-source
+[webgl-loader](http://code.google.com/p/webgl-loader/) project by Won
+Chun. It is based on r82 with many little additions to the converter. The
+output should be completely compatible with the original program. The
+objnormalize program was written by myself, and its functionality is now
+(in part) integrated into the original webgl-loader.
+
+
+Samples
+-------
+The samples directory contains a _very_ basic WebGL viewer for the
+produced models. It has problems with scale sometimes and does not show
+the backs of surfaces.
+
+
+Online Version
+--------------
+You can go to
+[webgl-tests.crbs.ucsd.edu/obj-viewer/](http://webgl-tests.crbs.ucsd.edu/obj-viewer/)
+for an online-usable version of the program.

samples/converter/obj2utf8-mini.bat

@@ -1,20 +1,32 @@
-Usage: ./objcompress in.obj [out.utf8]
+Usage: ./objnormalize in.obj out.obj
 
-        If 'out' is specified, then attempt to write out a compressed,
-        UTF-8 version to 'out.'
+        "Normalize" an obj file. This simply shifts all vertices so that
+        the middle of the object is at (0,0,0). This is required for some
+        viewing environments such as the open-3d-viewer and the included
+        sample viewer.
+        
+Usage: ./objcompress [-w] in.obj out.utf8 >out.js
 
-        If not, write a JSON version to STDOUT.
+        Converts and compresses the OBJ file to the UTF8 format. The
+        necessary JavaScript file is output onto STDOUT. If -w is included
+        then all missing materials will be replaced with a bsaic solid
+        white material. If not provided, any missing materials will cause
+        the process to fail. The actual output file names are prepended
+        with a hash of the file data. This is because a single OBJ file
+        can include multiple models while an UTF8 file cannot.
 
-Usage: ./objanalyze in.obj [list of cache sizes]
-
-        Perform vertex cache analysis on in.obj using specified sizes.
-        For example: ./objanalyze in.obj 6 16 24 32
-        Maximum cache size is 32.
+objanalyze is non-functioning, other tools can be used for this purpose.
 
 Building:
 
 Since there are no external dependences outside of the C/C++ standard
-libraries, you can pretty much build this however you please. I've
-included a cheeky way to do this on POSIX-like systems by including a
+libraries, you can pretty much build this however you please. One compile
+option is using -D MINI_JS. When defined the output JavaScript will be
+minified.
+
+I've included a cheeky way to do this on POSIX-like systems by including a
 build shell script at the top of the file itself. You can build by
 making the .cc file executable, and running it on the command line.
+
+For Windows there is a build.bat script which will compile the code using
+mingw-w64. Make sure to have both the i686 and x86_64 builds installed.

samples/converter/obj2utf8.bat

@@ -1,3 +1,21 @@
+#if 0  // A cute trick to making this .cc self-building from shell.
+g++ $0 -O2 -Wall -Werror -o `basename $0 .cc`;
+exit;
+#endif
+// Copyright 2011 Google Inc. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License"); you
+// may not use this file except in compliance with the License. You
+// may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+// implied. See the License for the specific language governing
+// permissions and limitations under the License.
+
 #define _CRT_SECURE_NO_WARNINGS
 
 #include <stdlib.h>