aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorphil <[email protected]>2016-12-04 19:41:41 +1300
committerphil <[email protected]>2016-12-04 19:41:41 +1300
commit6a0f6e47d1678c8e13492bb29a6d9dca9280e757 (patch)
tree1aa3dd06f91aa7620019c392b1e4cf019eae5e0a /docs
parente3715098dc137f776b551376c294f06a870425b6 (diff)
performance guide updated
Diffstat (limited to 'docs')
-rw-r--r--docs/perf_guide.txt9
1 files changed, 6 insertions, 3 deletions
diff --git a/docs/perf_guide.txt b/docs/perf_guide.txt
index df4d077..6bf480f 100644
--- a/docs/perf_guide.txt
+++ b/docs/perf_guide.txt
@@ -13,18 +13,21 @@ application.
II - Performance in the API
-
Due to some introduced bugs in the Java3D API some of the most important performance features
are effectively disabled. As of Java3D 1.7.0 they can be turned back on but will require some
code changes through any given project due to the possibility of reliance on the features
that broke the compilation system.
In order to maximize compilation of the scene graph you must have these properties set:
- j3d.defaultReadCapabilities = false
+ j3d.defaultReadCapability = false
j3d.defaultNodePickable = false
j3d.defaultNodeCollidable = false
Also, contrary to documentation you MUST manually call compile on BranchGroups and SharedGroups before adding
them to the scene graph, it does not happen automatically.
+ With defaultReadCapability set to false you will need to enable any read capabilities, but be aware that they should only
+ be set enabled where necessary as they heavily impact the compile function.
+ Note when using the new Jogl2es2Pipeline, there are no display lists, so all references to their usage below are not valid.
+
There are a number of things in the API that were included specifically
to increase performance. This section examines a few of them.
@@ -64,7 +67,7 @@ to increase performance. This section examines a few of them.
completely defined by the direct path from the root node to the
given leaf. That means that leaf nodes have no effect on other
leaf nodes, and therefore may be rendered in any order. There
- are a few ordering requirements for direct descendents of
+ are a few ordering requirements for direct descendants of
OrderedGroup nodes or Transparent objects. But, most leaf nodes
may be reordered to facilitate more efficient rendering.