# graphics2d-tester

**Repository Path**: kelch/graphics2d-tester

## Basic Information

- **Project Name**: graphics2d-tester
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-06-27
- **Last Updated**: 2023-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JFree Graphics2D Tester

Overview
--------
**JFree Graphics2D Tester** is a visual tester for implementations of Java2D's `Graphics2D` class.  The program generates a pre-defined set of outputs for any provided subclass of `Graphics2D` that can be compared against a known good result.  The following libraries (as well as others) can be tested this way:

- [JFreeSVG](https://github.com/jfree/jfreesvg)
- [JFreePDF](https://github.com/jfree/jfreepdf)
- [FXGraphics2D](https://github.com/jfree/fxgraphics2d)
- [SkijaGraphics2D](https://github.com/jfree/skijagraphics2d)
- [SkikoGraphics2D](https://github.com/jfree/skikographics2d)

By running through the features of `Graphics2D` systematically, this test kit is
able to highlight areas of weakness in a particular implementation.  The goal is to drive improvements in the
available implementations.

Target Output
-------------
The output of the `Graphics2D` target under test must be manually compared against the expected ("correct") output.  The expected output can be generated by running the test program against the `Graphics2D` instance used by Java2D itself 
when drawing to a `BufferedImage`.  For example, the following output is generated with Java 20 on MacOS:

![test-image](https://user-images.githubusercontent.com/1835893/232202698-a298b371-0528-4dc3-816e-d6a904469233.png)


Third Party Libraries
---------------------
The test kit uses several third party libraries:

- [ZXing](https://github.com/zxing/zxing) - used to create a QR code which is (a) part of the test and (b) provides a link to the `Graphics2D` implementation under test;

- [JFreeChart](https://github.com/jfree/jfreechart) - used to create a sample 2D chart;

- [Orson Charts](https://github.com/jfree/orson-charts) - used to create a sample 3D chart;

- [SteelSeries-Swing](https://github.com/HanSolo/SteelSeries-Swing) - used within the Java Swing UI demo to draw a dial.

License
-------
**Graphics2D Tester** is free software under the terms of the GNU General Public License version 3 (GPLv3) or later.  The license file (LICENSE) is included in this distribution.

    Please note that Graphics2D Tester is distributed WITHOUT ANY WARRANTY; without even 
    the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
    Please refer to the license for details.