Flying Saucer

Flying Saucer is a CSS 2.1 renderer written in Java. It supports Java2D, PDF, and SWT output.

License	GNU Lesser General Public License (LGPL), version 2.1 or later
GroupId	org.xhtmlrenderer
ArtifactId	flying-saucer-parent
Last Version	9.1.22
Release Date	Apr 29, 2021
Type	pom
Description	Flying Saucer Flying Saucer is a CSS 2.1 renderer written in Java. It supports Java2D, PDF, and SWT output.
Project URL	http://code.google.com/p/flying-saucer/

Download flying-saucer-parent

Filename	Size
flying-saucer-parent-9.1.22.pom	2 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.xhtmlrenderer/flying-saucer-parent/ -->
<dependency>
    <groupId>org.xhtmlrenderer</groupId>
    <artifactId>flying-saucer-parent</artifactId>
    <version>9.1.22</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.xhtmlrenderer/flying-saucer-parent/
implementation 'org.xhtmlrenderer:flying-saucer-parent:9.1.22'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.xhtmlrenderer/flying-saucer-parent/
implementation ("org.xhtmlrenderer:flying-saucer-parent:9.1.22")

Apache Buildr

'org.xhtmlrenderer:flying-saucer-parent:pom:9.1.22'

Apache Ivy

<dependency org="org.xhtmlrenderer" name="flying-saucer-parent" rev="9.1.22">
  <artifact name="flying-saucer-parent" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.xhtmlrenderer', module='flying-saucer-parent', version='9.1.22')
)

Scala SBT

libraryDependencies += "org.xhtmlrenderer" % "flying-saucer-parent" % "9.1.22"

Leiningen

[org.xhtmlrenderer/flying-saucer-parent "9.1.22"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• flying-saucer-core
• flying-saucer-pdf
• flying-saucer-pdf-osgi
• flying-saucer-pdf-itext5
• flying-saucer-log4j
• flying-saucer-swt
• flying-saucer-swt-examples
• flying-saucer-examples
• flying-saucer-fop

Flying Saucer

OVERVIEW

Flying Saucer is a pure-Java library for rendering arbitrary well-formed XML (or XHTML) using CSS 2.1 for layout and formatting, output to Swing panels, PDF, and images.

Comprehensive documentation available in our user's guide, linked from our website at https://code.google.com/archive/p/flying-saucer/

For information on our development releases, please contact us on our mailing lists.

If you end up using Flying Saucer for your own projects, please drop us an email and tell us about it; it helps inform where we go next, and is interesting and inspiring to other developers.

LICENSE

Flying Saucer is distributed under the LGPL. Flying Saucer itself is licensed under the GNU Lesser General Public License, version 2.1 or later, available at http://www.gnu.org/copyleft/lesser.html. You can use Flying Saucer in any way and for any purpose you want as long as you respect the terms of the license. A copy of the LGPL license is included as LICENSE-LGPL-2.1.txt or LICENSE-LGPL-3.txt in our distributions and in our source tree.

Flying Saucer uses a couple of FOSS packages to get the job done. A list of these, along with the license they each have, is listed in the LICENSE file in our distribution.

GETTING FLYING SAUCER

New releases of Flying Saucer are distributed through Maven. The available artifacts are:

• org.xhtmlrenderer:flying-saucer-core - Core library and Java2D rendering
• org.xhtmlrenderer:flying-saucer-pdf - PDF output using iText 2.x
• org.xhtmlrenderer:flying-saucer-pdf-itext5 - PDF output using iText 5.x
• org.xhtmlrenderer:flying-saucer-pdf-openpdf - PDF output using OpenPDF
• org.xhtmlrenderer:flying-saucer-swt - SWT output
• org.xhtmlrenderer:flying-saucer-log4j - Logging plugin for log4j

iText 2.x has unfixed security bugs. New projects should avoid it.

GETTING STARTED

There is a large amount of sample code under the flying-saucer-examples directory.

flying-saucer-core, flying-saucer-pdf, and flying-saucer-swt must be on the build path, as well as the SWT JAR for your OS.

org.xhtmlrenderer.demo.browser.BrowserStartup will start the browser demo.

Some good entry points (classes) are:

• org.xhtmlrenderer.simple.XHTMLPanel
• org.xhtmlrenderer.simple.PDFRenderer
• org.xhtmlrenderer.simple.ImageRenderer

STATE OF THE PROJECT

Ongoing discussions are carried out in our online discussion group.

Excerpt from the latest merge/release policy:

If you create a PR that can merge without conflicts, I'll merge it. I might ask for additional changes (or feedback from others), but I expect that will be extremely rare.

The basic contract is this: If you're still using Flying Saucer, need something changed, and are willing to do the work yourself, the change will be accepted and released.

Along that line, please also let me know if you need a release done right away. Otherwise I'll bundle up the changes and do a release every four to six months as long as it's required.

This is also the reason why Issues are currently deactivated on GitHub.

HISTORIC LINKS

• Google Code project page (archived/read-only)
• Google Code Issues (archived/read-only)

Versions

Version
9.1.22 Apr 29, 2021
9.1.21 Apr 22, 2021
9.1.20 Jan 10, 2020
9.1.19 Nov 13, 2019
9.1.18 Mar 6, 2019
9.1.17 Mar 6, 2019
9.1.16 Oct 1, 2018
9.1.15 Aug 9, 2018
9.1.14 Jul 8, 2018
9.1.13 May 15, 2018
9.1.12 Feb 20, 2018
9.1.11 Jan 4, 2018
9.1.9 Nov 8, 2017
9.1.8 Nov 7, 2017
9.1.7 Sep 10, 2017
9.1.6 Jun 7, 2017
9.1.5 Mar 28, 2017
9.1.4 Mar 12, 2017
9.1.3 Mar 10, 2017
9.1.2 Mar 9, 2017
9.1.1 Nov 26, 2016
9.1.0 Oct 30, 2016
9.0.9 Apr 8, 2016
9.0.8 Sep 3, 2015
9.0.7 Oct 15, 2014
9.0.6 Mar 26, 2014
9.0.4 Oct 7, 2013
9.0.3 Sep 4, 2013
9.0.2 Apr 26, 2013
9.0.1 Jul 25, 2012
9.0.0 Jul 15, 2012