Foreward

While working on improvements for VTerminal and various unreleased Java2D projects, I came across "Blazing-fast Java2D Rendering" which led me to the creation of the *Renderer classes in this repository.

From what I recall, I originally began by copying-over all of the renderer classes from Xyene's Nitrous-Emulator. It took some time to understand this original codebase, but I took my time and eventually got to a point where I felt comfortable working with the code.

Now that I was comfortable with his code, I took to reworking it in a way that would be a bit easier for me to implement and work with in various other projects.

Much of the code is the same as Xyene originally wrote it. My major changes are in the naming of classes and the addition of documentation, convenience methods, as well as minor code refactoring.

Although these renderers, at least the ones that I could test on my available machines, did work reasonably well, I didn't encounter the massive performance improvements that Xyene's original blog post described.

It could be my specific use-cases, which led to disappointing results, but this project ultimately led me to believe that significant performance increases can be found by optimizing your use of the existing Swing classes and working to better understand the graphics pipeline.

If you're inclined to continue working on this project, please feel free to submit a PR or to fork the repository. Ensure that you give credit to Xyene for his original implementation, where applicable. I don't require any attribution for my changes to his code, but it is appreciated.

Usage

Before you can properly use any of the renderers in another project, you must update the base Renderer class and make adjustments in the blitBufferToSurface and getBufferGraphics2D functions. Additional adjustments can be made in the applyRenderHints function, but they are not required.

You can test the renderers by modifying the com.valkryst.Java2DRenderers.Driver class in the src/test/java/com.valkryst.Java2DRenderers directory.

Notes

Compiling

To compile the renderer classes, you may need to add the following flags in your call to javac.

--add-exports java.desktop/java.awt.peer=ALL-UNNAMED
--add-exports java.desktop/sun.java2d=ALL-UNNAMED
--add-exports java.desktop/sun.java2d.pipe.hw=ALL-UNNAMED
--add-exports java.desktop/sun.java2d.d3d=ALL-UNNAMED

If you encounter the exporting a package from system module java.desktop is not allowed with --release exception, then you will need to uncheck the Use '--release' option for cross-compilation (Java 9 and later) option in the Build, Execution, Deployment > Compiler > Java Compiler settings view.

Running

If you encounter the An illegal reflective access operation has occurred exception, then you will need to run your program with the --illegal-access=permit argument.