Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eseifert/vectorgraphics2d

Graphics2D implementations to export various vector file formats
https://github.com/eseifert/vectorgraphics2d

eps hacktoberfest hacktoberfest2022 java java-library java2d pdf pdf-generation svg

Last synced: 3 days ago
JSON representation

Graphics2D implementations to export various vector file formats

Awesome Lists containing this project

README 

        
.. image:: https://eseifert.github.io/vectorgraphics2d/logo.png



.. image:: https://travis-ci.org/eseifert/vectorgraphics2d.svg?branch=master

    :target: https://travis-ci.org/eseifert/vectorgraphics2d



This project is archived.

VectorGraphics2D has been relicensed under EPL-2.0 and subsequently integrated

into `Eclipse SWTChart `_

(`GitHub `_)



VectorGraphics2D

================



VectorGraphics2D provides implementations of Java's ``Graphics2D`` interface and

exports the graphics in various vector file formats.

Currently, there's support for the following vector file formats:



- Encapsulated PostScript® (EPS)

- Scalable Vector Graphics (SVG)

- Portable Document Format (PDF)



Additional formats can be easily added.



Features

--------



- Support for EPS, PDF, and SVG formats

- Rendering of all geometric shapes provided by the java.awt.Graphics2D interface

- Shapes and text can be made transparent (except in EPS)

- Arbitrary clipping paths can be defined

- Output of bitmap images

- Easily extensible

- Small footprint (JAR is below 100 kilobytes)



Currently, most operations are supported, i.e. VectorGraphics2D is able to handle clipping gradients, or compression.

Some features are still missing, like text encodings, embedded fonts, or metadata support.

Although its early stage VectorGraphics2D is already used successfully in several projects to export vector graphics.



Requirements

============



VectorGraphics2D requires at least Java 8 and Gradle 5 or higher to build.



Installation

============



Without build management system

-------------------------------



You can just add ``VectorGraphics2D-0.13.jar`` to the classpath of your project.



Using VectorGraphics2D with Gradle

----------------------------------



.. code:: groovy

    dependencies {

        compile group: 'de.erichseifert.vectorgraphics2d', name: 'VectorGraphics2D', version: '0.13'

    }



Usage

=====



A ``VectorGraphics2D`` object can be used as a replacement for a ``Graphics2D``

object. All calls to the ``VectorGraphics2D`` instance will be recorded and can

later be retrieved as a ``CommandSequence``:



.. code:: java



    Graphics2D vg2d = new VectorGraphics2D();

    vg2d.draw(new Rectangle2D.Double(0.0, 0.0, 20.0, 20.0));

    CommandSequence commands = ((VectorGraphics2D) vg2d).getCommands();



This command sequence can then be exported to a EPS, PDF or SVG document using

a processor for the desired file type, i.e. ``EPSProcessor`` for EPS,

``PDFProcessor`` for PDF and ``SVGProcessor`` for SVG. Additionally, format

specific output options can be passed to the processor when it is created.

For example, a compression option can be passed for PDF:



.. code:: java



    PDFProcessor pdfProcessor = new PDFProcessor(true);



Another method to get a processor is ``Processors.get(String)``:



.. code:: java



    Processor pdfProcessor = Processors.get("pdf");



Finally, a document can be generated from the commands and written to an output

stream:



.. code:: java



    Document doc = pdfProcessor.getDocument(commands, PageSize.A4);

    doc.writeTo(new FileOutputStream("rect.pdf"));