com.sun.javafx.sg.prism

Class NGGroup

java.lang.Object

com.sun.javafx.sg.prism.NGNode

com.sun.javafx.sg.prism.NGGroup

Direct Known Subclasses:

NGRegion, NGWebView

public class NGGroup
extends NGNode

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.javafx.sg.prism.NGNode

NGNode.DirtyFlag, NGNode.RenderRootResult

Field Summary

Fields

Modifier and Type	Field and Description
private Blend.Mode	blendMode The blend mode to use with this group.
private java.util.List<NGNode>	children
private static int	REGION_INTERSECTS_MASK This mask has all bits that mark that a region intersects this group.
private java.util.List<NGNode>	removed
private java.util.List<NGNode>	unmod

Fields inherited from class com.sun.javafx.sg.prism.NGNode

childDirty, contentBounds, cullingBits, dirty, DIRTY_CHILDREN_ACCUMULATED_THRESHOLD, DIRTY_REGION_CONTAINS_NODE_BOUNDS, DIRTY_REGION_CONTAINS_OR_INTERSECTS_NODE_BOUNDS, DIRTY_REGION_INTERSECTS_NODE_BOUNDS, dirtyBounds, dirtyChildrenAccumulated, TEMP_TRANSFORM, transformedBounds

Constructor Summary

Constructors

Constructor and Description
NGGroup()

Method Summary

Modifier and Type	Method and Description
void	add(int index, NGNode node) Adds a node to the given index.
void	addToRemoved(NGNode n)
void	clear()
protected void	clearDirty() Clears the dirty flag.
void	clearFrom(int fromIndex)
protected NGNode.RenderRootResult	computeRenderRoot(NodePath path, RectBounds dirtyRegion, int cullingIndex, BaseTransform tx, GeneralTransform3D pvTx) * Culling Related Methods * *
void	drawDirtyOpts(BaseTransform tx, GeneralTransform3D pvTx, Rectangle clipBounds, int[] countBuffer, int dirtyRegionIndex) Helper method draws rectangles indicating the overdraw rectangles.
java.util.List<NGNode>	getChildren() Gets an unmodifiable list of the current children on this group
java.util.List<NGNode>	getRemovedChildren()
protected boolean	hasOverlappingContents()
protected boolean	hasVisuals() Marks if the node has some visuals and that the bounds change should be taken into account when using the dirty region.
boolean	isEmpty()
protected void	markCullRegions(DirtyRegionContainer drc, int cullingRegionsBitsOfParent, BaseTransform tx, GeneralTransform3D pvTx) Marks placement of the node in dirty region encoded into 2 bit flag: 00 - node outside dirty region 01 - node intersecting dirty region 11 - node completely within dirty region 32 bits = 15 regions max.
protected boolean	needsBlending() Return true if this node has a blend mode that requires special processing.
void	remove(int index)
void	remove(NGNode node)
protected void	renderContent(Graphics g)
void	renderForcedContent(Graphics gOptional) Called on every render pulse for all nodes in case they have render-time operations that must be completed on a pulse, but were not otherwise rendered by the ordinary damage management logic.
void	setBlendMode(java.lang.Object blendMode) Set by the FX scene graph.

Methods inherited from class com.sun.javafx.sg.prism.NGNode

accumulateDirtyRegions, accumulateGroupDirtyRegion, accumulateNodeDirtyRegion, applyClip, applyEffect, applyTransform, checkBoundsInQuad, clearDirtyTree, clearPainted, computeNodeRenderRoot, computeOpaqueRegion, computePadding, doPreCulling, doRender, effectChanged, geometryChanged, getCacheFilter, getClipNode, getClippedBounds, getCompleteBounds, getContentBounds, getEffect, getEffectBounds, getEffectFilter, getFilterContext, getName, getNodeBlendMode, getOpacity, getOpaqueRegion, getParent, getRenderRoot, getTransform, hasOpaqueRegion, invalidateCache, invalidateCacheByTranslation, invalidateOpaqueRegion, isClean, isContentBounds2D, isDepthTest, isOpaqueRegionInvalid, isReadbackSupported, isRectClip, isShape3D, isVisible, markDirty, markTreeDirty, markTreeDirtyNoIncrement, printDirtyOpts, release, render, renderClip, renderEffect, renderForClip, setCachedAsBitmap, setClipNode, setContentBounds, setDepthTest, setEffect, setName, setNodeBlendMode, setOpacity, setParent, setTransformedBounds, setTransformMatrix, setVisible, supportsOpaqueRegions, toString, visualsChanged

Methods inherited from class java.lang.Object

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

Field Detail

blendMode

private Blend.Mode blendMode

The blend mode to use with this group.

children

private java.util.List<NGNode> children

unmod

private java.util.List<NGNode> unmod

removed

private java.util.List<NGNode> removed

REGION_INTERSECTS_MASK

private static final int REGION_INTERSECTS_MASK

This mask has all bits that mark that a region intersects this group. Which means it looks like this: 00010101010101010101010101010101 (first bit for sign)

See Also:

Constant Field Values

Constructor Detail

NGGroup

public NGGroup()

Method Detail

getChildren

public java.util.List<NGNode> getChildren()

Gets an unmodifiable list of the current children on this group

add

public void add(int index,
                NGNode node)

Adds a node to the given index. An index of -1 means "append", for legacy reasons (it was easier than asking for the number of children, iirc).

Parameters:

index - -1, or <= node.size()

node -

clearFrom

public void clearFrom(int fromIndex)

getRemovedChildren

public java.util.List<NGNode> getRemovedChildren()

addToRemoved

public void addToRemoved(NGNode n)

clearDirty

protected void clearDirty()

Description copied from class: NGNode

Clears the dirty flag. This should only happen during rendering.

Overrides:

clearDirty in class NGNode

remove

public void remove(NGNode node)

remove

public void remove(int index)

clear

public void clear()

setBlendMode

public void setBlendMode(java.lang.Object blendMode)

Set by the FX scene graph.

Parameters:

blendMode - cannot be null

renderForcedContent

public void renderForcedContent(Graphics gOptional)

Description copied from class: NGNode

Called on every render pulse for all nodes in case they have render-time operations that must be completed on a pulse, but were not otherwise rendered by the ordinary damage management logic. The graphics argument will be the graphics that was used to render the scene if it is available, but may be null for cases when the scene required no visible updates and thus no back buffer graphics was actually obtained. Implementors must have a backup plan for that case when the Graphics object is null.

Overrides:

renderForcedContent in class NGNode

Parameters:

gOptional - the Graphics object that was used to render the Scene, or null

renderContent

protected void renderContent(Graphics g)

Specified by:

renderContent in class NGNode

hasOverlappingContents

protected boolean hasOverlappingContents()

Specified by:

hasOverlappingContents in class NGNode

isEmpty

public boolean isEmpty()

hasVisuals

protected boolean hasVisuals()

Description copied from class: NGNode

Marks if the node has some visuals and that the bounds change should be taken into account when using the dirty region. This will be false for NGGroup (but not for NGRegion)

Overrides:

hasVisuals in class NGNode

Returns:

true if the node has some visuals

needsBlending

protected boolean needsBlending()

Description copied from class: NGNode

Return true if this node has a blend mode that requires special processing. Regular nodes can handle null or SRC_OVER just by rendering into the existing buffer. Groups override this since they must collect their children into a single rendering pass if their mode is explicitly SRC_OVER.

Overrides:

needsBlending in class NGNode

Returns:

true if this node needs special blending support

computeRenderRoot

protected NGNode.RenderRootResult computeRenderRoot(NodePath path,
                                                    RectBounds dirtyRegion,
                                                    int cullingIndex,
                                                    BaseTransform tx,
                                                    GeneralTransform3D pvTx)

* Culling Related Methods * *

Overrides:

computeRenderRoot in class NGNode

Parameters:

path - the NodePath to populate with the path to the render root. Cannot be null.

dirtyRegion - the current dirty region. Cannot be null.

cullingIndex - index of culling information

tx - current transform. Cannot be null.

pvTx - current perspective transform. Cannot be null.

Returns:

The result of visiting this node.

markCullRegions

protected void markCullRegions(DirtyRegionContainer drc,
                               int cullingRegionsBitsOfParent,
                               BaseTransform tx,
                               GeneralTransform3D pvTx)

Description copied from class: NGNode

Marks placement of the node in dirty region encoded into 2 bit flag: 00 - node outside dirty region 01 - node intersecting dirty region 11 - node completely within dirty region 32 bits = 15 regions max. * 2 bit each. The first two bits are not used because we have a special use case for -1, so they should only be set if in that case.

Overrides:

markCullRegions in class NGNode

Parameters:

drc - The array of dirty regions.

cullingRegionsBitsOfParent - culling bits of parent. -1 if there's no parent.

tx - The transform for this render operation. Cannot be null.

pvTx - Perspective camera transform. Cannot be null.

drawDirtyOpts

public void drawDirtyOpts(BaseTransform tx,
                          GeneralTransform3D pvTx,
                          Rectangle clipBounds,
                          int[] countBuffer,
                          int dirtyRegionIndex)

Description copied from class: NGNode

Helper method draws rectangles indicating the overdraw rectangles.

Overrides:

drawDirtyOpts in class NGNode

Parameters:

tx - The scene->parent transform.

pvTx - The perspective camera transform.

clipBounds - The bounds in scene coordinates

countBuffer - A pixel array where each pixel contains a color indicating how many times it has been "drawn"

dirtyRegionIndex - the index of the dirty region we're gathering information for. This is needed so we can shift the "painted" field to find out if this node was drawn in this dirty region.