gumbo.graphic
Interface GraphicPresence

All Superinterfaces:

Disposable, Graphic, GraphicResource

All Known Subinterfaces:

AxisLayoutGraphic, GraphicShape, GraphicView, SelectableShape

All Known Implementing Classes:

NullGraphicView, SwingDataProxy, SwingDataShape, SwingGraphView, SwingListView, SwingShape, SwingSpaceNode, SwingTreeView

public interface GraphicPresence

extends GraphicResource

A graphic resource with a presence, which the user can sense (sight, sound, touch).

As needed and if possible, methods in the graphic entity related to native preparation and realization (e.g. Swing validation and paint) should be overriden and coordinated with the methods in this interface. TODO: Should responsibility for presentation be with the graphic or the factory creating and updating the graphic?

Version:

$Revision: 1.2 $

Author:

Jon Barrilleaux (jonb@jmbaai.com) of JMB and Associates Inc.

Method Summary

void	prepareGraphicPresence() Informs this graphic entity that, in anticipation of realization, it should update as needed those aspects of its graphic state (geometry, appearance) and that of any dependents (siblings, descendants) that can affect its presentation.
void	realizeGraphicPresence() Informs this graphic entity that external (sibling, ancestor) and internal (self, descendant) state changes that can affect its presentation are complete and assumed valid, and that it should update its presentation as needed to be consistent with its graphic state.

Methods inherited from interface gumbo.graphic.Graphic

getGraphic

Methods inherited from interface gumbo.util.Disposable

dispose, isDisposed

Method Detail

prepareGraphicPresence

public void prepareGraphicPresence()

Informs this graphic entity that, in anticipation of realization, it should update as needed those aspects of its graphic state (geometry, appearance) and that of any dependents (siblings, descendants) that can affect its presentation. Does not actually affect the presentation (see realizeGraphicDisplay()). Allows for efficient batching of graphic state changes.

realizeGraphicPresence

public void realizeGraphicPresence()

Informs this graphic entity that external (sibling, ancestor) and internal (self, descendant) state changes that can affect its presentation are complete and assumed valid, and that it should update its presentation as needed to be consistent with its graphic state. Allows for efficient batching of graphic state realizations.