Java Doc for J3DGraphics2D.java in  » 6.0-JDK-Modules » java-3d » javax » media » j3d » Java Source Code / Java DocumentationJava Source Code and Java Documentation

An application obtains a J3D 2D graphics context object from the Canvas3D object that the application wishes to render into by using the getGraphics2D method. A new J3DGraphics2D object is created if one does not already exist.

Note that the drawing methods in this class, including those inherited from Graphics2D, are not necessarily executed immediately. They may be buffered up for future execution. Applications must call the flush(boolean) method to ensure that the rendering actually happens. The flush method is implicitly called in the following cases:

• The Canvas3D.swap method calls flush(true)
• The Java 3D renderer calls flush(true) prior to swapping the buffer for a double buffered on-screen Canvas3D
• The Java 3D renderer calls flush(true) prior to copying into the off-screen buffer of an off-screen Canvas3D
• The Java 3D renderer calls flush(false) after calling the preRender, renderField, postRender, and postSwap Canvas3D callback methods.

A single-buffered, pure-immediate mode application must explicitly call flush to ensure that the graphics will be rendered to the Canvas3D.
See Also:   Canvas3D.getGraphics2D
since:
   Java 3D 1.2