Clazzes.org Sketch is a framework which provides 2D Vector Graphics for web applications. The project provides PDF-compatible shapes with double-precision coordinates and a HTML5 user frontend which works in all modern browsers, using Google Web Toolkit (GWT). It includes a Scientific Shapes component for rendering charts and tables of large data-sets.
All aspects of the project are highly modular and OSGi compliant, making it possible to only include only selected shapes and/or capabilities.
Due to the great modularity, clazzes.org Sketch relies on Maven for the build process. It is not advisable to attempt to build it without.
The framework consists of 3 major components:
- Server-side data-object abstraction with de-/serialization capabilities to JSON and XML
- PDF rendering components
- A browser-based GUI frontend using GWT, which provides full drawing capabilites.
Each of these provides one Maven parent project (ending in
-main) and four basic modules:
serializable-entitiesprovides basic entities needed for depicting the graphics, like drawing, layer, stroke-, fill- and colour-palettes, etc.
richtextprovides an abstraction of basic formatted text
shapesprovides basic geometric shapes like rectangles, ellipses, lines etc.
scientific-shapesprovides charts and tables for representing data from external providers
scientific-shapes depend on
serializable-entities, but are independent of each other.
Server-side modules provide a data-model, and serializers for JSON (to communicate with the web front-end) and XML (for storage). The XML format is defined by modular schema files, which are also provided at the following URLs:
The format of the JSON serialization strings largely follows the schema definitions.
PDF-generation modules are by definition also server-side, as they rely on the data model. They produce standards-compliant PDF files using apache PDFbox.
The user interface utilizes a html5 canvas to depict the scenery, while retaining information about the position of each object for interaction.
Source code and issue tracker
At the moment, available documentation is still rather sparse, but the classes are well documented. If you want to give it a try, you can check out the components at the following SVN repositories:
- http://svn.clazzes.org/svn/sketch/trunk/main (Core)
- http://svn.clazzes.org/svn/sketch/trunk/pdf (drawing to PDF files)
- http://svn.clazzes.org/svn/sketch/trunk/gwt (drawing in GWT based web applications)
The JIRA projects are:
- SKETCH (Core)
- PDFSKETCH (drawing to PDF files)
- GWTSKETCH (drawing in GWT based web applications)
- LABELENT (Creating labels, like address labels)