From e2d3fa583147f13f5e5dfac8ecd132f8dbd1a481 Mon Sep 17 00:00:00 2001 From: Kevin Rushforth Date: Mon, 31 Jan 2005 23:35:09 +0000 Subject: 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 --- src/classes/share/javax/media/j3d/ViewSpecificGroup.java | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) (limited to 'src/classes') 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; * *

* 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. + * + *

+ * 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. + * + *

* 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 -- cgit v1.2.3