OpenJDK 27 · sun.java2d.pipe.BufferedContext · APIdia, the JavaDoc alternative

Field Summary

Modifier and Type	Field and Description
private final RenderBuffer	buf
protected static BufferedContext	currentContext This is a reference to the most recently validated BufferedContext.
private boolean	isValidatedPaintJustAColor
public static final int	NO_CONTEXT_FLAGS Indicates that no flags are needed; take all default code paths.
private final RenderQueue	rq
public static final int	SRC_IS_OPAQUE Indicates that the source surface (or color value, if it is a simple rendering operation) is opaque (has an alpha value of 1.0).
private AffineTransform	transform
public static final int	USE_MASK Indicates that the operation uses an alpha mask, which may determine the code path that is used when setting up the current paint state.
private int	validatedFlags
private int	validatedRGB
private Reference<Region>	validClipRef
private Reference<Composite>	validCompRef
private Reference<AccelSurface>	validDstDataRef
private Reference<Paint>	validPaintRef
private Reference<AccelSurface>	validSrcDataRef
private boolean	xformInUse

Access	Constructor and Description
protected	BufferedContext(RenderQueue rq)

Method Summary

Modifier and Type	Method and Description
public final RenderQueue	Returns: a render queue getRenderQueue() Returns a singleton `RenderQueue` object used by the rendering pipeline.
public final void	invalidateContext() Resets this context's surfaces and all attributes.
private void	resetClip()
private void	resetComposite()
private void	resetTransform()
private void	setClip(Region clip)
private void	setComposite(Composite comp, int flags)
private void	setSurfaces(AccelSurface srcData, AccelSurface dstData)
private void	setTransform(AffineTransform xform)
private static <T> boolean	stateChanged(Reference<T> ref, T obj)
private void	validate(AccelSurface srcData, AccelSurface dstData, Region clip, Composite comp, AffineTransform xform, Paint paint, SunGraphics2D sg2d, int flags) Validates the given parameters against the current state for this context.
public static void	validateContext(AccelSurface srcData, AccelSurface dstData, Region clip, Composite comp, AffineTransform xform, Paint paint, SunGraphics2D sg2d, int flags) Fetches the BufferedContextContext associated with the dst.
public static void	validateContext(AccelSurface surface) Fetches the BufferedContext associated with the surface and disables all context state settings.
private static <T> Reference<T>	wrapState(T obj)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

buf	back to summary
private final RenderBuffer buf

currentContext	back to summary
protected static BufferedContext currentContext This is a reference to the most recently validated BufferedContext. If this value is null, it means that there is no current context. It is provided here so that validate() only needs to do a quick reference check to see if the BufferedContext passed to that method is the same as the one we've cached here.

isValidatedPaintJustAColor	back to summary
private boolean isValidatedPaintJustAColor

NO_CONTEXT_FLAGS	back to summary
public static final int NO_CONTEXT_FLAGS Indicates that no flags are needed; take all default code paths. Annotations @Native

rq	back to summary
private final RenderQueue rq

SRC_IS_OPAQUE	back to summary
public static final int SRC_IS_OPAQUE Indicates that the source surface (or color value, if it is a simple rendering operation) is opaque (has an alpha value of 1.0). If this flag is present, it allows us to disable blending in certain situations in order to improve performance. Annotations @Native

transform	back to summary
private AffineTransform transform

USE_MASK	back to summary
public static final int USE_MASK Indicates that the operation uses an alpha mask, which may determine the code path that is used when setting up the current paint state. Annotations @Native

validatedFlags	back to summary
private int validatedFlags

validatedRGB	back to summary
private int validatedRGB

validClipRef	back to summary
private Reference<Region> validClipRef

validCompRef	back to summary
private Reference<Composite> validCompRef

validDstDataRef	back to summary
private Reference<AccelSurface> validDstDataRef

validPaintRef	back to summary
private Reference<Paint> validPaintRef

validSrcDataRef	back to summary
private Reference<AccelSurface> validSrcDataRef

xformInUse	back to summary
private boolean xformInUse

Constructor Detail

BufferedContext	back to summary
protected BufferedContext(RenderQueue rq)

Method Detail

getRenderQueue back to summary

getRenderQueue	back to summary
public final RenderQueue getRenderQueue() Returns a singleton `RenderQueue` object used by the rendering pipeline. Returns:RenderQueue a render queue See Also `RenderQueue`

public final RenderQueue getRenderQueue()

Returns a singleton RenderQueue object used by the rendering pipeline.

Returns:RenderQueue: a render queue
See Also: RenderQueue

invalidateContext back to summary

invalidateContext	back to summary
public final void invalidateContext() Resets this context's surfaces and all attributes. Note must be called while the RenderQueue lock is held. See Also `RenderQueue#lock`, `RenderQueue#unlock`

public final void invalidateContext()

Resets this context's surfaces and all attributes.

Note

must be called while the RenderQueue lock is held.

See Also: RenderQueue#lock, RenderQueue#unlock

resetClip	back to summary
private void resetClip()

resetComposite	back to summary
private void resetComposite()

resetTransform	back to summary
private void resetTransform()

setClip	back to summary
private void setClip(Region clip)

setComposite	back to summary
private void setComposite(Composite comp, int flags)

setSurfaces	back to summary
private void setSurfaces(AccelSurface srcData, AccelSurface dstData)

setTransform	back to summary
private void setTransform(AffineTransform xform)

stateChanged	back to summary
private static <T> boolean stateChanged(Reference<T> ref, T obj)

validate	back to summary
private void validate(AccelSurface srcData, AccelSurface dstData, Region clip, Composite comp, AffineTransform xform, Paint paint, SunGraphics2D sg2d, int flags) Validates the given parameters against the current state for this context. If this context is not current, it will be made current for the given source and destination surfaces, and the viewport will be updated. Then each part of the context state (clip, composite, etc.) is checked against the previous value. If the value has changed since the last call to validate(), it will be updated accordingly. Note that the SunGraphics2D parameter is only used for the purposes of validating a (non-null) Paint parameter. In all other cases it is safe to pass a null SunGraphics2D and it will be ignored. Note must be called while the RenderQueue lock is held. It's assumed that the type of surfaces has been checked by the Renderer Exceptions InvalidPipeException: if either src or dest surface is not valid or lost

validate

back to summary

private void validate(AccelSurface srcData, AccelSurface dstData, Region clip, Composite comp, AffineTransform xform, Paint paint, SunGraphics2D sg2d, int flags)

Validates the given parameters against the current state for this context. If this context is not current, it will be made current for the given source and destination surfaces, and the viewport will be updated. Then each part of the context state (clip, composite, etc.) is checked against the previous value. If the value has changed since the last call to validate(), it will be updated accordingly. Note that the SunGraphics2D parameter is only used for the purposes of validating a (non-null) Paint parameter. In all other cases it is safe to pass a null SunGraphics2D and it will be ignored.

Note

must be called while the RenderQueue lock is held. It's assumed that the type of surfaces has been checked by the Renderer

Exceptions

InvalidPipeException:: if either src or dest surface is not valid or lost

validateContext back to summary

validateContext	back to summary
public static void validateContext(AccelSurface srcData, AccelSurface dstData, Region clip, Composite comp, AffineTransform xform, Paint paint, SunGraphics2D sg2d, int flags) Fetches the BufferedContextContext associated with the dst. surface and validates the context using the given parameters. Most rendering operations will call this method first in order to set the necessary state before issuing rendering commands. Note must be called while the RenderQueue lock is held. It's assumed that the type of surfaces has been checked by the Renderer Exceptions InvalidPipeException: if either src or dest surface is not valid or lost See Also `RenderQueue#lock`, `RenderQueue#unlock`

public static void validateContext(AccelSurface srcData, AccelSurface dstData, Region clip, Composite comp, AffineTransform xform, Paint paint, SunGraphics2D sg2d, int flags)

Fetches the BufferedContextContext associated with the dst. surface and validates the context using the given parameters. Most rendering operations will call this method first in order to set the necessary state before issuing rendering commands.

Note

must be called while the RenderQueue lock is held. It's assumed that the type of surfaces has been checked by the Renderer

Exceptions

InvalidPipeException:: if either src or dest surface is not valid or lost

validateContext back to summary

validateContext	back to summary
public static void validateContext(AccelSurface surface) Fetches the BufferedContext associated with the surface and disables all context state settings. Note must be called while the RenderQueue lock is held. It's assumed that the type of surfaces has been checked by the Renderer Exceptions InvalidPipeException: if the surface is not valid or lost See Also `RenderQueue#lock`, `RenderQueue#unlock`

public static void validateContext(AccelSurface surface)

Fetches the BufferedContext associated with the surface and disables all context state settings.

Note

must be called while the RenderQueue lock is held. It's assumed that the type of surfaces has been checked by the Renderer

Exceptions

InvalidPipeException:: if the surface is not valid or lost

wrapState	back to summary
private static <T> Reference<T> wrapState(T obj)

public abstract Class BufferedContext

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail