omouse / ohprocessing

OhProcessing

== About ==

OhProcessing is a GIT version of the SVN repo at
    http://dev.processing.org/

It  is a  smaller  version of  the  processing codebase  and does  NOT
include binaries. It does include build tools to generate the binaries
needed and to package them all up into a release of Processing.

There is a  list of dependencies as well because  many of the binaries
were compiled versions of  the dependencies. But we're all programmers
here right? Not scared of downloading a few dependencies right? :)

To discuss OhProcessing, email Rudolf Olah at omouse@gmail.com

== License ==

Most of  the code is  covered by the  GNU General Public version  2 or
later. There are some parts that use a different license.

== Building the Core Processing Environment ==

=== Tools Required ===

The  following tools  are  required  to build  a  distribution of  the
Processing environment:

  * git
  * a C/C++ compiler (GCC or Microsoft Visual C++)
  * Maven 2

=== Dependencies ===

The following software libraries and packages are required by the core
code or libraries used by the Processing environment:

  * ANTLR Parser Generator, version 2.x
    required for the core
      http://antlr.org/
  * JNA (Java Native Access)
    required for the core
      https://jna.dev.java.net/
  * Eclipse java bytecode compiler
    required for the core
  * QuickTime for Java
    required only on Windows, for the video library
      http://developer.apple.com/quicktime/qtjava/
  * GlueGen
    required for the opengl library
      https://gluegen.dev.java.net/
  * JOGL
    required for the opengl library
      https://jogl.dev.java.net/
  * DXFViewer
    required for the dxf library
      http://www.escape.de/~quincunx/dxfviewer/index.html
  * iText
    required for the pdf library
      http://www.lowagie.com/iText/
  * RXTX
    required for the serial library
      http://users.frii.com/jarvi/rxtx/

Most  of these  dependencies  are  in the  Maven  repository, and  are
downloaded   and  installed   automatically  when   trying   to  build
Processing.

== Building the Core ==

The JAR  (Java ARchive) files that  are needed for  the compilation of
Processing are  stored in the  ``bin'' directory. Place  the following
files in that directory:

  * ecj.jar (from the Eclipse compiler package)
  * apple.jar

If you are on a Linux, you can  use `ln` to create a link to the files
(while in the bin sub-directory of ohprocessing) like this:

    ln -s /usr/share/java/ecj.jar ecj.jar

== Building the Libraries ==

The  following  libraries  are   included  with  the  main  Processing
distribution:

  * dxf
  * net
  * opengl
  * pdf
  * serial
  * video

== Creating a Release of Processing ==