Documentation Contents
Java Platform, Standard Edition Troubleshooting Guide
Contents Previous Next

# 11.2 Windows OS - DirectDraw/GDI Pipeline

The default pipeline on the Windows platform is a mixture of the DirectDraw pipeline and the GDI pipeline, where some operations are performed with the DirectDraw pipeline and others with the GDI pipeline. DirectDraw and GDI APIs are used for rendering to accelerated offscreen and onscreen surfaces.

Starting with the Java SE 6 release, when the application enters full-screen mode, the new Direct3D pipeline can be used, if the drivers satisfy the requirements. Possible issues with the Direct3D pipeline include rendering artifacts, crashes, and performance related problems.

An additional pipeline, the OpenGL pipeline, might offer greater performance in some configurations.

The following are three cases to troubleshoot issues with Direct3D pipeline such as, rendering artifacts, crashes, and performance related problems.

- Disable DirectDraw pipeline:

  When DirectDraw is disabled, all operations are performed with GDI. Provide the following flag to disable the use of DirectDraw: `-Dsun.java2d.noddraw=true`. In this case all offscreen images will be created in the Java heap, and rendered to with the default software pipeline. All onscreen rendering, as well as copies of offscreen images to the screen will be performed using GDI.

- Enable DirectDraw pipeline:

  In case the pipeline was disabled by default for some reason, it can be enabled by providing the `-Dsun.java2d.noddraw=false` flag to the VM.

  However, typically there was a reason why it was disabled in the first place, so it is better not to force it.

- Disable built-in punting mechanism:

  In general, the DirectDraw pipeline attempts to place the offscreen surfaces in the framebuffer's video memory, which provides fast copies from these surfaces to the screen or other accelerated surfaces, as well as hardware accelerated rendering of certain graphics operations.

  To limit the impact of unaccelerated rendering to VRAM-based surfaces, there exists a punting mechanism, which moves the surface which is detected to be often read from to the system memory. If the surface is found to be copied from often enough, it may be promoted back to the video memory.

  However, if the pipeline cannot perform an operation using the DirectDraw API (operations using, for example, alpha compositing, or transforms, or antialiasing), the rendering is performed using the software pipeline. In some cases this means that the pixels of the destination surface, which resides in VRAM, need to be read into system memory, which is a very expensive operation.

  On certain video boards/drivers combinations the system-memory based DirectDraw surfaces are known to cause rendering artifacts and other issues. The DirectDraw pipeline provides a way to disable the punting mechanism so that the system memory surfaces are not used.

  To defeat the built-in surface punting mechanism provide the following flag to the Java VM: `-Dsun.java2d.ddforcevram=true`.

  Note: This can result in performance degradation, as the software loops may be reading pixels from VRAM on each operation. In this case you may consider disabling the DirectDraw pipeline (see above).

- Disable DirectDraw BILT operations:

  In a BILT operation (Bit Block Transfer), two bitmap patterns are combined. This operation basically corresponds to a call to the `Graphics.drawImage()` API.

  In some cases it is possible to avoid rendering problems by disabling the DirectDraw blit operations. GDI blits will be used instead. Note: This might result in bad performance. Consider disabling the DirectDraw pipeline instead.

  To disable the use of DirectDraw blit operations, pass the parameter `-Dsun.java2d.ddblit=false` to the Java VM.

Contents Previous Next

Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved.
Contact Us