edu.mines.jtk.sgl

Class Group

java.lang.Object

edu.mines.jtk.sgl.Node

edu.mines.jtk.sgl.Group

Direct Known Subclasses:

AxisAlignedFrame, AxisAlignedQuad, Handle, ImagePanelGroup, ImagePanelGroup2, LineGroup, PointGroup, QuadGroup, TransformGroup, TriangleGroup, World

public class Group
extends Node

A node in the scene graph that may contain node children.

Constructor Summary

Constructors

Constructor and Description
Group()

Method Summary

Methods

Modifier and Type	Method and Description
void	addChild(Node child) Adds the specified child node to this group's list of children.
protected BoundingSphere	computeBoundingSphere(boolean finite) Computes the bounding sphere for this group, including its children.
int	countChildren() Returns the number of children in this group.
protected void	cull(CullContext cc) Culls this group.
protected void	draw(DrawContext dc) Draws this group.
protected int	getAttributeBits() Gets the OpenGL attribute bits for this group.
java.util.Iterator<Node>	getChildren() Gets an iterator for the children in this group.
void	pick(PickContext pc) Picks this group.
void	removeChild(Node child) Removes the specified child node from this group's list of children.

Methods inherited from class edu.mines.jtk.sgl.Node

countParents, cullApply, cullBegin, cullEnd, dirtyBoundingSphere, dirtyDraw, drawApply, drawBegin, drawEnd, getBoundingSphere, getParents, getStates, getWorld, isSelected, pickApply, pickBegin, pickEnd, selectedChanged, setSelected, setStates

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Group

public Group()

Method Detail

addChild

public void addChild(Node child)

Adds the specified child node to this group's list of children. If the node is already a child of this group, then this method does nothing.

The child must not be a world (root) node, because a world has no parents. Also, if this group is in a world, the child must not already be in a different world. A node cannot be in more than one world at a time; it must be removed from one world before it can be added to another.

Parameters:

child - the child node.

removeChild

public void removeChild(Node child)

Removes the specified child node from this group's list of children. If the node is not a child of this group, then this method does nothing.

Parameters:

child - the child node.

countChildren

public int countChildren()

Returns the number of children in this group.

Returns:

the number of children.

getChildren

public java.util.Iterator<Node> getChildren()

Gets an iterator for the children in this group.

Returns:

the iterator.

pick

public void pick(PickContext pc)

Picks this group. This implementation simply applies the pick process to its children.

Overrides:

pick in class Node

Parameters:

pc - the pick context.

cull

protected void cull(CullContext cc)

Culls this group. This implementation simply applies the cull process to its children.

Overrides:

cull in class Node

Parameters:

cc - the cull context.

draw

protected void draw(DrawContext dc)

Draws this group. This implementation simply applies the draw process to its children.

When culling is applied before drawing, the draw list accumulated in the cull context will draw the child nodes, and this method will never be called.

Overrides:

draw in class Node

Parameters:

dc - the draw context.

computeBoundingSphere

protected BoundingSphere computeBoundingSphere(boolean finite)

Computes the bounding sphere for this group, including its children.

Overrides:

computeBoundingSphere in class Node

Parameters:

finite - true, to force bounding sphere to be finite.

Returns:

the computed bounding sphere.

getAttributeBits

protected int getAttributeBits()

Gets the OpenGL attribute bits for this group. For efficiency, this implementation simply returns 0 (no bits). This value is correct only if the group leaves all OpenGL state unchanged in its draw process. Specifically, the OpenGL state may change during the draw process for a group, but the state before and after that process must be the same.

Overrides:

getAttributeBits in class Node

Returns:

the attribute bits.