invalidateLayerProperties
Asks for a paint that draws every layer of this node again with the properties now set on it, as a layer property change does. That paint also shows the repaints of the component's children requested before the call.
The layers of the steps declared before this node record again; this node's layers and those declared after it are drawn again. A component with children reuses the images only in that paint.
A further call before that paint, or a call on a component that is not valid, can call repaint() instead, which makes every layer record again. Until that paint runs, a repaint request on the component, or a paintImmediately of it, on the event dispatch thread covers its whole bounds and takes that paint's place.
With no layer from obtainImageLayer, it repaints the component. Does nothing while the node is not attached.
Limits:
Where an ancestor's paint paints an opaque component, the first graphics the ancestor takes from the component before the component paints make no layer record.
A fade inside another fade on one component can show the inner fade one paint old, until the inner fade's own paint.
A partial repaint of an ancestor between a property change and its redraw shows that part at the new value one event early.
A transform that starts or stops may paint the content twice in one frame.
Throws
if called off the event dispatch thread.