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 like 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
| JDK | Default renderer | Latest Marlin release |
|---|---|---|
| Open JDK 6 - 7 [EOL] | Pisces | Marlin-renderer 0.9.4.3 |
| Oracle JDK 6 - 7 [EOL] | Ductus | Marlin-renderer 0.9.4.3 |
| Open JDK 8 [EOL] | Pisces | Marlin-renderer 0.9.4.7 for JDK8 |
| Oracle JDK 8 [EOL] | Ductus | Marlin-renderer 0.9.4.7 for JDK8 |
| Azul Zulu 8 | Marlin 0.7.4 / 0.9.1.1 | Marlin-renderer 0.9.4.7 for JDK8 |
| Jetbrains JDK 8 [EOL] | Marlin 0.7.4 / 0.9.3 | Marlin-renderer 0.9.4.7 for JDK8 |
| Open JDK 9 [EOL] | Marlin 0.7.4 | Marlin-renderer 0.9.4.2 for JDK9+ |
| Open JDK 10 [EOL] | Marlin 0.8.2 | Marlin-renderer 0.9.4.2 for JDK9+ |
| Open JDK 11 | Marlin 0.9.1 | Marlin-renderer 0.9.4.8 for JDK11+ |
| Open JDK 11.0.2 | Marlin 0.9.1.1 | Marlin-renderer 0.9.4.8 for JDK11+ |
| Open JDK 14 | Marlin 0.9.1.3 | Marlin-renderer 0.9.4.8 for JDK11+ |
| Open JDK 17 | Marlin 0.9.1.4 | Marlin-renderer 0.9.4.8 for JDK11+ |
| Open JDK 21 | Marlin 0.9.4.6 | Marlin-renderer 0.9.4.8 for JDK11+ |
| Open JDK 22 | Marlin 0.9.4.7 | Marlin-renderer 0.9.4.8 for JDK11+ |
For JavaFX, see the Marlin-FX project
News
- oct 2023: Marlin 0.9.4.7 integrated in OpenJDK 22
- 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 jdk (jdk11+):
- Branch use_Unsafe (jdk8) (left as is - not maintained since 2024.01):
License
As marlin is a fork from OpenJDK 8 Pisces source code, 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
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
To support my efforts on improving either Java2D or JavaFX rendering thanks to the Marlin & MarlinFX projects, you can use either patreon (https://www.patreon.com/user?u=9339017) or github sponsor (https://github.com/sponsors/bourgesl).
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 benefited from the following tools:
-
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.
