B Java 2D Properties
This appendix presents properties that can be useful in troubleshooting Java 2D.
This appendix contains the following sections:
Properties on Oracle Solaris and Linux
List of Java 2D properties on Oracle Solaris and Linux.
Table B-1 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.
-
Properties on Windows
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 the DirectDraw pipeline. GDI will be used instead. -
-Dsun.java2d.noddraw=false
— Enable the use of the DirectDraw pipeline. -
-Dsun.java2d.d3d=false
— Disable the use of the Direct3D pipeline. -
J2D_D3D=false
— Disable the use of the Direct3D pipeline. -
-Dsun.java2d.d3d=true
— Enable the use of the Direct3D pipeline. -
J2D_D3D=true
— Enable the use of the 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.
-