From f93d5392f8cb5ca85b718a10fd9e472907512c0b Mon Sep 17 00:00:00 2001 From: Curtis Rueden Date: Tue, 24 Feb 2015 11:38:45 -0600 Subject: Build the project using Maven This introduces a pom.xml which tells Maven how the project is structured. To avoid a boatload of disruptive renames, we override some of Maven's default settings. It updates the code generation scheme to generate VersionInfo.java using the templating-maven-plugin. Lastly, it removes the Ant build files to avoid maintaining multiple build systems. --- README-build.html | 162 ------------------------------------------------------ 1 file changed, 162 deletions(-) delete mode 100644 README-build.html (limited to 'README-build.html') diff --git a/README-build.html b/README-build.html deleted file mode 100644 index c12cd7f..0000000 --- a/README-build.html +++ /dev/null @@ -1,162 +0,0 @@ - - - - - README-build: build instructions for the j3d-core project - - -

Building -the 3D packages

-

-

To -build the 3D packages, you must clone the following three -repositories:
-

- -

These three top-level directories must be named exactly as -shown above and they must be sibling directories. To ensure this, run -the git clone command for each of the respositories from the same -parent directory. You will also need the gluegen and jogl builds for at least -version 2.3.1. For example:
-

- -

NOTE: you must first build the javax.vecmath package before building -the javax.media.j3d and com.sun.j3d.* packages. See the README-build.html file in the -"vecmath" directory for instructions.
-

-

System Requirements

-

-

The -following operating environments have been tested:
-

- -

The following software must be installed:
-

- -

Building the 3D packages

-

Before -you start building, your PATH must include the -following directories: -

- -

The default target, jar-opt, creates an optimized jar files -and native libraries. -

-

On Amd64 platform an OutOfMemoryError can be seen. In this case set -the environment variable ANT_OPTS to -Xmx256m.
-

-

Steps: -

- -

The above steps build both the Java and native code for -javax.media.j3d and com.sun.j3d.* -packages. -

-

The build will be placed in j3d-core/build/<platform>/opt -where <platform> is determined from the ant -echo command: -

- -To see other targets that are available, type "ant --projecthelp". Note that ant must be run from the top-level -directory. -

The default compiler for native code compilation is set to "gcc". -This -value is set in the build.properties -file located -in the j3d-core directory. The compiler property is "build.comp".
-

-

On a Solaris platform with Forte compiler installed, -build.comp -can be set to "forte". On a Windows platform installed Visual C++, -build.properties -can be set to "vc".
-

-

NOTE: For Windows platform only, the property "build.rend" in -build.properties can be modified to use "d3d" (Direct3D API for -rendering) besides the default value "ogl".
-

-

NOTE: You can also modify the properties via command-line options to -ant, -for example, "ant -Dbuild.comp=vc"
-

-

Running -the 3D examples

-

Please refer to README-build.html in -j3d-examples for -details -on building and running the 3D example programs.
-

- - -- cgit v1.2.3