* The first child, at index 0, defines the surface on top of which all * other children are rendered. The geometry of this child must encompass * all other children, otherwise incorrect rendering may result. The * polygons contained within each of the children must be facing the same * way. If the polygons defined by the first child are front facing, then * all other surfaces should be front facing. In this case, the polygons * are rendered in order. The renderer can use knowledge of the coplanar * nature of the surfaces to avoid * Z-buffer collisions. If the main surface is back facing then all other * surfaces should be back facing, and need not be rendered (even if back * face culling is disabled). *
* Note that using the DecalGroup node does not guarantee that Z-buffer
* collisions are avoided. An implementation of Java 3D may fall back to
* treating DecalGroup node as an OrderedGroup node.
*/
public class DecalGroup extends OrderedGroup {
/**
* Constructs and initializes a new DecalGroup node object.
*/
public DecalGroup() {
}
/**
* Creates the retained mode DecalGroupRetained object that this
* DecalGroup component object will point to.
*/
@Override
void createRetained() {
this.retained = new DecalGroupRetained();
this.retained.setSource(this);
}
/**
* Used to create a new instance of the node. This routine is called
* by cloneTree to duplicate the current node.
* @param forceDuplicate when set to true, causes the
* duplicateOnCloneTree flag to be ignored. When
* false, the value of each node's
* duplicateOnCloneTree variable determines whether
* NodeComponent data is duplicated or copied.
*
* @see Node#cloneTree
* @see Node#cloneNode
* @see Node#duplicateNode
* @see NodeComponent#setDuplicateOnCloneTree
*/
@Override
public Node cloneNode(boolean forceDuplicate) {
DecalGroup dg = new DecalGroup();
dg.duplicateNode(this, forceDuplicate);
return dg;
}
}