patchy

Class Patch

java.lang.Object

patchy.Patch

All Implemented Interfaces:

Patchy

public class Patch
extends java.lang.Object
implements Patchy

Provides an easy-to-use bicubic patch for Processing. You construct it with a 4x4 collection of control points, then simply call its draw() method as needed. The control points can be given as a 4x4 array of PVectors, 3 4x4 arrays of floats (interprested as the x, y, and z coordinates respectively), or 3 4x4 arrays of doubles (interpreted like the floats). All internal operations are done in double-precision, which is then rounded down for drawing in PApplet. A Patch has a BoundingVolume, which is useful for scaling and positioning when drawing. This class is not thread-safe. In particular, if you modify a Patch's control points while another thread is calling draw() on the same instance, results are undefined.

Author:

jdf

Field Summary

Fields inherited from interface patchy.Patchy

BEZIER, BSPLINE, CATMULL_ROM, HERMITE

Method Summary

Methods

Modifier and Type	Method and Description
static Patch	create(double[][] basis, double[][] cpX, double[][] cpY, double[][] cpZ)
static Patch	create(double[][] basis, double[][] cpX, double[][] cpY, double[][] cpZ, int gridSteps)
static Patch	create(double[][] basis, float[][] cpX, float[][] cpY, float[][] cpZ)
static Patch	create(double[][] basis, float[][] cpX, float[][] cpY, float[][] cpZ, int gridSteps)
static Patch	create(double[][] basis, PVector[][] controlPoints)
static Patch	create(double[][] basis, PVector[][] controlPoints, int gridSteps)
void	draw(PApplet p)
void	draw(PApplet p, PImage texture)
void	drawControlPoints(PApplet p)
BoundingVolume	getBounds()
BoundingVolume	scale(double scale)
void	set(int row, int col, double x, double y, double z)
void	set(int row, int col, PVector cp)
void	setBasis(double[][] basis) Set the basis matrix for this
void	setGridSteps(int gridSteps) Sets the "smoothness" of the rendered patch.
void	setX(int row, int col, double val)
void	setY(int row, int col, double val)
void	setZ(int row, int col, double val)
void	translate(double dx, double dy, double dz)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static Patch create(double[][] basis,
           PVector[][] controlPoints)

create

public static Patch create(double[][] basis,
           PVector[][] controlPoints,
           int gridSteps)

create

public static Patch create(double[][] basis,
           float[][] cpX,
           float[][] cpY,
           float[][] cpZ)

create

public static Patch create(double[][] basis,
           float[][] cpX,
           float[][] cpY,
           float[][] cpZ,
           int gridSteps)

create

public static Patch create(double[][] basis,
           double[][] cpX,
           double[][] cpY,
           double[][] cpZ)

create

public static Patch create(double[][] basis,
           double[][] cpX,
           double[][] cpY,
           double[][] cpZ,
           int gridSteps)

getBounds

public BoundingVolume getBounds()

Specified by:

getBounds in interface Patchy

set

public void set(int row,
       int col,
       double x,
       double y,
       double z)

set

public void set(int row,
       int col,
       PVector cp)

setX

public void setX(int row,
        int col,
        double val)

setY

public void setY(int row,
        int col,
        double val)

setZ

public void setZ(int row,
        int col,
        double val)

setBasis

public void setBasis(double[][] basis)

Description copied from interface: Patchy

Set the basis matrix for this

Specified by:

setBasis in interface Patchy

setGridSteps

public void setGridSteps(int gridSteps)

Description copied from interface: Patchy

Sets the "smoothness" of the rendered patch.

When generating the triangle mesh for this patch, use gridSteps X gridSteps vertices. Therefore, the cost of rendering this patch rises as the square of this parameter.

The default value is 20.

Specified by:

setGridSteps in interface Patchy

scale

public BoundingVolume scale(double scale)

Specified by:

scale in interface Patchy

translate

public void translate(double dx,
             double dy,
             double dz)

Specified by:

translate in interface Patchy

draw

public void draw(PApplet p)

Specified by:

draw in interface Patchy

draw

public void draw(PApplet p,
        PImage texture)

Specified by:

draw in interface Patchy

drawControlPoints

public void drawControlPoints(PApplet p)

Specified by:

drawControlPoints in interface Patchy