Overview of Flying Saucer
mainFlying Saucer is a pure-Java library designed to render well-formed XML or XHTML using CSS 2.1 for layout and formatting. It supports multiple output targets including Swing panels, PDF, and images.
Flying Saucer Documentation
repository·main·Indexed 25 days ago
https://github.com/flyingsaucerproject/flyingsaucerA pure-Java library for rendering well-formed XML or XHTML using CSS 2.1. It enables the conversion of web-like markup into PDF, images, Swing components, and SWT output. The library provides specific artifacts for different targets, including flying-saucer-core, flying-saucer-pdf, and flying-saucer-chrome-pdf.
What's inside Flying Saucer
Install Flying Saucer via Maven
mainFlying Saucer is distributed through Maven. Choose the artifact that matches your required output format:
org.xhtmlrenderer:flying-saucer-core: Core library and Java2D rendering.org.xhtmlrenderer:flying-saucer-pdf: PDF output using OpenPDF.org.xhtmlrenderer:flying-saucer-chrome-pdf: PDF output by delegating tochrome-headless-shell(supports modern HTML5/CSS3).org.xhtmlrenderer:flying-saucer-swt: SWT output.org.xhtmlrenderer:flying-saucer-log4j: Logging plugin for log4j.
Note:
org.xhtmlrenderer:flying-saucer-pdf-openpdfis deprecated and has been replaced byflying-saucer-pdf.Key Entry Points for Rendering
mainDepending on your target output, use the following classes as entry points:
- Swing/UI:
org.xhtmlrenderer.simple.XHTMLPanel - PDF:
org.xhtmlrenderer.pdf.PDFRenderer - Images:
org.xhtmlrenderer.simple.ImageRenderer - Browser Demo:
org.xhtmlrenderer.demo.browser.BrowserStartup
- Swing/UI:
Java Version Compatibility
mainEnsure your project uses a compatible Java version based on the Flying Saucer version you are using:
- v10.0.0 and later: Requires Java 21 or later.
- v9.6.0 to v9.9.x: Requires Java 17 or later.
- v9.5.0 to v9.5.x: Requires Java 11 or later.