Marlin-renderer

Marlin is an open source (GPL2 + CP) Java2D RenderingEngine optimized for performance (improved memory usage (~ no GC) and footprint, better multi-threading) and better visual quality based on openjdk's pisces implementation. It handles shape rendering (Graphics2D draw(Shape) / fill(Shape) with stroke & dash attributes only but it does it very well !

Release history

Latest release: https://github.com/bourgesl/marlin-renderer/releases/latest

For JavaFX, see the Marlin-FX project

News

• nov 2022: Marlin 0.9.4.6 integrated in OpenJDK 21
• jan 2021: Marlin 0.9.1.4 integrated in OpenJDK 17
• sep 2019: Marlin 0.9.1.3 integrated in OpenJDK 14
• aug 2019: Marlin 0.9.1.2 integrated in OpenJDK 14
• jul 2019: MarlinFX 0.9.3.1 integrated in OpenJFX 14, backported in OpenJFX 13
• oct 2018: MarlinFX 0.9.3 integrated in OpenJFX 12
• oct 2018: Marlin 0.9.1.1 backported to OpenJDK 11 updates (11.0.2)
• sep 2018: Marlin 0.9.1.1 integrated in OpenJDK 12
• jun 2018: MarlinFX 0.9.2 integrated in OpenJFX 11
• apr 2018: Marlin 0.9.1 integrated in OpenJDK 11
• dec 2017: Marlin & MarlinFX 0.8.2 integrated in OpenJDK & OpenJFX 10
• nov 2017: Marlin rocks on Geoserver benchmarks: see geoserver (including Marlin 0.8.2) vs geoserver-jai results: it boosts geoserver to achieve MapServer performance !!
• My personal point of view after javaone: it is your turn to contribute to OpenJDK & OpenJFX: see openjdk thread
• 4 oct 2017: JavaOne talk slides: Marlin, a JDK9 Success Story: Vector Graphics on Steroids for Java 2D and JavaFX
• may 2017: Marlin & MarlinFX 0.7.5 integrated in OpenJFX10 (enabled by default)
• feb 2017: Blog post comparing Oracle ductus vs OpenJDK Marlin renderers (latency) Performance Rendered Visual
• nov 2016: MarlinFX 0.7.5 integrated in OpenJFX9
• jul 2016: Marlin integrated in Jetbrains OpenJDK8 build and running in IntelliJ IDEA 2016.3
• feb 2016: FOSDEM talk slides Marlin renderer, a successful fork and join the OpenJDK 9 project
• dec 2015: Marlin 0.7.4 integrated in OpenJDK9

Build status

Continuous Integration base on Github Actions (build + unit & integration tests):

• Branch use_Unsafe (jdk8):
• Branch jdk (jdk11+):

License

As marlin is a fork from OpenJDK 8 pisces, its license is the OpenJDK's license = GPL2 + ClassPath exception:

GNU General Public License, version 2, with the Classpath Exception

The GNU General Public License (GPL)

Version 2, June 1991

See License.md

Performance

See the Benchmarks

Documentation

Documentation on how to use and tune the Marlin renderer is available in the wiki

Help is needed to improve the wiki & documentation !

Getting in touch

Users and developers interested in the Marlin-renderer are kindly invited to join the marlin-renderer Google Group.

Contributing

Contributions are welcomed, get in touch with us on the marlin-renderer Google Group and share your improvements via pull requests. Since we contribute this renderer into OpenJDK, we accept contributions from people that have signed the Oracle Contribution Agreeement (very easy to do)

Support our work

To support my efforts on improving either Java2D or JavaFX rendering thanks to the Marlin & MarlinFX projects, you can become my patron: https://www.patreon.com/user?u=9339017

Please help if you appreciate the Marlin project:

• share your benchmark & test results (quality ?)
• improve test cases, quality & unit tests, submit bug reports
• documentation should be improved & updated

Related projects

• Mapbench provides testing & benchmarking tools based on real world map painted by the GeoServer
• Marlin-FX provides the Marlin renderer port into JavaFX Prism (shape rasterizer)

Acknowledgments:

The Marlin renderer project benefits from the following tools:

• EJ-technologies Java Profiler

• supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.