COPYRIGHT
---------------
Copyright 2006-2008 Ricard Marxer <[email protected]>
This product includes software developed by the Solution Engineering, Inc. (http://www.seisw.com/).
This product includes software developed by the The Apache Software Foundation (http://www.apache.org/).
INSTALL
---------------
Unzip the geomerative-XX.zip in the Processing libraries directory.
The result shoul look like this:
/path/to/processing/libraries/geomerative/library/geomerative.jar
USAGE
---------------
In the Processing IDE Sketch > Import Library > geomerative
DOCUMENTATION
---------------
The documentation is in the documentation folder. Just open the index.html with any web browser.
MINI-TUTORIAL
---------------
This geometry library consists of three main classes:
RShape - Contains subshapes formed of commands (move,lines,beziers,...)
RPolygon - Contains contours formed of points
RMesh - Contains strips formed of vertices
There are several uses of the library:
+ Draw shapes with holes, in order to do so, we create a new shape and add commands to it. Once the shape is created we can:
- draw it using draw(g) (note the use of g in order to draw the shape to the main PGraphics object)
- convert it to a polygon using toPolygon()
- acces its subshapes' commands or the points of these commands, accesing its attribute subshapes and the RSubshape methods
+ Draw polygons with holes, in order to do so, we create a new polygon and add points (addPoint(x,y)) or contours (addContour()) to it. Once the polygon is created we can:
- draw it using draw(g)
- convert it to a mesh using toMesh()
- acces its contours' points, accesing its attribute contours and the RContour methods
- do binary operations over two polygons, using the methods diff(), union(), xor() and intersection()
EXAMPLE
--------------
/// Example to draw a simple shape with a hole
/// Converting the shape to a mesh in the setup() avoids having to tesselate it for each frame, therefore the use of RMesh
import geomerative.*;
RPolygon p;
RShape s;
RMesh m;
int t = 0;
void setup(){
size(100,100,P3D);
framerate(34);
background(255);
fill(0);
//noFill();
stroke(255,0,0);
s = new RShape();
s.addMoveTo(-30,250);
s.addLineTo(30,150);
s.addArcTo(50,75,100,30);
s.addBezierTo(130,90,75,100,90,150);
s.addLineTo(130,250);
s.addBezierTo(80,200,70,200,-30,250);
s.addMoveTo(60,120);
s.addBezierTo(75,110,85,130,75,140);
s.addBezierTo(70,150,65,140,60,120);
p = s.toPolygon(100);
m = p.toMesh();
}
void draw(){
scale(0.25);
translate(200,50);
background(255);
rotateY(PI/65*t);
fill(0);
m.draw(g);
rotateY(PI/64*t);
noFill();
p.draw(g);
t++;
}
/// End of example
/// Example calculating the difference of two polygons
/// Note the use of predefined polygons (createStar(), createCircle(), createRing(),...)
import geomerative.*;
RMesh m;
RPolygon p = RPolygon.createStar(120,70,6);
RPolygon p2 = RPolygon.createStar(60,50,30);
float t=0;
void setup(){
size(400,400,P3D);
framerate(24);
//smooth();
noStroke();
fill(0);
p=p.diff(p2);
m = p.toMesh();
}
void draw(){
background(255);
translate(width/2,height/2);
rotateX(t/39);
m.draw(g);
rotateY(-t/5);
scale(0.3);
m.draw(g);
t++;
}
/// End of example
KNOWN ISSUES
-------------
- Under certain renderers there's a big loss of precision, resulting in really ugly renderings of fonts and polygons in general.
- When we decrease the font size we get bad results, bad shapes. This must have to do with the font fixed point arithmetics, haven't studied any of that yet.
