This appendix presents properties that can be useful in troubleshooting Java 2D.
This appendix contains the following sections:
The following table describes the default values of some useful properties on Oracle Solaris and Linux platforms.
Table B-1 Default Java 2D Properties on Oracle Solaris and Linux
| Setup | DGA | SHM | Pixmaps | OnScreen | OffScreen |
|---|---|---|---|---|---|
|
Oracle Solaris SPARC with DGA support |
On |
On |
Off |
DGA/Software |
Software |
|
Oracle Solaris SPARC with no DGA, Oracle Solaris x86, Linux, SunRay, VNC |
Off |
On |
On |
X11/MITSHM |
Shared/Server Pixmaps |
|
J2SE 1.4 or greater: Remote X server, ssh |
Off |
Off |
On |
X11 |
Server Pixmaps |
|
J2SE 1.3.1 or less: Remote X server, ssh |
Off |
Off |
Off |
X11 |
Software |
The following list explains how to change the defaults.
The X11 pipeline is the default pipeline for Oracle Solaris and Linux. Change this default as follows:
-Dsun.java2d.opengl=true Attempt to enable the OpenGL pipeline.
The use of DGA is controlled as follows:
NO_J2D_DGA unset Use DGA, if available.
NO_J2D_DGA set Disable the use of DGA.
MIT Shared Memory Extension (SHM) is controlled as follows:
To use SHM, if available, specify either one of the following properties:
NO_J2D_MITSHM unset
J2D_USE_MITSHM=true
To not use SHM, specify either one of the following properties:
NO_J2D_MITSHM set
J2D_USE_MITSHM=false
The general use of pixmaps is controlled as follows:
-Dsun.java2d.pmoffscreen unset Use pixmaps if DGA is not available.
-Dsun.java2d.pmoffscreen=true Force the use of pixmaps.
-Dsun.java2d.pmoffscreen=false Disable the use of pixmaps.
The use of Shared and Server pixmaps is controlled as follows:
J2D_PIXMAPS unset Use both types.
J2D_PIXMAPS=shared Use only shared memory pixmaps.
J2D_PIXMAPS=sserver Use only server-side pixmaps.
The choice of default visual is controlled as follows:
FORCEDEFVIS unset (default) Use the best visual available.
FORCEDEFVIS set to a hexadecimal value Use the visual whose ID is the hexadecimal value.
FORCEDEFVIS set to any other value Use the default visual.
The following list describes some useful properties on Windows platforms.
The DirectDraw/GDI pipeline is the default pipeline for Windows. Change this default as follows:
-Dsun.java2d.noddraw=true Disable the use of DirectDraw pipeline. GDI will be used instead.
-Dsun.java2d.noddraw=false Enable the use of DirectDraw pipeline.
-Dsun.java2d.d3d=false Disable the use of Direct3D pipeline.
J2D_D3D=false Disable the use of Direct3D pipeline.
-Dsun.java2d.d3d=true Enable the use of Direct3D pipeline.
J2D_D3D=true Enable the use of Direct3D pipeline.
Control the use of the built-in surface punting mechanism as follows:
-Dsun.java2d.ddforcedram=true Keep volatile images in VRAM.
Control the use of DirectDraw blit operations as follows:
-Dsun.java2d.ddblit=false Disable the use of DirectDraw blit operations. GDI blits will be used instead.
