aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 3bb037fb0fff141797257e02be7ed7e107e20981 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

Java3D Readme

The source code for the j3d-core project is copyrighted code that is licensed to individuals or companies who download or otherwise access the code.

The copyright notice for this project is in COPYRIGHT.txt

The source code license information for this project is in LICENSE.txt

Additional information and license restrictions for third party source code are found in the THIRDPARTY-LICENSE-*.txt files.

##Building Java3D

The instructions below are based on eclipse, however they should work on most common IDE's

Clone the repo using https://github.com/philjord/java3d-core.git Make note of the root folder you use
Right click on the Project Explorer view and select Import
Expand the Maven group and select Existing Maven Project and click Next
For Root directory click Browse and find the root folder that you cloned the repo into
There should be a pom.xml that is ticked in the Projects area
Click Finish
Repeat for java3d-utils using https://github.com/philjord/java3d-utils.git Repeat for vecmath using https://github.com/philjord/vecmath.git

Once that's done it's likely you'll need to Right click on pom.xml -> Run As -> Maven clean then Right click on pom.xml -> Run As -> Maven generate sources This should place a derived version of VersionInfo.java into /java3d-core/target/generated-sources/java-templates

If you are new to Java3D then it might be good to repeat the clone import step for java3d-examples too, using https://github.com/philjord/java3d-examples.git

Now if you right click on
org.jdesktop.j3d.examples.hello_universe.HelloUniverse.java
Run as ... Java Application
You should see Java3D working

##Documentation

###Javadocs

https://jogamp.org/wiki/index.php?title=Java3D_API_Documentation

###Basic overview guide

For the best kick off point see /docs/tutorial/
For a description of performance see /docs/perf_guide.txt
Old Java3d project site with lots of information https://java.net/projects/java3d General technical tips https://java.net/projects/java3d/pages/Java3DApplicationDev
Using the newer ES2/ES3 pipeline [/docs/GL2ES2Pipeline usage guide.md](/docs/GL2ES2Pipeline usage guide.md)

###Tutorials

http://www.java3d.org/tutorial.html

###FAQ

http://jogamp.org/wiki/index.php/Java3D_FAQ

###General assistance
contact the forum at
http://forum.jogamp.org/