diff options
| -rw-r--r-- | doc/Implementation/AWTPrinting.txt | 67 |
1 files changed, 46 insertions, 21 deletions
diff --git a/doc/Implementation/AWTPrinting.txt b/doc/Implementation/AWTPrinting.txt index 0be3848ed..85cf8bb90 100644 --- a/doc/Implementation/AWTPrinting.txt +++ b/doc/Implementation/AWTPrinting.txt @@ -1,28 +1,57 @@ Screenshots of unit tests: -<http://jogamp.org/files/screenshots/printing/test01-awt/> + <http://jogamp.org/files/screenshots/printing/test01-awt/> Unit test producing the results: -<http://jogamp.org/git/?p=jogl.git;a=blob;f=src/test/com/jogamp/opengl/test/junit/jogl/tile/TestTiledPrintingGearsAWT.java;h=71b4a958b1b0b34fb6c07585773ec3653c861e88;hb=de538efc92346cada023a6045d8aec3cbdd47e08> - -GLCanvas Print code: - <http://jogamp.org/git/?p=jogl.git;a=blob;f=src/jogl/classes/javax/media/opengl/awt/GLCanvas.java;h=02e6e8121f2f6b6043d9513b5547ecd0e8787db8;hb=de538efc92346cada023a6045d8aec3cbdd47e08#l739> + Base Test Class: + <http://jogamp.org/git/?p=jogl.git;a=blob;f=src/test/com/jogamp/opengl/test/junit/jogl/tile/TiledPrintingAWTBase.java;hb=HEAD> + AWT: + <http://jogamp.org/git/?p=jogl.git;a=blob;f=src/test/com/jogamp/opengl/test/junit/jogl/tile/TestTiledPrintingGearsAWT.java;hb=HEAD> + Swing: + <http://jogamp.org/git/?p=jogl.git;a=blob;f=src/test/com/jogamp/opengl/test/junit/jogl/tile/TestTiledPrintingGearsSwingAWT.java;hb=HEAD> + +Print code: + AWTTilePainter (common code): + <http://jogamp.org/git/?p=jogl.git;a=blob;f=src/jogl/classes/jogamp/opengl/awt/AWTTilePainter.java;hb=HEAD> + GLCanvas: + <http://jogamp.org/git/?p=jogl.git;a=blob;f=src/jogl/classes/javax/media/opengl/awt/GLCanvas.java;hb=HEAD#l731> + ... +++ Enhance lifecycle for AWT printing via AWTPrintLifecycle: -Low-res print at 72dpi leaves the frame untouched, -where high-res print at 300dpi increases the frame size -to the reverse scale-factor. +We fit the frame into the imageable area with for 72 dpi, +assuming that is the default AWT painting density. +The frame borders are considered. + +The frame's scale factor 'scaleComp72' is used for the graphics print matrix +of the overall print-job, hence no frame resize is required. + +The GL scale factor 'scaleGLMatXY', 72dpi/glDPI, is passed to the GL object +which locally scales the print matrix and renders the scene with 1/scaleGLMatXY pixels. -Before printing and optional resize, we setup the GLCanvas: +Before printing, we setup the GLCanvas, ..: - move GLContext and GLEventListener -> offscreen - - destroy onscreen component w/ size equals of tile-size - This steps allows us to ensure we use limited GPU resources. -this is done w/ setupPrint(). + - offscreen is of tile-size + +this is performed w/ AWTPrintLifecycle.setupPrint(..). Impl. in GLCanvas, etc. -After printing, releasePrint() shall be called. Impl. in GLCanvas .. etc. +After printing, AWTPrintLifecycle.releasePrint() shall be called. Impl. in GLCanvas .. etc. + +To perform AWTPrintLifecycle on all component in one container, +one may use: + + final AWTPrintLifecycle.Context ctx = AWTPrintLifecycle.Context.setupPrint(frame, g2d, scaleGLMatXY, scaleGLMatXY); + try { + AWTEDTExecutor.singleton.invoke(true, new Runnable() { + public void run() { + frame.printAll(g2d); + } }); + } finally { + ctx.releasePrint(); + } + +++ @@ -41,13 +70,9 @@ TileRendererBase.TileRendererNotify interface! +++ -Screenshots/Bugs: - -You see the black raster, which shows each rendered tile. - -As you can see, we have different results w/ onscreen and offscreen -AWT printing. Both expose bugs regarding layout/scale of the AWT components. +Bugs: + - None in results -It would be interesting to learn what I am doing wrong w/ the printing setup -or GLCanvas rendering at print. + - GLCanvas: Workaround bug where onscreen MSAA cannot switch to offscreen FBO, + i.e. stay 'onscreen' |