1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
JFreePDF
========
Version 2.0.1, by David Gilbert, 6 November 2022.
(C)opyright 2013-2022, by David Gilbert. All rights reserved.
[](https://maven-badges.herokuapp.com/maven-central/org.jfree/org.jfree.pdf)
Overview
--------
JFreePDF is a library module for the Java(tm) platform that allows you to create content in Adobe's Portable Document Format (PDF) using the standard Java2D drawing API (`Graphics2D`). JFreePDF is light-weight, fast, and has no dependencies other than the Java runtime (11 or later). The home page for the project is:
https://github.com/jfree/jfreepdf
Getting Started
---------------
The Javadoc page for the `PDFDocument` class gives an example of typical usage.
Oracle provides tutorials for Java2D here:
http://docs.oracle.com/javase/tutorial/2d/
There are some demonstration applications included in the [JFree Demos](https://github.com/jfree/jfree-demos) project.
Include
-------
JFreePDF is published to the Central Repository. You can include it in your projects with the following dependency:
<dependency>
<groupId>org.jfree</groupId>
<artifactId>org.jfree.pdf</artifactId>
<version>2.0</version>
</dependency>
JFreePDF defines the module name `org.jfree.pdf`.
If you are using Java 8, an earlier version of this library (OrsonPDF) can be used instead:
<!-- https://mvnrepository.com/artifact/com.orsonpdf/orsonpdf -->
<dependency>
<groupId>com.orsonpdf</groupId>
<artifactId>orsonpdf</artifactId>
<version>1.9</version>
</dependency>
Build
-----
You can build JFreePDF from sources using Maven:
mvn clean install
Testing
-------
`JFreePDF` is being tested using [Graphics2D Tester](https://github.com/jfree/graphics2d-tester) and produces the output shown below.
Dual Licensing
--------------
JFreePDF is dual licensed. You can use JFreePDF under the terms of the GNU General Public License version 3 (GPLv3) or later. If you prefer not to be bound by the terms of the GPLv3, an alternative license is available to JFree sponsors.
JFreePDF integrates the `Ascii85OutputStream` class written by Ben Upsavs and distributed freely under the (BSD-style) terms listed in the `Ascii85OutputStream-license.txt file`.
Change History
--------------
Version 2.0.1 (6 November 2022)
- fix various warnings
- update Maven plugin versions in pom.xml
- updated JUnit to version 5.9.1.
Version 2.0 (1 March 2020)
- converted to a Java module;
- renamed `OrsonPDF` to `JFreePDF`.
|
