processing.core
Class PShape

java.lang.Object
  processing.core.PShape

All Implemented Interfaces:

PConstants

Direct Known Subclasses:

PShapeSVG

public class PShape
extends java.lang.Object
implements PConstants

In-progress class to handle shape data, currently to be considered of alpha or beta quality. Major structural work may be performed on this class after the release of Processing 1.0. Such changes may include:

• addition of proper accessors to read shape vertex and coloring data (this is the second most important part of having a PShape class after all).
• a means of creating PShape objects ala beginShape() and endShape().
• load(), update(), and cache methods ala PImage, so that shapes can have renderer-specific optimizations, such as vertex arrays in OpenGL.
• splitting this class into multiple classes to handle different varieties of shape data (primitives vs collections of vertices vs paths)
• change of package declaration, for instance moving the code into package processing.shape (if the code grows too much).

For the time being, this class and its shape() and loadShape() friends in PApplet exist as placeholders for more exciting things to come. If you'd like to work with this class, make a subclass (see how PShapeSVG works) and you can play with its internal methods all you like.

Library developers are encouraged to create PShape objects when loading shape data, so that they can eventually hook into the bounty that will be the PShape interface, and the ease of loadShape() and shape().

GROUP

public static final int GROUP

Generic, only draws its child objects.

See Also:

Constant Field Values

PRIMITIVE

public static final int PRIMITIVE

A line, ellipse, arc, image, etc.

See Also:

Constant Field Values

PATH

public static final int PATH

A series of vertex, curveVertex, and bezierVertex calls.

See Also:

Constant Field Values

GEOMETRY

public static final int GEOMETRY

Collections of vertices created with beginShape().

See Also:

Constant Field Values

width

public float width

height

public float height

VERTEX

public static final int VERTEX

See Also:

Constant Field Values

BEZIER_VERTEX

public static final int BEZIER_VERTEX

See Also:

Constant Field Values

CURVE_VERTEX

public static final int CURVE_VERTEX

See Also:

Constant Field Values

BREAK

public static final int BREAK

See Also:

Constant Field Values

PShape

public PShape()

PShape

public PShape(int family)

setName

public void setName(java.lang.String name)

getName

public java.lang.String getName()

isVisible

public boolean isVisible()

setVisible

public void setVisible(boolean visible)

disableStyle

public void disableStyle()

Overrides this shape's style information and uses PGraphics styles and colors. Identical to ignoreStyles(true). Also disables styles for all child shapes.

enableStyle

public void enableStyle()

Re-enables style information (fill and stroke) set in the shape.

getWidth

public float getWidth()

Get the width of the drawing area (not necessarily the shape boundary).

getHeight

public float getHeight()

Get the height of the drawing area (not necessarily the shape boundary).

post

public void post(PGraphics g)

draw

public void draw(PGraphics g)

Called by the following (the shape() command adds the g) PShape s = loadShapes("blah.svg"); shape(s);

drawImpl

public void drawImpl(PGraphics g)

Draws the SVG document.

getChildCount

public int getChildCount()

getChild

public PShape getChild(int index)

getChild

public PShape getChild(java.lang.String target)

findChild

public PShape findChild(java.lang.String target)

Same as getChild(name), except that it first walks all the way up the hierarchy to the farthest parent, so that children can be found anywhere.

addChild

public void addChild(PShape who)

translate

public void translate(float tx,
                      float ty)

translate

public void translate(float tx,
                      float ty,
                      float tz)

rotateX

public void rotateX(float angle)

rotateY

public void rotateY(float angle)

rotateZ

public void rotateZ(float angle)

rotate

public void rotate(float angle)

rotate

public void rotate(float angle,
                   float v0,
                   float v1,
                   float v2)

scale

public void scale(float s)

scale

public void scale(float sx,
                  float sy)

scale

public void scale(float x,
                  float y,
                  float z)

resetMatrix

public void resetMatrix()

applyMatrix

public void applyMatrix(PMatrix source)

applyMatrix

public void applyMatrix(PMatrix2D source)

applyMatrix

public void applyMatrix(float n00,
                        float n01,
                        float n02,
                        float n10,
                        float n11,
                        float n12)

apply

public void apply(PMatrix3D source)

applyMatrix

public void applyMatrix(float n00,
                        float n01,
                        float n02,
                        float n03,
                        float n10,
                        float n11,
                        float n12,
                        float n13,
                        float n20,
                        float n21,
                        float n22,
                        float n23,
                        float n30,
                        float n31,
                        float n32,
                        float n33)