aboutsummaryrefslogtreecommitdiffstats
path: root/src/classes
diff options
context:
space:
mode:
authorKevin Rushforth <[email protected]>2005-01-31 23:35:09 +0000
committerKevin Rushforth <[email protected]>2005-01-31 23:35:09 +0000
commite2d3fa583147f13f5e5dfac8ecd132f8dbd1a481 (patch)
tree65698309de6b8a2aff9de006633d4681dfe15bee /src/classes
parentc6aff6e6963918c8f7d10efe9aad1557f497e697 (diff)
Issue number: 96
Submitted by: kcr Fix for Issue 96 - ViewSpecificGroup documentation needs clarification git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@114 ba19aa83-45c5-6ac9-afd3-db810772062c
Diffstat (limited to 'src/classes')
-rw-r--r--src/classes/share/javax/media/j3d/ViewSpecificGroup.java16
1 files changed, 15 insertions, 1 deletions
diff --git a/src/classes/share/javax/media/j3d/ViewSpecificGroup.java b/src/classes/share/javax/media/j3d/ViewSpecificGroup.java
index 71dc123..501a598 100644
--- a/src/classes/share/javax/media/j3d/ViewSpecificGroup.java
+++ b/src/classes/share/javax/media/j3d/ViewSpecificGroup.java
@@ -26,13 +26,27 @@ import java.util.Enumeration;
*
* <p>
* All nodes except ViewPlatform may appear as a descendant of
- * ViewSpecificGroup (including another ViewSpecificGroup). Behavior
+ * ViewSpecificGroup, including another ViewSpecificGroup. If a
+ * ViewSpecificGroup is a descendant of a ViewSpecificGroup, the
+ * effect is to intersect the view sets of the ViewSpecificGroup nodes
+ * in the hierarchy; each ViewSpecificGroup encountered when
+ * traversing the scene graph further restricts the set of views on
+ * which its descendants are rendered. More formally, descendant
+ * nodes of ViewSpecificGroups are rendered in (or apply to) only
+ * those views that are contained in the set of views of every
+ * ViewSpecificGroup in the scene graph path from the Locale to the
+ * Node.
+ *
+ * <p>
+ * Behavior
* nodes may appear under a ViewSpecificGroup, but are not affected by
* it--the Behavior scheduler is per-universe rather than per-View.
* BoundingLeaf nodes are similarly unaffected by being under a
* ViewSpecificGroup. A BoundingLeaf under a ViewSpecificGroup
* provides a valid bounds for any node that refers to it,
* irrespective of the view.
+ *
+ * <p>
* The rest of the leaf nodes either: A) are only rendered within the
* specified view(s), for example, Shape3D, Morph, and Sound; or B)
* only affect other objects when they are rendered in the specified