This is a collection of general purpose (mostly) Java code and (mostly) related scripts written by Prof. Vona. The best way to learn about using these utilities is to read the javadoc and the source.
GeometryArrayand accessors for Java3D vertex, index, and primitive datastructures.
Loggerinfrastructure but which also generates terminal output in color and behaves reasonably well in applet contexts.
Vona's Java Utils is released under the GNU GPLv2. The distribution jars (amd64, i586, nonatives) come with everything rolled into one: sourcecode, Java class files, html documentation, makefiles, native binaries (if any) for the indicated architecture, etc. These jars contain both VonaUtils and its dependencies, which are:
f2jutil.jar xerbla.jar blas.jar lapack.jar)
netlib-java.jar netlib-java-natives-OS-ARCH.jar, we provide a script to regenerate these if needed)
vecmath.jar j3dcore.jar j3dutils.jar) and the Java3D VRML97 (
j3d-vrml97.jar) and Microcrowd 3DS (
gluegen-rt.jar jogl-all.jar gluegen-rt-natives-OS-ARCH.jar jogl-all-natives-OS-ARCH.jar)
The supported operating systems for native binaries are Linux, Macintosh OS X, and Windows. Vona's Java Utils does not itself use native binaries, but some of its dependencies do as noted in the list above.
A lighter-weight jar is also available which excludes all the third-party dependencies. The extra-light jar excludes dependencies, our modified version of JScheme, source code, and documentation.
Run this with any of the jarfiles to get the specific revision number and build timestamp:
java -cp Vona-*.jar vona.Version
The build has been tested on GNU/Linux and Macintosh OS X. Other platforms may work. You should only need to build the code if you have made a change; it is distributed with pre-built binaries.
The build system is based on the Super-Ninja Makefile. You'll need to have already installed
You'll probably want to create a directory into which to unpack the jar (
jar xvf Vona-newest-*.jar). The code for Vona's Java Utils proper will be under the unpacked directory
vona/; sibling directories contain the bundled dependencies. The build system will find these. Alternately, you can unpack
Vona-lite-newest.jar, and in that case, the build system will look for jarfiles for the pure java deps in the location specified by its
EXT_DIR variable, which you can inspect via
make show-settings (see the makefile for how it is derived).
From within the
make show-settingsdumps the build system's config vars
make makefilesgenerates makefiles in any subpackages
make project-cleanremoves most precompiled stuff
make project-realcleanremoves all precompiled stuff
make project(re)builds the binary files for the project
make(re)builds the binary files in the current directory
make project-javadoc(re)builds the project documentation
make package-html(re)builds HTML in the current directory
make jars(re)builds the jars
THIS INFORMATION AND/OR SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS INFORMATION AND/OR SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.