/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */

/*
  Part of the Processing project - http://processing.org

  Copyright (c) 2006-10 Ben Fry and Casey Reas

  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License version 2.1 as published by the Free Software Foundation.

  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General
  Public License along with this library; if not, write to the
  Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  Boston, MA  02111-1307  USA
*/

package processing.core;

import java.util.HashMap;
import java.util.Map;

import processing.core.PApplet;


/**
 * ( begin auto-generated from PShape.xml )
 *
 * Datatype for storing shapes. Processing can currently load and display
 * SVG (Scalable Vector Graphics) shapes. Before a shape is used, it must
 * be loaded with the <b>loadShape()</b> function. The <b>shape()</b>
 * function is used to draw the shape to the display window. The
 * <b>PShape</b> object contain a group of methods, linked below, that can
 * operate on the shape data.
 * <br /><br />
 * The <b>loadShape()</b> function supports SVG files created with Inkscape
 * and Adobe Illustrator. It is not a full SVG implementation, but offers
 * some straightforward support for handling vector data.
 *
 * ( end auto-generated )
 * <h3>Advanced</h3>
 *
 * 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:
 *
 * <ul>
 * <li> 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).
 * <li> a means of creating PShape objects ala beginShape() and endShape().
 * <li> load(), update(), and cache methods ala PImage, so that shapes can
 * have renderer-specific optimizations, such as vertex arrays in OpenGL.
 * <li> splitting this class into multiple classes to handle different
 * varieties of shape data (primitives vs collections of vertices vs paths)
 * <li> change of package declaration, for instance moving the code into
 * package processing.shape (if the code grows too much).
 * </ul>
 *
 * <p>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.</p>
 *
 * <p>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().</p>
 *
 * @webref shape
 * @usage Web &amp; Application
 * @see PApplet#loadShape(String)
 * @see PApplet#createShape()
 * @see PApplet#shapeMode(int)
 * @instanceName sh any variable of type PShape
 */
public class PShape implements PConstants {

    /**
     *
     */
    protected String name;

    /**
     *
     */
    protected Map<String,PShape> nameTable;

//  /** Generic, only draws its child objects. */
//  static public final int GROUP = 0;
  // GROUP now inherited from PConstants, and is still zero

  // These constants were updated in 3.0b6 so that they could be distinguished
  // from others in PConstants and improve how some typos were handled.
  // https://github.com/processing/processing/issues/3776
  /** A line, ellipse, arc, image, etc. */
  static public final int PRIMITIVE = 101;
  /** A series of vertex, curveVertex, and bezierVertex calls. */
  static public final int PATH = 102;
  /** Collections of vertices created with beginShape(). */
  static public final int GEOMETRY = 103;
  /** The shape type, one of GROUP, PRIMITIVE, PATH, or GEOMETRY. */
  protected int family;

  /** ELLIPSE, LINE, QUAD; TRIANGLE_FAN, QUAD_STRIP; etc. */
  protected int kind;

    /**
     *
     */
    protected PMatrix matrix;

    /**
     *
     */
    protected int textureMode;

  /** Texture or image data associated with this shape. */
  protected PImage image;

    /**
     *
     */
    public static final String OUTSIDE_BEGIN_END_ERROR =
    "%1$s can only be called between beginShape() and endShape()";

    /**
     *
     */
    public static final String INSIDE_BEGIN_END_ERROR =
    "%1$s can only be called outside beginShape() and endShape()";

    /**
     *
     */
    public static final String NO_SUCH_VERTEX_ERROR =
    "%1$s vertex index does not exist";

    /**
     *
     */
    static public final String NO_VERTICES_ERROR =
    "getVertexCount() only works with PATH or GEOMETRY shapes";

    /**
     *
     */
    public static final String NOT_A_SIMPLE_VERTEX =
    "%1$s can not be called on quadratic or bezier vertices";

    /**
     *
     */
    static public final String PER_VERTEX_UNSUPPORTED =
    "This renderer does not support %1$s for individual vertices";

  /**
   * ( begin auto-generated from PShape_width.xml )
   *
   * The width of the PShape document.
   *
   * ( end auto-generated )
   * @webref pshape:field
   * @usage web_application
   * @brief     Shape document width
   * @see PShape#height
   */
  public float width;
  /**
   * ( begin auto-generated from PShape_height.xml )
   *
   * The height of the PShape document.
   *
   * ( end auto-generated )
   * @webref pshape:field
   * @usage web_application
   * @brief     Shape document height
   * @see PShape#width
   */
  public float height;

    /**
     *
     */
    public float depth;

  PGraphics g;

  // set to false if the object is hidden in the layers palette

    /**
     *
     */
  protected boolean visible = true;

    /** Retained shape being created with beginShape/endShape */
  protected boolean openShape = false;

    /**
     *
     */
    protected boolean openContour = false;

    /**
     *
     */
    protected boolean stroke;

    /**
     *
     */
    protected int strokeColor;

    /**
     *
     */
    protected float strokeWeight; // default is 1

    /**
     *
     */
    protected int strokeCap;

    /**
     *
     */
    protected int strokeJoin;

    /**
     *
     */
    protected boolean fill;

    /**
     *
     */
    protected int fillColor;

    /**
     *
     */
    protected boolean tint;

    /**
     *
     */
    protected int tintColor;

    /**
     *
     */
    protected int ambientColor;

    /**
     *
     */
    protected boolean setAmbient;

    /**
     *
     */
    protected int specularColor;

    /**
     *
     */
    protected int emissiveColor;

    /**
     *
     */
    protected float shininess;

    /**
     *
     */
    protected int sphereDetailU,

    /**
     *
     */
    sphereDetailV;

    /**
     *
     */
    protected int rectMode;

    /**
     *
     */
    protected int ellipseMode;

  /** Temporary toggle for whether styles should be honored. */
  protected boolean style = true;

  /** For primitive shapes in particular, params like x/y/w/h or x1/y1/x2/y2. */
  protected float[] params;

    /**
     *
     */
    protected int vertexCount;
  /**
   * When drawing POLYGON shapes, the second param is an array of length
   * VERTEX_FIELD_COUNT. When drawing PATH shapes, the second param has only
   * two variables.
   */
  protected float[][] vertices;

    /**
     *
     */
    protected PShape parent;

    /**
     *
     */
    protected int childCount;

    /**
     *
     */
    protected PShape[] children;


  /** Array of VERTEX, BEZIER_VERTEX, and CURVE_VERTEX calls. */
  protected int vertexCodeCount;

    /**
     *
     */
    protected int[] vertexCodes;
  /** True if this is a closed path. */
  protected boolean close;

  // ........................................................

  // internal color for setting/calculating

    /**
     *
     */
  protected float calcR,

    /**
     *
     */
    calcG,

    /**
     *
     */
    calcB,

    /**
     *
     */
    calcA;

    /**
     *
     */
    protected int calcRi,

    /**
     *
     */
    calcGi,

    /**
     *
     */
    calcBi,

    /**
     *
     */
    calcAi;

    /**
     *
     */
    protected int calcColor;

    /**
     *
     */
    protected boolean calcAlpha;

  /** The current colorMode */
  public int colorMode; // = RGB;

  /** Max value for red (or hue) set by colorMode */
  public float colorModeX; // = 255;

  /** Max value for green (or saturation) set by colorMode */
  public float colorModeY; // = 255;

  /** Max value for blue (or value) set by colorMode */
  public float colorModeZ; // = 255;

  /** Max value for alpha set by colorMode */
  public float colorModeA; // = 255;

  /** True if colors are not in the range 0..1 */
  boolean colorModeScale; // = true;

  /** True if colorMode(RGB, 255) */
  boolean colorModeDefault; // = true;

  /** True if contains 3D data */
  protected boolean is3D = false;

    /**
     *
     */
    protected boolean perVertexStyles = false;

  // should this be called vertices (consistent with PGraphics internals)
  // or does that hurt flexibility?


  // POINTS, LINES, xLINE_STRIP, xLINE_LOOP
  // TRIANGLES, TRIANGLE_STRIP, TRIANGLE_FAN
  // QUADS, QUAD_STRIP
  // xPOLYGON
//  static final int PATH = 1;  // POLYGON, LINE_LOOP, LINE_STRIP
//  static final int GROUP = 2;

  // how to handle rectmode/ellipsemode?
  // are they bitshifted into the constant?
  // CORNER, CORNERS, CENTER, (CENTER_RADIUS?)
//  static final int RECT = 3; // could just be QUAD, but would be x1/y1/x2/y2
//  static final int ELLIPSE = 4;
//
//  static final int VERTEX = 7;
//  static final int CURVE = 5;
//  static final int BEZIER = 6;


  // fill and stroke functions will need a pointer to the parent
  // PGraphics object.. may need some kind of createShape() fxn
  // or maybe the values are stored until draw() is called?

  // attaching images is very tricky.. it's a different type of data

  // material parameters will be thrown out,
  // except those currently supported (kinds of lights)

  // pivot point for transformations
//  public float px;
//  public float py;


  /**
   * @nowebref
   */
  public PShape() {
    this.family = GROUP;
  }


  /**
     * @param family
   * @nowebref
   */
  public PShape(int family) {
    this.family = family;
  }


  /**
     * @param g
     * @param family
   * @nowebref
   */
  public PShape(PGraphics g, int family) {
    this.g = g;
    this.family = family;

    // Style parameters are retrieved from the current values in the renderer.
    textureMode = g.textureMode;

    colorMode(g.colorMode,
              g.colorModeX, g.colorModeY, g.colorModeZ, g.colorModeA);

    // Initial values for fill, stroke and tint colors are also imported from
    // the renderer. This is particular relevant for primitive shapes, since is
    // not possible to set their color separately when creating them, and their
    // input vertices are actually generated at rendering time, by which the
    // color configuration of the renderer might have changed.
    fill = g.fill;
    fillColor = g.fillColor;

    stroke = g.stroke;
    strokeColor = g.strokeColor;
    strokeWeight = g.strokeWeight;
    strokeCap = g.strokeCap;
    strokeJoin = g.strokeJoin;

    tint = g.tint;
    tintColor = g.tintColor;

    setAmbient = g.setAmbient;
    ambientColor = g.ambientColor;
    specularColor = g.specularColor;
    emissiveColor = g.emissiveColor;
    shininess = g.shininess;

    sphereDetailU = g.sphereDetailU;
    sphereDetailV = g.sphereDetailV;

//    bezierDetail = pg.bezierDetail;
//    curveDetail = pg.curveDetail;
//    curveTightness = pg.curveTightness;

    rectMode = g.rectMode;
    ellipseMode = g.ellipseMode;

//    normalX = normalY = 0;
//    normalZ = 1;
//
//    normalMode = NORMAL_MODE_AUTO;

    // To make sure that the first vertex is marked as a break.
    // Same behavior as in the immediate mode.
//    breakShape = false;

    if (family == GROUP) {
      // GROUP shapes are always marked as ended.
//      shapeCreated = true;
      // TODO why was this commented out?
    }
  }

    /**
     *
     * @param g
     * @param kind
     * @param params
     */
    public PShape(PGraphics g, int kind, float... params) {
    this(g, PRIMITIVE);
    setKind(kind);
    setParams(params);
  }

    /**
     *
     * @param family
     */
    public void setFamily(int family) {
    this.family = family;
  }

    /**
     *
     * @param kind
     */
    public void setKind(int kind) {
    this.kind = kind;
  }

    /**
     *
     * @param name
     */
    public void setName(String name) {
    this.name = name;
  }

    /**
     *
     * @return
     */
    public String getName() {
    return name;
  }

  /**
   * ( begin auto-generated from PShape_isVisible.xml )
   *
   * Returns a boolean value "true" if the image is set to be visible,
   * "false" if not. This is modified with the <b>setVisible()</b> parameter.
   * <br/> <br/>
   * The visibility of a shape is usually controlled by whatever program
   * created the SVG file. For instance, this parameter is controlled by
   * showing or hiding the shape in the layers palette in Adobe Illustrator.
   *
   * ( end auto-generated )
     * @return 
   * @webref pshape:method
   * @usage web_application
   * @brief Returns a boolean value "true" if the image is set to be visible, "false" if not
   * @see PShape#setVisible(boolean)
   */
  public boolean isVisible() {
    return visible;
  }


  /**
   * ( begin auto-generated from PShape_setVisible.xml )
   *
   * Sets the shape to be visible or invisible. This is determined by the
   * value of the <b>visible</b> parameter.
   * <br/> <br/>
   * The visibility of a shape is usually controlled by whatever program
   * created the SVG file. For instance, this parameter is controlled by
   * showing or hiding the shape in the layers palette in Adobe Illustrator.
   *
   * ( end auto-generated )
   * @webref pshape:mathod
   * @usage web_application
   * @brief Sets the shape to be visible or invisible
   * @param visible "false" makes the shape invisible and "true" makes it visible
   * @see PShape#isVisible()
   */
  public void setVisible(boolean visible) {
    this.visible = visible;
  }


  /**
   * ( begin auto-generated from PShape_disableStyle.xml )
   *
   * Disables the shape's style data and uses Processing's current styles.
   * Styles include attributes such as colors, stroke weight, and stroke
   * joints.
   *
   * ( end auto-generated )
   *  <h3>Advanced</h3>
   * Overrides this shape's style information and uses PGraphics styles and
   * colors. Identical to ignoreStyles(true). Also disables styles for all
   * child shapes.
   * @webref pshape:method
   * @usage web_application
   * @brief     Disables the shape's style data and uses Processing styles
   * @see PShape#enableStyle()
   */
  public void disableStyle() {
    style = false;

    for (int i = 0; i < childCount; i++) {
      children[i].disableStyle();
    }
  }


  /**
   * ( begin auto-generated from PShape_enableStyle.xml )
   *
   * Enables the shape's style data and ignores Processing's current styles.
   * Styles include attributes such as colors, stroke weight, and stroke
   * joints.
   *
   * ( end auto-generated )
   *
   * @webref pshape:method
   * @usage web_application
   * @brief Enables the shape's style data and ignores the Processing styles
   * @see PShape#disableStyle()
   */
  public void enableStyle() {
    style = true;

    for (int i = 0; i < childCount; i++) {
      children[i].enableStyle();
    }
  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


//  protected void checkBounds() {
//    if (width == 0 || height == 0) {
//      // calculate bounds here (also take kids into account)
//      width = 1;
//      height = 1;
//    }
//  }


  /**
   * Get the width of the drawing area (not necessarily the shape boundary).
     * @return 
   */
  public float getWidth() {
    //checkBounds();
    return width;
  }


  /**
   * Get the height of the drawing area (not necessarily the shape boundary).
     * @return 
   */
  public float getHeight() {
    //checkBounds();
    return height;
  }


  /**
   * Get the depth of the shape area (not necessarily the shape boundary). Only makes sense for 3D PShape subclasses,
   * such as PShape3D.
     * @return 
   */
  public float getDepth() {
    //checkBounds();
    return depth;
  }



  /*
  // TODO unapproved
  protected PVector getTop() {
    return getTop(null);
  }


  protected PVector getTop(PVector top) {
    if (top == null) {
      top = new PVector();
    }
    return top;
  }


  protected PVector getBottom() {
    return getBottom(null);
  }


  protected PVector getBottom(PVector bottom) {
    if (bottom == null) {
      bottom = new PVector();
    }
    return bottom;
  }
  */


  /**
   * Return true if this shape is 2D. Defaults to true.
     * @return 
   */
  public boolean is2D() {
    return !is3D;
  }


  /**
   * Return true if this shape is 3D. Defaults to false.
     * @return 
   */
  public boolean is3D() {
    return is3D;
  }

    /**
     *
     * @param val
     */
    public void set3D(boolean val) {
    is3D = val;
  }


//  /**
//   * Return true if this shape requires rendering through OpenGL. Defaults to false.
//   */
//  // TODO unapproved
//  public boolean isGL() {
//    return false;
//  }


  ///////////////////////////////////////////////////////////

  //

  // Drawing methods

    /**
     *
     * @param mode
     */

  public void textureMode(int mode) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "textureMode()");
      return;
    }

    textureMode = mode;
  }

    /**
     *
     * @param tex
     */
    public void texture(PImage tex) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "texture()");
      return;
    }

    image = tex;
  }

    /**
     *
     */
    public void noTexture() {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "noTexture()");
      return;
    }

    image = null;
  }


  // TODO unapproved

    /**
     *
     * @param solid
     */
  protected void solid(boolean solid) {
  }


  /**
   * @webref shape:vertex
   * @brief Starts a new contour
   * @see PShape#endContour()
   */
  public void beginContour() {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "beginContour()");
      return;
    }

    if (family == GROUP) {
      PGraphics.showWarning("Cannot begin contour in GROUP shapes");
      return;
    }

    if (openContour) {
      PGraphics.showWarning("Already called beginContour().");
      return;
    }
    openContour = true;
    beginContourImpl();
  }

    /**
     *
     */
    protected void beginContourImpl() {
    if (vertexCodes == null) {
      vertexCodes = new int[10];
    } else if (vertexCodes.length == vertexCodeCount) {
      vertexCodes = PApplet.expand(vertexCodes);
    }
    vertexCodes[vertexCodeCount++] = BREAK;
  }


  /**
   * @webref shape:vertex
   * @brief Ends a contour
   * @see PShape#beginContour()
   */
  public void endContour() {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "endContour()");
      return;
    }

    if (family == GROUP) {
      PGraphics.showWarning("Cannot end contour in GROUP shapes");
      return;
    }

    if (!openContour) {
      PGraphics.showWarning("Need to call beginContour() first.");
      return;
    }
    endContourImpl();
    openContour = false;
  }

    /**
     *
     */
    protected void endContourImpl() {
  }

    /**
     *
     * @param x
     * @param y
     */
    public void vertex(float x, float y) {
    if (vertices == null) {
      vertices = new float[10][2];
    } else if (vertices.length == vertexCount) {
      vertices = (float[][]) PApplet.expand(vertices);
    }
    vertices[vertexCount++] = new float[] { x, y };

    if (vertexCodes == null) {
      vertexCodes = new int[10];
    } else if (vertexCodes.length == vertexCodeCount) {
      vertexCodes = PApplet.expand(vertexCodes);
    }
    vertexCodes[vertexCodeCount++] = VERTEX;

    if (x > width) {
      width = x;
    }
    if (y > height) {
      height = y;
    }
  }

    /**
     *
     * @param x
     * @param y
     * @param u
     * @param v
     */
    public void vertex(float x, float y, float u, float v) {
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void vertex(float x, float y, float z) {
    vertex(x, y);  // maybe? maybe not?
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     * @param u
     * @param v
     */
    public void vertex(float x, float y, float z, float u, float v) {
  }

    /**
     *
     * @param nx
     * @param ny
     * @param nz
     */
    public void normal(float nx, float ny, float nz) {
  }

    /**
     *
     * @param name
     * @param x
     * @param y
     * @param z
     */
    public void attribPosition(String name, float x, float y, float z) {
  }

    /**
     *
     * @param name
     * @param nx
     * @param ny
     * @param nz
     */
    public void attribNormal(String name, float nx, float ny, float nz) {
  }

    /**
     *
     * @param name
     * @param color
     */
    public void attribColor(String name, int color) {
  }

    /**
     *
     * @param name
     * @param values
     */
    public void attrib(String name, float... values) {
  }

    /**
     *
     * @param name
     * @param values
     */
    public void attrib(String name, int... values) {
  }

    /**
     *
     * @param name
     * @param values
     */
    public void attrib(String name, boolean... values) {
  }


  /**
   * @webref pshape:method
   * @brief Starts the creation of a new PShape
   * @see PApplet#endShape()
   */
  public void beginShape() {
    beginShape(POLYGON);
  }

    /**
     *
     * @param kind
     */
    public void beginShape(int kind) {
    this.kind = kind;
    openShape = true;
  }

  /**
   * @webref pshape:method
   * @brief Finishes the creation of a new PShape
   * @see PApplet#beginShape()
   */
  public void endShape() {
    endShape(OPEN);
  }

    /**
     *
     * @param mode
     */
    public void endShape(int mode) {
    if (family == GROUP) {
      PGraphics.showWarning("Cannot end GROUP shape");
      return;
    }

    if (!openShape) {
      PGraphics.showWarning("Need to call beginShape() first");
      return;
    }

    close = (mode==CLOSE);

    // this is the state of the shape
    openShape = false;
  }


  //////////////////////////////////////////////////////////////

  // STROKE CAP/JOIN/WEIGHT

    /**
     *
     * @param weight
     */


  public void strokeWeight(float weight) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "strokeWeight()");
      return;
    }

    strokeWeight = weight;
  }

    /**
     *
     * @param join
     */
    public void strokeJoin(int join) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "strokeJoin()");
      return;
    }

    strokeJoin = join;
  }

    /**
     *
     * @param cap
     */
    public void strokeCap(int cap) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "strokeCap()");
      return;
    }

    strokeCap = cap;
  }


  //////////////////////////////////////////////////////////////

  // FILL COLOR

    /**
     *
     */


  public void noFill() {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "noFill()");
      return;
    }

    fill = false;
    fillColor = 0x0;

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }

    /**
     *
     * @param rgb
     */
    public void fill(int rgb) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "fill()");
      return;
    }

    fill = true;
    colorCalc(rgb);
    fillColor = calcColor;

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }

    /**
     *
     * @param rgb
     * @param alpha
     */
    public void fill(int rgb, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "fill()");
      return;
    }

    fill = true;
    colorCalc(rgb, alpha);
    fillColor = calcColor;

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }

    /**
     *
     * @param gray
     */
    public void fill(float gray) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "fill()");
      return;
    }

    fill = true;
    colorCalc(gray);
    fillColor = calcColor;

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }

    /**
     *
     * @param gray
     * @param alpha
     */
    public void fill(float gray, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "fill()");
      return;
    }

    fill = true;
    colorCalc(gray, alpha);
    fillColor = calcColor;

    if (!setAmbient) {
      ambient(fillColor);
      setAmbient = false;
    }

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void fill(float x, float y, float z) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "fill()");
      return;
    }

    fill = true;
    colorCalc(x, y, z);
    fillColor = calcColor;

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     * @param a
     */
    public void fill(float x, float y, float z, float a) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "fill()");
      return;
    }

    fill = true;
    colorCalc(x, y, z, a);
    fillColor = calcColor;

    if (!setAmbient) {
      ambientColor = fillColor;
    }
  }


  //////////////////////////////////////////////////////////////

  // STROKE COLOR

    /**
     *
     */


  public void noStroke() {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "noStroke()");
      return;
    }

    stroke = false;
  }

    /**
     *
     * @param rgb
     */
    public void stroke(int rgb) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "stroke()");
      return;
    }

    stroke = true;
    colorCalc(rgb);
    strokeColor = calcColor;
  }

    /**
     *
     * @param rgb
     * @param alpha
     */
    public void stroke(int rgb, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "stroke()");
      return;
    }

    stroke = true;
    colorCalc(rgb, alpha);
    strokeColor = calcColor;
  }

    /**
     *
     * @param gray
     */
    public void stroke(float gray) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "stroke()");
      return;
    }

    stroke = true;
    colorCalc(gray);
    strokeColor = calcColor;
  }

    /**
     *
     * @param gray
     * @param alpha
     */
    public void stroke(float gray, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "stroke()");
      return;
    }

    stroke = true;
    colorCalc(gray, alpha);
    strokeColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void stroke(float x, float y, float z) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "stroke()");
      return;
    }

    stroke = true;
    colorCalc(x, y, z);
    strokeColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     * @param alpha
     */
    public void stroke(float x, float y, float z, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "stroke()");
      return;
    }

    stroke = true;
    colorCalc(x, y, z, alpha);
    strokeColor = calcColor;
  }


  //////////////////////////////////////////////////////////////

  // TINT COLOR

    /**
     *
     */


  public void noTint() {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "noTint()");
      return;
    }

    tint = false;
  }

    /**
     *
     * @param rgb
     */
    public void tint(int rgb) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "tint()");
      return;
    }

    tint = true;
    colorCalc(rgb);
    tintColor = calcColor;
  }

    /**
     *
     * @param rgb
     * @param alpha
     */
    public void tint(int rgb, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "tint()");
      return;
    }

    tint = true;
    colorCalc(rgb, alpha);
    tintColor = calcColor;
  }

    /**
     *
     * @param gray
     */
    public void tint(float gray) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "tint()");
      return;
    }

    tint = true;
    colorCalc(gray);
    tintColor = calcColor;
  }

    /**
     *
     * @param gray
     * @param alpha
     */
    public void tint(float gray, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "tint()");
      return;
    }

    tint = true;
    colorCalc(gray, alpha);
    tintColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void tint(float x, float y, float z) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "tint()");
      return;
    }

    tint = true;
    colorCalc(x, y, z);
    tintColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     * @param alpha
     */
    public void tint(float x, float y, float z, float alpha) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "tint()");
      return;
    }

    tint = true;
    colorCalc(x, y, z, alpha);
    tintColor = calcColor;
  }


  //////////////////////////////////////////////////////////////

  // Ambient set/update

    /**
     *
     * @param rgb
     */

  public void ambient(int rgb) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "ambient()");
      return;
    }

    setAmbient = true;
    colorCalc(rgb);
    ambientColor = calcColor;
  }

    /**
     *
     * @param gray
     */
    public void ambient(float gray) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "ambient()");
      return;
    }

    setAmbient = true;
    colorCalc(gray);
    ambientColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void ambient(float x, float y, float z) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "ambient()");
      return;
    }

    setAmbient = true;
    colorCalc(x, y, z);
    ambientColor = calcColor;
  }


  //////////////////////////////////////////////////////////////

  // Specular set/update

    /**
     *
     * @param rgb
     */

  public void specular(int rgb) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "specular()");
      return;
    }

    colorCalc(rgb);
    specularColor = calcColor;
  }

    /**
     *
     * @param gray
     */
    public void specular(float gray) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "specular()");
      return;
    }

    colorCalc(gray);
    specularColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void specular(float x, float y, float z) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "specular()");
      return;
    }

    colorCalc(x, y, z);
    specularColor = calcColor;
  }


  //////////////////////////////////////////////////////////////

  // Emissive set/update

    /**
     *
     * @param rgb
     */

  public void emissive(int rgb) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "emissive()");
      return;
    }

    colorCalc(rgb);
    emissiveColor = calcColor;
  }

    /**
     *
     * @param gray
     */
    public void emissive(float gray) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "emissive()");
      return;
    }

    colorCalc(gray);
    emissiveColor = calcColor;
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void emissive(float x, float y, float z) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "emissive()");
      return;
    }

    colorCalc(x, y, z);
    emissiveColor = calcColor;
  }


  //////////////////////////////////////////////////////////////

  // Shininess set/update

    /**
     *
     * @param shine
     */

  public void shininess(float shine) {
    if (!openShape) {
      PGraphics.showWarning(OUTSIDE_BEGIN_END_ERROR, "shininess()");
      return;
    }

    shininess = shine;
  }

  ///////////////////////////////////////////////////////////

  //

  // Bezier curves

    /**
     *
     * @param detail
     */
    public void bezierDetail(int detail) {
  }

    /**
     *
     * @param x2
     * @param y2
     * @param x3
     * @param y3
     * @param x4
     * @param y4
     */
    public void bezierVertex(float x2, float y2,
                           float x3, float y3,
                           float x4, float y4) {
    if (vertices == null) {
      vertices = new float[10][];
    } else if (vertexCount + 2 >= vertices.length) {
      vertices = (float[][]) PApplet.expand(vertices);
    }
    vertices[vertexCount++] = new float[] { x2, y2 };
    vertices[vertexCount++] = new float[] { x3, y3 };
    vertices[vertexCount++] = new float[] { x4, y4 };

    // vertexCodes must be allocated because a vertex() call is required
    if (vertexCodes.length == vertexCodeCount) {
      vertexCodes = PApplet.expand(vertexCodes);
    }
    vertexCodes[vertexCodeCount++] = BEZIER_VERTEX;

    if (x4 > width) {
      width = x4;
    }
    if (y4 > height) {
      height = y4;
    }
  }

    /**
     *
     * @param x2
     * @param y2
     * @param z2
     * @param x3
     * @param y3
     * @param z3
     * @param x4
     * @param y4
     * @param z4
     */
    public void bezierVertex(float x2, float y2, float z2,
                           float x3, float y3, float z3,
                           float x4, float y4, float z4) {
  }

    /**
     *
     * @param cx
     * @param cy
     * @param x3
     * @param y3
     */
    public void quadraticVertex(float cx, float cy,
                              float x3, float y3) {
    if (vertices == null) {
      vertices = new float[10][];
    } else if (vertexCount + 1 >= vertices.length) {
      vertices = (float[][]) PApplet.expand(vertices);
    }
    vertices[vertexCount++] = new float[] { cx, cy };
    vertices[vertexCount++] = new float[] { x3, y3 };

    // vertexCodes must be allocated because a vertex() call is required
    if (vertexCodes.length == vertexCodeCount) {
      vertexCodes = PApplet.expand(vertexCodes);
    }
    vertexCodes[vertexCodeCount++] = QUADRATIC_VERTEX;

    if (x3 > width) {
      width = x3;
    }
    if (y3 > height) {
      height = y3;
    }
  }

    /**
     *
     * @param cx
     * @param cy
     * @param cz
     * @param x3
     * @param y3
     * @param z3
     */
    public void quadraticVertex(float cx, float cy, float cz,
                              float x3, float y3, float z3) {
  }


  ///////////////////////////////////////////////////////////

  //

  // Catmull-Rom curves

    /**
     *
     * @param detail
     */

  public void curveDetail(int detail) {
  }

    /**
     *
     * @param tightness
     */
    public void curveTightness(float tightness) {
  }

    /**
     *
     * @param x
     * @param y
     */
    public void curveVertex(float x, float y) {
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    public void curveVertex(float x, float y, float z) {
  }



  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


  /*
  boolean strokeSaved;
  int strokeColorSaved;
  float strokeWeightSaved;
  int strokeCapSaved;
  int strokeJoinSaved;

  boolean fillSaved;
  int fillColorSaved;

  int rectModeSaved;
  int ellipseModeSaved;
  int shapeModeSaved;
  */

    /**
     *
     * @param g
     */



  protected void pre(PGraphics g) {
    if (matrix != null) {
      g.pushMatrix();
      g.applyMatrix(matrix);
    }

    /*
    strokeSaved = g.stroke;
    strokeColorSaved = g.strokeColor;
    strokeWeightSaved = g.strokeWeight;
    strokeCapSaved = g.strokeCap;
    strokeJoinSaved = g.strokeJoin;

    fillSaved = g.fill;
    fillColorSaved = g.fillColor;

    rectModeSaved = g.rectMode;
    ellipseModeSaved = g.ellipseMode;
    shapeModeSaved = g.shapeMode;
    */
    if (style) {
      g.pushStyle();
      styles(g);
    }
  }

    /**
     *
     * @param g
     */
    protected void styles(PGraphics g) {
    // should not be necessary because using only the int version of color
    //parent.colorMode(PConstants.RGB, 255);

    if (stroke) {
      g.stroke(strokeColor);
      g.strokeWeight(strokeWeight);
      g.strokeCap(strokeCap);
      g.strokeJoin(strokeJoin);
    } else {
      g.noStroke();
    }

    if (fill) {
      //System.out.println("filling " + PApplet.hex(fillColor));
      g.fill(fillColor);
    } else {
      g.noFill();
    }
  }

    /**
     *
     * @param g
     */
    protected void post(PGraphics g) {
//    for (int i = 0; i < childCount; i++) {
//      children[i].draw(g);
//    }

    /*
    // TODO this is not sufficient, since not saving fillR et al.
    g.stroke = strokeSaved;
    g.strokeColor = strokeColorSaved;
    g.strokeWeight = strokeWeightSaved;
    g.strokeCap = strokeCapSaved;
    g.strokeJoin = strokeJoinSaved;

    g.fill = fillSaved;
    g.fillColor = fillColorSaved;

    g.ellipseMode = ellipseModeSaved;
    */

    if (matrix != null) {
      g.popMatrix();
    }

    if (style) {
      g.popStyle();
    }
  }


  ////////////////////////////////////////////////////////////////////////
  //
  // Shape copy


  // TODO unapproved

    /**
     *
     * @param parent
     * @param src
     * @return
     */
  static protected PShape createShape(PApplet parent, PShape src) {
    PShape dest = null;
    if (src.family == GROUP) {
      dest = parent.createShape(GROUP);
      PShape.copyGroup(parent, src, dest);
    } else if (src.family == PRIMITIVE) {
      dest = parent.createShape(src.kind, src.params);
      PShape.copyPrimitive(src, dest);
    } else if (src.family == GEOMETRY) {
      dest = parent.createShape(src.kind);
      PShape.copyGeometry(src, dest);
    } else if (src.family == PATH) {
      dest = parent.createShape(PATH);
      PShape.copyPath(src, dest);
    }
    dest.setName(src.name);
    return dest;
  }


  // TODO unapproved

    /**
     *
     * @param parent
     * @param src
     * @param dest
     */
  static protected void copyGroup(PApplet parent, PShape src, PShape dest) {
    copyMatrix(src, dest);
    copyStyles(src, dest);
    copyImage(src, dest);
    for (int i = 0; i < src.childCount; i++) {
      PShape c = PShape.createShape(parent, src.children[i]);
      dest.addChild(c);
    }
  }


  // TODO unapproved

    /**
     *
     * @param src
     * @param dest
     */
  static protected void copyPrimitive(PShape src, PShape dest) {
    copyMatrix(src, dest);
    copyStyles(src, dest);
    copyImage(src, dest);
  }


  // TODO unapproved

    /**
     *
     * @param src
     * @param dest
     */
  static protected void copyGeometry(PShape src, PShape dest) {
    dest.beginShape(src.getKind());

    copyMatrix(src, dest);
    copyStyles(src, dest);
    copyImage(src, dest);

    if (src.style) {
      for (int i = 0; i < src.vertexCount; i++) {
        float[] vert = src.vertices[i];

        dest.fill((int)(vert[PGraphics.A] * 255) << 24 |
                  (int)(vert[PGraphics.R] * 255) << 16 |
                  (int)(vert[PGraphics.G] * 255) <<  8 |
                  (int)(vert[PGraphics.B] * 255));

     // Do we need to copy these as well?
//        dest.ambient(vert[PGraphics.AR] * 255, vert[PGraphics.AG] * 255, vert[PGraphics.AB] * 255);
//        dest.specular(vert[PGraphics.SPR] * 255, vert[PGraphics.SPG] * 255, vert[PGraphics.SPB] * 255);
//        dest.emissive(vert[PGraphics.ER] * 255, vert[PGraphics.EG] * 255, vert[PGraphics.EB] * 255);
//        dest.shininess(vert[PGraphics.SHINE]);

        if (0 < PApplet.dist(vert[PGraphics.NX],
                             vert[PGraphics.NY],
                             vert[PGraphics.NZ], 0, 0, 0)) {
          dest.normal(vert[PGraphics.NX],
                      vert[PGraphics.NY],
                      vert[PGraphics.NZ]);
        }
        dest.vertex(vert[X], vert[Y], vert[Z],
                    vert[PGraphics.U],
                    vert[PGraphics.V]);
      }
    } else {
      for (int i = 0; i < src.vertexCount; i++) {
        float[] vert = src.vertices[i];
        if (vert[Z] == 0) {
          dest.vertex(vert[X], vert[Y]);
        } else {
          dest.vertex(vert[X], vert[Y], vert[Z]);
        }
      }
    }

    dest.endShape();
  }


  // TODO unapproved

    /**
     *
     * @param src
     * @param dest
     */
  static protected void copyPath(PShape src, PShape dest) {
    copyMatrix(src, dest);
    copyStyles(src, dest);
    copyImage(src, dest);
    dest.close = src.close;
    dest.setPath(src.vertexCount, src.vertices, src.vertexCodeCount, src.vertexCodes);
  }


  // TODO unapproved

    /**
     *
     * @param src
     * @param dest
     */
  static protected void copyMatrix(PShape src, PShape dest) {
    if (src.matrix != null) {
      dest.applyMatrix(src.matrix);
    }
  }


  // TODO unapproved

    /**
     *
     * @param src
     * @param dest
     */
  static protected void copyStyles(PShape src, PShape dest) {
    dest.ellipseMode = src.ellipseMode;
    dest.rectMode = src.rectMode;

    if (src.stroke) {
      dest.stroke = true;
      dest.strokeColor = src.strokeColor;
      dest.strokeWeight = src.strokeWeight;
      dest.strokeCap = src.strokeCap;
      dest.strokeJoin = src.strokeJoin;
    } else {
      dest.stroke = false;
    }

    if (src.fill) {
      dest.fill = true;
      dest.fillColor = src.fillColor;
    } else {
      dest.fill = false;
    }
  }


  // TODO unapproved

    /**
     *
     * @param src
     * @param dest
     */
  static protected void copyImage(PShape src, PShape dest) {
    if (src.image != null) {
      dest.texture(src.image);
    }
  }



  ////////////////////////////////////////////////////////////////////////


  /**
   * Called by the following (the shape() command adds the g)
   * PShape s = loadShape("blah.svg");
   * shape(s);
     * @param g
   */
  public void draw(PGraphics g) {
    if (visible) {
      pre(g);
      drawImpl(g);
      post(g);
    }
  }


  /**
   * Draws the SVG document.
     * @param g
   */
  protected void drawImpl(PGraphics g) {
    if (family == GROUP) {
      drawGroup(g);
    } else if (family == PRIMITIVE) {
      drawPrimitive(g);
    } else if (family == GEOMETRY) {
      // Not same as path: `kind` matters.
//      drawPath(g);
      drawGeometry(g);
    } else if (family == PATH) {
      drawPath(g);
    }
  }

    /**
     *
     * @param g
     */
    protected void drawGroup(PGraphics g) {
    for (int i = 0; i < childCount; i++) {
      children[i].draw(g);
    }
  }

    /**
     *
     * @param g
     */
    protected void drawPrimitive(PGraphics g) {
    if (kind == POINT) {
      g.point(params[0], params[1]);

    } else if (kind == LINE) {
      if (params.length == 4) {  // 2D
        g.line(params[0], params[1],
               params[2], params[3]);
      } else {  // 3D
        g.line(params[0], params[1], params[2],
               params[3], params[4], params[5]);
      }

    } else if (kind == TRIANGLE) {
      g.triangle(params[0], params[1],
                 params[2], params[3],
                 params[4], params[5]);

    } else if (kind == QUAD) {
      g.quad(params[0], params[1],
             params[2], params[3],
             params[4], params[5],
             params[6], params[7]);

    } else if (kind == RECT) {
      if (image != null) {
        int oldMode = g.imageMode;
        g.imageMode(CORNER);
        g.image(image, params[0], params[1], params[2], params[3]);
        g.imageMode(oldMode);
      } else {
        int oldMode = g.rectMode;
        g.rectMode(rectMode);
        if (params.length == 4) {
          g.rect(params[0], params[1],
                 params[2], params[3]);
        } else if (params.length == 5) {
          g.rect(params[0], params[1],
                 params[2], params[3],
                 params[4]);
        } else if (params.length == 8) {
          g.rect(params[0], params[1],
                 params[2], params[3],
                 params[4], params[5],
                 params[6], params[7]);
        }
        g.rectMode(oldMode);
      }
    } else if (kind == ELLIPSE) {
      int oldMode = g.ellipseMode;
      g.ellipseMode(ellipseMode);
      g.ellipse(params[0], params[1],
                params[2], params[3]);
      g.ellipseMode(oldMode);

    } else if (kind == ARC) {
      int oldMode = g.ellipseMode;
      g.ellipseMode(ellipseMode);
      if (params.length == 6) {
        g.arc(params[0], params[1],
              params[2], params[3],
              params[4], params[5]);
      } else if (params.length == 7) {
        g.arc(params[0], params[1],
              params[2], params[3],
              params[4], params[5],
              (int) params[6]);
      }
      g.ellipseMode(oldMode);

    } else if (kind == BOX) {
      if (params.length == 1) {
        g.box(params[0]);
      } else {
        g.box(params[0], params[1], params[2]);
      }

    } else if (kind == SPHERE) {
      g.sphere(params[0]);
    }
  }

    /**
     *
     * @param g
     */
    protected void drawGeometry(PGraphics g) {
    // get cache object using g.
    g.beginShape(kind);
    if (style) {
      for (int i = 0; i < vertexCount; i++) {
        g.vertex(vertices[i]);
      }
    } else {
      for (int i = 0; i < vertexCount; i++) {
        float[] vert = vertices[i];
        if (vert[Z] == 0) {
          g.vertex(vert[X], vert[Y]);
        } else {
          g.vertex(vert[X], vert[Y], vert[Z]);
        }
      }
    }
    g.endShape(close ? CLOSE : OPEN);
  }


  /*
  protected void drawPath(PGraphics g) {
    g.beginShape();
    for (int j = 0; j < childCount; j++) {
      if (j > 0) g.breakShape();
      int count = children[j].vertexCount;
      float[][] vert = children[j].vertices;
      int[] code = children[j].vertexCodes;

      for (int i = 0; i < count; i++) {
        if (style) {
          if (children[j].fill) {
            g.fill(vert[i][R], vert[i][G], vert[i][B]);
          } else {
            g.noFill();
          }
          if (children[j].stroke) {
            g.stroke(vert[i][R], vert[i][G], vert[i][B]);
          } else {
            g.noStroke();
          }
        }
        g.edge(vert[i][EDGE] == 1);

        if (code[i] == VERTEX) {
          g.vertex(vert[i]);

        } else if (code[i] == BEZIER_VERTEX) {
          float z0 = vert[i+0][Z];
          float z1 = vert[i+1][Z];
          float z2 = vert[i+2][Z];
          if (z0 == 0 && z1 == 0 && z2 == 0) {
            g.bezierVertex(vert[i+0][X], vert[i+0][Y], z0,
                           vert[i+1][X], vert[i+1][Y], z1,
                           vert[i+2][X], vert[i+2][Y], z2);
          } else {
            g.bezierVertex(vert[i+0][X], vert[i+0][Y],
                           vert[i+1][X], vert[i+1][Y],
                           vert[i+2][X], vert[i+2][Y]);
          }
        } else if (code[i] == CURVE_VERTEX) {
          float z = vert[i][Z];
          if (z == 0) {
            g.curveVertex(vert[i][X], vert[i][Y]);
          } else {
            g.curveVertex(vert[i][X], vert[i][Y], z);
          }
        }
      }
    }
    g.endShape();
  }
  */

    /**
     *
     * @param g
     */


  protected void drawPath(PGraphics g) {
    // Paths might be empty (go figure)
    // http://dev.processing.org/bugs/show_bug.cgi?id=982
    if (vertices == null) return;

    boolean insideContour = false;
    g.beginShape();

    if (vertexCodeCount == 0) {  // each point is a simple vertex
      if (vertices[0].length == 2) {  // drawing 2D vertices
        for (int i = 0; i < vertexCount; i++) {
          g.vertex(vertices[i][X], vertices[i][Y]);
        }
      } else {  // drawing 3D vertices
        for (int i = 0; i < vertexCount; i++) {
          g.vertex(vertices[i][X], vertices[i][Y], vertices[i][Z]);
        }
      }

    } else {  // coded set of vertices
      int index = 0;

      if (vertices[0].length == 2) {  // drawing a 2D path
        for (int j = 0; j < vertexCodeCount; j++) {
          switch (vertexCodes[j]) {

          case VERTEX:
            g.vertex(vertices[index][X], vertices[index][Y]);
            index++;
            break;

          case QUADRATIC_VERTEX:
            g.quadraticVertex(vertices[index+0][X], vertices[index+0][Y],
                              vertices[index+1][X], vertices[index+1][Y]);
            index += 2;
            break;

          case BEZIER_VERTEX:
            g.bezierVertex(vertices[index+0][X], vertices[index+0][Y],
                           vertices[index+1][X], vertices[index+1][Y],
                           vertices[index+2][X], vertices[index+2][Y]);
            index += 3;
            break;

          case CURVE_VERTEX:
            g.curveVertex(vertices[index][X], vertices[index][Y]);
            index++;
            break;

          case BREAK:
            if (insideContour) {
              g.endContour();
            }
            g.beginContour();
            insideContour = true;
          }
        }
      } else {  // drawing a 3D path
        for (int j = 0; j < vertexCodeCount; j++) {
          switch (vertexCodes[j]) {

          case VERTEX:
            g.vertex(vertices[index][X], vertices[index][Y], vertices[index][Z]);
            index++;
            break;

          case QUADRATIC_VERTEX:
            g.quadraticVertex(vertices[index+0][X], vertices[index+0][Y], vertices[index+0][Z],
                         vertices[index+1][X], vertices[index+1][Y], vertices[index+0][Z]);
            index += 2;
            break;


          case BEZIER_VERTEX:
            g.bezierVertex(vertices[index+0][X], vertices[index+0][Y], vertices[index+0][Z],
                           vertices[index+1][X], vertices[index+1][Y], vertices[index+1][Z],
                           vertices[index+2][X], vertices[index+2][Y], vertices[index+2][Z]);
            index += 3;
            break;

          case CURVE_VERTEX:
            g.curveVertex(vertices[index][X], vertices[index][Y], vertices[index][Z]);
            index++;
            break;

          case BREAK:
            if (insideContour) {
              g.endContour();
            }
            g.beginContour();
            insideContour = true;
          }
        }
      }
    }
    if (insideContour) {
      g.endContour();
    }
    g.endShape(close ? CLOSE : OPEN);
  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

    /**
     *
     * @return
     */


  public PShape getParent() {
    return parent;
  }

  /**
     * @return 
   * @webref
   * @brief Returns the number of children
   */
  public int getChildCount() {
    return childCount;
  }


  /** Resize the children[] array to be in line with childCount */
  protected void crop() {
    // https://github.com/processing/processing/issues/3347
    if (children.length != childCount) {
      children = (PShape[]) PApplet.subset(children, 0, childCount);
    }
  }

    /**
     *
     * @return
     */
    public PShape[] getChildren() {
    crop();
    return children;
  }

  /**
   * ( begin auto-generated from PShape_getChild.xml )
   *
   * Extracts a child shape from a parent shape. Specify the name of the
   * shape with the <b>target</b> parameter. The shape is returned as a
   * <b>PShape</b> object, or <b>null</b> is returned if there is an error.
   *
   * ( end auto-generated )
     * @return 
   * @webref pshape:method
   * @usage web_application
   * @brief Returns a child element of a shape as a PShape object
   * @param index the layer position of the shape to get
   * @see PShape#addChild(PShape)
   */
  public PShape getChild(int index) {
    crop();
    return children[index];
  }

 /**
  * @param target the name of the shape to get
     * @return 
  */
  public PShape getChild(String target) {
    if (name != null && name.equals(target)) {
      return this;
    }
    if (nameTable != null) {
      PShape found = nameTable.get(target);
      if (found != null) return found;
    }
    for (int i = 0; i < childCount; i++) {
      PShape found = children[i].getChild(target);
      if (found != null) return found;
    }
    return null;
  }


  /**
   * Same as getChild(name), except that it first walks all the way up the
   * hierarchy to the eldest grandparent, so that children can be found anywhere.
     * @param target
     * @return 
   */
  public PShape findChild(String target) {
    if (parent == null) {
      return getChild(target);

    } else {
      return parent.findChild(target);
    }
  }


  // can't be just 'add' because that suggests additive geometry
  /**
   * @webref pshape:method
   * @brief Adds a new child
   * @param who any variable of type PShape
   * @see PShape#getChild(int)
   */
  public void addChild(PShape who) {
    if (children == null) {
      children = new PShape[1];
    }
    if (childCount == children.length) {
      children = (PShape[]) PApplet.expand(children);
    }
    children[childCount++] = who;
    who.parent = this;

    if (who.getName() != null) {
      addName(who.getName(), who);
    }
  }


  // adds child who exactly at position idx in the array of children.
  /**
     * @param who
   * @param idx the layer position in which to insert the new child
   */
  public void addChild(PShape who, int idx) {
    if (idx < childCount) {
      if (childCount == children.length) {
        children = (PShape[]) PApplet.expand(children);
      }

      // Copy [idx, childCount - 1] to [idx + 1, childCount]
      for (int i = childCount - 1; i >= idx; i--) {
        children[i + 1] = children[i];
      }
      childCount++;

      children[idx] = who;

      who.parent = this;

      if (who.getName() != null) {
        addName(who.getName(), who);
      }
    }
  }


  /**
   * Remove the child shape with index idx.
     * @param idx
   */
  public void removeChild(int idx) {
    if (idx < childCount) {
      PShape child = children[idx];

      // Copy [idx + 1, childCount - 1] to [idx, childCount - 2]
      for (int i = idx; i < childCount - 1; i++) {
        children[i] = children[i + 1];
      }
      childCount--;

      if (child.getName() != null && nameTable != null) {
        nameTable.remove(child.getName());
      }
    }
  }


  /**
   * Add a shape to the name lookup table.
     * @param nom
     * @param shape
   */
  public void addName(String nom, PShape shape) {
    if (parent != null) {
      parent.addName(nom, shape);
    } else {
      if (nameTable == null) {
        nameTable = new HashMap<String,PShape>();
      }
      nameTable.put(nom, shape);
    }
  }


  /**
   * Returns the index of child who.
     * @param who
     * @return 
   */
  public int getChildIndex(PShape who) {
    for (int i = 0; i < childCount; i++) {
      if (children[i] == who) {
        return i;
      }
    }
    return -1;
  }

    /**
     *
     * @return
     */
    public PShape getTessellation() {
    return null;
  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


  /** The shape type, one of GROUP, PRIMITIVE, PATH, or GEOMETRY.
     * @return  */
  public int getFamily() {
    return family;
  }

    /**
     *
     * @return
     */
    public int getKind() {
    return kind;
  }

    /**
     *
     * @return
     */
    public float[] getParams() {
    return getParams(null);
  }

    /**
     *
     * @param target
     * @return
     */
    public float[] getParams(float[] target) {
    if (target == null || target.length != params.length) {
      target = new float[params.length];
    }
    PApplet.arrayCopy(params, target);
    return target;
  }

    /**
     *
     * @param index
     * @return
     */
    public float getParam(int index) {
    return params[index];
  }

    /**
     *
     * @param source
     */
    protected void setParams(float[] source) {
    if (params == null) {
      params = new float[source.length];
    }
    if (source.length != params.length) {
      PGraphics.showWarning("Wrong number of parameters");
      return;
    }
    PApplet.arrayCopy(source, params);
  }

    /**
     *
     * @param vcount
     * @param verts
     */
    public void setPath(int vcount, float[][] verts) {
    setPath(vcount, verts, 0, null);
  }

    /**
     *
     * @param vcount
     * @param verts
     * @param ccount
     * @param codes
     */
    protected void setPath(int vcount, float[][] verts, int ccount, int[] codes) {
    if (verts == null || verts.length < vcount) return;
    if (0 < ccount && (codes == null || codes.length < ccount)) return;

    int ndim = verts[0].length;
    vertexCount = vcount;
    vertices = new float[vertexCount][ndim];
    for (int i = 0; i < vertexCount; i++) {
      PApplet.arrayCopy(verts[i], vertices[i]);
    }

    vertexCodeCount = ccount;
    if (0 < vertexCodeCount) {
      vertexCodes = new int[vertexCodeCount];
      PApplet.arrayCopy(codes, vertexCodes, vertexCodeCount);
    }
  }

  /**
     * @return 
   * @webref pshape:method
   * @brief Returns the total number of vertices as an int
   * @see PShape#getVertex(int)
   * @see PShape#setVertex(int, float, float)
   */
  public int getVertexCount() {
    if (family == GROUP || family == PRIMITIVE) {
      PGraphics.showWarning(NO_VERTICES_ERROR);
    }
    return vertexCount;
  }


  /**
     * @return 
   * @webref pshape:method
   * @brief Returns the vertex at the index position
   * @param index the location of the vertex
   * @see PShape#setVertex(int, float, float)
   * @see PShape#getVertexCount()
   */
  public PVector getVertex(int index) {
    return getVertex(index, null);
  }


  /**
     * @param index
   * @param vec PVector to assign the data to
     * @return 
   */
  public PVector getVertex(int index, PVector vec) {
    if (vec == null) {
      vec = new PVector();
    }
    float[] vert = vertices[index];
    vec.x = vert[X];
    vec.y = vert[Y];
    if (vert.length > 2) {
      vec.z = vert[Z];
    } else {
      vec.z = 0;  // in case this isn't a new vector
    }
    return vec;
  }

    /**
     *
     * @param index
     * @return
     */
    public float getVertexX(int index) {
    return vertices[index][X];
  }

    /**
     *
     * @param index
     * @return
     */
    public float getVertexY(int index) {
    return vertices[index][Y];
  }

    /**
     *
     * @param index
     * @return
     */
    public float getVertexZ(int index) {
    return vertices[index][Z];
  }


  /**
   * @webref pshape:method
   * @brief Sets the vertex at the index position
   * @param index the location of the vertex
   * @param x the x value for the vertex
   * @param y the y value for the vertex
   * @see PShape#getVertex(int)
   * @see PShape#getVertexCount()
   */
  public void setVertex(int index, float x, float y) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setVertex()");
      return;
    }

    vertices[index][X] = x;
    vertices[index][Y] = y;
  }


  /**
     * @param index
     * @param x
   * @param z the z value for the vertex
     * @param y
   */
  public void setVertex(int index, float x, float y, float z) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setVertex()");
      return;
    }

    vertices[index][X] = x;
    vertices[index][Y] = y;
    vertices[index][Z] = z;
  }


  /**
     * @param index
   * @param vec the PVector to define the x, y, z coordinates
   */
  public void setVertex(int index, PVector vec) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setVertex()");
      return;
    }

    vertices[index][X] = vec.x;
    vertices[index][Y] = vec.y;

    if (vertices[index].length > 2) {
      vertices[index][Z] = vec.z;
    } else if (vec.z != 0 && vec.z == vec.z) {
      throw new IllegalArgumentException("Cannot set a z-coordinate on a 2D shape");
    }
  }

    /**
     *
     * @param index
     * @return
     */
    public PVector getNormal(int index) {
    return getNormal(index, null);
  }

    /**
     *
     * @param index
     * @param vec
     * @return
     */
    public PVector getNormal(int index, PVector vec) {
    if (vec == null) {
      vec = new PVector();
    }
    vec.x = vertices[index][PGraphics.NX];
    vec.y = vertices[index][PGraphics.NY];
    vec.z = vertices[index][PGraphics.NZ];
    return vec;
  }

    /**
     *
     * @param index
     * @return
     */
    public float getNormalX(int index) {
    return vertices[index][PGraphics.NX];
  }

    /**
     *
     * @param index
     * @return
     */
    public float getNormalY(int index) {
    return vertices[index][PGraphics.NY];
  }

    /**
     *
     * @param index
     * @return
     */
    public float getNormalZ(int index) {
    return vertices[index][PGraphics.NZ];
  }

    /**
     *
     * @param index
     * @param nx
     * @param ny
     * @param nz
     */
    public void setNormal(int index, float nx, float ny, float nz) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setNormal()");
      return;
    }

    vertices[index][PGraphics.NX] = nx;
    vertices[index][PGraphics.NY] = ny;
    vertices[index][PGraphics.NZ] = nz;
  }

    /**
     *
     * @param name
     * @param index
     * @param values
     */
    public void setAttrib(String name, int index, float... values) {
  }

    /**
     *
     * @param name
     * @param index
     * @param values
     */
    public void setAttrib(String name, int index, int... values) {
  }

    /**
     *
     * @param name
     * @param index
     * @param values
     */
    public void setAttrib(String name, int index, boolean... values) {
  }

    /**
     *
     * @param index
     * @return
     */
    public float getTextureU(int index) {
    return vertices[index][PGraphics.U];
  }

    /**
     *
     * @param index
     * @return
     */
    public float getTextureV(int index) {
    return vertices[index][PGraphics.V];
  }

    /**
     *
     * @param index
     * @param u
     * @param v
     */
    public void setTextureUV(int index, float u, float v) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setTextureUV()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setTextureUV()");
      return;
    }


    vertices[index][PGraphics.U] = u;
    vertices[index][PGraphics.V] = v;
  }

    /**
     *
     * @param mode
     */
    public void setTextureMode(int mode) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setTextureMode()");
      return;
    }

    textureMode = mode;
  }

    /**
     *
     * @param tex
     */
    public void setTexture(PImage tex) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setTexture()");
      return;
    }

    image = tex;
  }

    /**
     *
     * @param index
     * @return
     */
    public int getFill(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getFill()");
      return fillColor;
    }

    if (image == null) {
      int a = (int) (vertices[index][PGraphics.A] * 255);
      int r = (int) (vertices[index][PGraphics.R] * 255);
      int g = (int) (vertices[index][PGraphics.G] * 255);
      int b = (int) (vertices[index][PGraphics.B] * 255);
      return (a << 24) | (r << 16) | (g << 8) | b;
    } else {
      return 0;
    }
  }

 /**
     * @param fill
  * @nowebref
  */
  public void setFill(boolean fill) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setFill()");
      return;
    }

    this.fill = fill;
  }

 /**
   * ( begin auto-generated from PShape_setFill.xml )
   *
   * The <b>setFill()</b> method defines the fill color of a <b>PShape</b>. 
   * This method is used after shapes are created or when a shape is defined explicitly 
   * (e.g. <b>createShape(RECT, 20, 20, 80, 80)</b>) as shown in the above example. 
   * When a shape is created with <b>beginShape()</b> and <b>endShape()</b>, its 
   * attributes may be changed with <b>fill()</b> and <b>stroke()</b> within 
   * <b>beginShape()</b> and <b>endShape()</b>. However, after the shape is 
   * created, only the <b>setFill()</b> method can define a new fill value for 
   * the <b>PShape</b>. 
   *
   * ( end auto-generated )
   *
   * @webref
   * @param fill
   * @brief Set the fill value
   */
  public void setFill(int fill) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setFill()");
      return;
    }

    this.fillColor = fill;

    if (vertices != null && perVertexStyles) {
      for (int i = 0; i < vertexCount; i++) {
        setFill(i, fill);
      }
    }
  }

 /**
     * @param index
     * @param fill
  * @nowebref
  */
  public void setFill(int index, int fill) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setFill()");
      return;
    }

    if (!perVertexStyles) {
      PGraphics.showWarning(PER_VERTEX_UNSUPPORTED, "setFill()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getFill()");
      return;
    }

    if (image == null) {
      vertices[index][PGraphics.A] = ((fill >> 24) & 0xFF) / 255.0f;
      vertices[index][PGraphics.R] = ((fill >> 16) & 0xFF) / 255.0f;
      vertices[index][PGraphics.G] = ((fill >>  8) & 0xFF) / 255.0f;
      vertices[index][PGraphics.B] = ((fill >>  0) & 0xFF) / 255.0f;
    }
  }

    /**
     *
     * @param index
     * @return
     */
    public int getTint(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getTint()");
      return this.tintColor;
    }

    if (image != null) {
      int a = (int) (vertices[index][PGraphics.A] * 255);
      int r = (int) (vertices[index][PGraphics.R] * 255);
      int g = (int) (vertices[index][PGraphics.G] * 255);
      int b = (int) (vertices[index][PGraphics.B] * 255);
      return (a << 24) | (r << 16) | (g << 8) | b;
    } else {
      return 0;
    }
  }

    /**
     *
     * @param tint
     */
    public void setTint(boolean tint) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setTint()");
      return;
    }

    this.tint = tint;
  }

    /**
     *
     * @param fill
     */
    public void setTint(int fill) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setTint()");
      return;
    }

    tintColor = fill;

    if (vertices != null) {
      for  (int i = 0; i < vertices.length; i++) {
        setFill(i, fill);
      }
    }
  }

    /**
     *
     * @param index
     * @param tint
     */
    public void setTint(int index, int tint) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setTint()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setTint()");
      return;
    }

    if (image != null) {
      vertices[index][PGraphics.A] = ((tint >> 24) & 0xFF) / 255.0f;
      vertices[index][PGraphics.R] = ((tint >> 16) & 0xFF) / 255.0f;
      vertices[index][PGraphics.G] = ((tint >>  8) & 0xFF) / 255.0f;
      vertices[index][PGraphics.B] = ((tint >>  0) & 0xFF) / 255.0f;
    }
  }

    /**
     *
     * @param index
     * @return
     */
    public int getStroke(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getStroke()");
      return strokeColor;
    }

    int a = (int) (vertices[index][PGraphics.SA] * 255);
    int r = (int) (vertices[index][PGraphics.SR] * 255);
    int g = (int) (vertices[index][PGraphics.SG] * 255);
    int b = (int) (vertices[index][PGraphics.SB] * 255);
    return (a << 24) | (r << 16) | (g << 8) | b;
  }

  /**
     * @param stroke
   * @nowebref
   */
  public void setStroke(boolean stroke) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStroke()");
      return;
    }

    this.stroke = stroke;
  }

  /**
   * ( begin auto-generated from PShape_setStroke.xml )
   *
   * The <b>setStroke()</b> method defines the outline color of a <b>PShape</b>. 
   * This method is used after shapes are created or when a shape is defined 
   * explicitly (e.g. <b>createShape(RECT, 20, 20, 80, 80)</b>) as shown in 
   * the above example. When a shape is created with <b>beginShape()</b> and 
   * <b>endShape()</b>, its attributes may be changed with <b>fill()</b> and 
   * <b>stroke()</b> within <b>beginShape()</b> and <b>endShape()</b>. 
   * However, after the shape is created, only the <b>setStroke()</b> method 
   * can define a new stroke value for the <b>PShape</b>. 
   *
   * ( end auto-generated )
   *
   * @webref
   * @param stroke
   * @brief Set the stroke value
   */
  public void setStroke(int stroke) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStroke()");
      return;
    }

    strokeColor = stroke;

    if (vertices != null && perVertexStyles) {
      for (int i = 0; i < vertices.length; i++) {
        setStroke(i, stroke);
      }
    }
  }

  /**
     * @param index
     * @param stroke
   * @nowebref
   */
  public void setStroke(int index, int stroke) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStroke()");
      return;
    }

    if (!perVertexStyles) {
      PGraphics.showWarning(PER_VERTEX_UNSUPPORTED, "setStroke()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setStroke()");
      return;
    }

    vertices[index][PGraphics.SA] = ((stroke >> 24) & 0xFF) / 255.0f;
    vertices[index][PGraphics.SR] = ((stroke >> 16) & 0xFF) / 255.0f;
    vertices[index][PGraphics.SG] = ((stroke >>  8) & 0xFF) / 255.0f;
    vertices[index][PGraphics.SB] = ((stroke >>  0) & 0xFF) / 255.0f;
  }

    /**
     *
     * @param index
     * @return
     */
    public float getStrokeWeight(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getStrokeWeight()");
      return strokeWeight;
    }

    return vertices[index][PGraphics.SW];
  }

    /**
     *
     * @param weight
     */
    public void setStrokeWeight(float weight) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStrokeWeight()");
      return;
    }

    strokeWeight = weight;

    if (vertices != null && perVertexStyles) {
      for (int i = 0; i < vertexCount; i++) {
        setStrokeWeight(i, weight);
      }
    }
  }

    /**
     *
     * @param index
     * @param weight
     */
    public void setStrokeWeight(int index, float weight) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStrokeWeight()");
      return;
    }

    if (!perVertexStyles) {
      PGraphics.showWarning(PER_VERTEX_UNSUPPORTED, "setStrokeWeight()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setStrokeWeight()");
      return;
    }

    vertices[index][PGraphics.SW] = weight;
  }

    /**
     *
     * @param join
     */
    public void setStrokeJoin(int join) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStrokeJoin()");
      return;
    }

    strokeJoin = join;
  }

    /**
     *
     * @param cap
     */
    public void setStrokeCap(int cap) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStrokeCap()");
      return;
    }

    strokeCap = cap;
  }

    /**
     *
     * @param index
     * @return
     */
    public int getAmbient(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getAmbient()");
      return ambientColor;
    }

    int r = (int) (vertices[index][PGraphics.AR] * 255);
    int g = (int) (vertices[index][PGraphics.AG] * 255);
    int b = (int) (vertices[index][PGraphics.AB] * 255);
    return 0xff000000 | (r << 16) | (g << 8) | b;
  }

    /**
     *
     * @param ambient
     */
    public void setAmbient(int ambient) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setAmbient()");
      return;
    }

    ambientColor = ambient;

    if (vertices != null) {
      for  (int i = 0; i < vertices.length; i++) {
        setAmbient(i, ambient);
      }
    }
  }

    /**
     *
     * @param index
     * @param ambient
     */
    public void setAmbient(int index, int ambient) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setAmbient()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setAmbient()");
      return;
    }

    vertices[index][PGraphics.AR] = ((ambient >> 16) & 0xFF) / 255.0f;
    vertices[index][PGraphics.AG] = ((ambient >>  8) & 0xFF) / 255.0f;
    vertices[index][PGraphics.AB] = ((ambient >>  0) & 0xFF) / 255.0f;
  }

    /**
     *
     * @param index
     * @return
     */
    public int getSpecular(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getSpecular()");
      return specularColor;
    }

    int r = (int) (vertices[index][PGraphics.SPR] * 255);
    int g = (int) (vertices[index][PGraphics.SPG] * 255);
    int b = (int) (vertices[index][PGraphics.SPB] * 255);
    return 0xff000000 | (r << 16) | (g << 8) | b;
  }

    /**
     *
     * @param specular
     */
    public void setSpecular(int specular) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setSpecular()");
      return;
    }

    specularColor = specular;

    if (vertices != null) {
      for  (int i = 0; i < vertices.length; i++) {
        setSpecular(i, specular);
      }
    }
  }

    /**
     *
     * @param index
     * @param specular
     */
    public void setSpecular(int index, int specular) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setSpecular()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setSpecular()");
      return;
    }

    vertices[index][PGraphics.SPR] = ((specular >> 16) & 0xFF) / 255.0f;
    vertices[index][PGraphics.SPG] = ((specular >>  8) & 0xFF) / 255.0f;
    vertices[index][PGraphics.SPB] = ((specular >>  0) & 0xFF) / 255.0f;
  }

    /**
     *
     * @param index
     * @return
     */
    public int getEmissive(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null || index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getEmissive()");
      return emissiveColor;
    }

    int r = (int) (vertices[index][PGraphics.ER] * 255);
    int g = (int) (vertices[index][PGraphics.EG] * 255);
    int b = (int) (vertices[index][PGraphics.EB] * 255);
    return 0xff000000 | (r << 16) | (g << 8) | b;
  }

    /**
     *
     * @param emissive
     */
    public void setEmissive(int emissive) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setEmissive()");
      return;
    }

    emissiveColor = emissive;

    if (vertices != null) {
      for  (int i = 0; i < vertices.length; i++) {
        setEmissive(i, emissive);
      }
    }
  }

    /**
     *
     * @param index
     * @param emissive
     */
    public void setEmissive(int index, int emissive) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setEmissive()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setEmissive()");
      return;
    }

    vertices[index][PGraphics.ER] = ((emissive >> 16) & 0xFF) / 255.0f;
    vertices[index][PGraphics.EG] = ((emissive >>  8) & 0xFF) / 255.0f;
    vertices[index][PGraphics.EB] = ((emissive >>  0) & 0xFF) / 255.0f;
  }

    /**
     *
     * @param index
     * @return
     */
    public float getShininess(int index) {
    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "getShininess()");
      return shininess;
    }

    return vertices[index][PGraphics.SHINE];
  }

    /**
     *
     * @param shine
     */
    public void setShininess(float shine) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setShininess()");
      return;
    }

    shininess = shine;

    if (vertices != null) {
      for  (int i = 0; i < vertices.length; i++) {
        setShininess(i, shine);
      }
    }
  }

    /**
     *
     * @param index
     * @param shine
     */
    public void setShininess(int index, float shine) {
    if (openShape) {
      PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setShininess()");
      return;
    }

    // make sure we allocated the vertices array and that vertex exists
    if (vertices == null ||
        index >= vertices.length) {
      PGraphics.showWarning(NO_SUCH_VERTEX_ERROR + " (" + index + ")", "setShininess()");
      return;
    }


    vertices[index][PGraphics.SHINE] = shine;
  }

    /**
     *
     * @return
     */
    public int[] getVertexCodes() {
    if (vertexCodes == null) {
      return null;
    }
    if (vertexCodes.length != vertexCodeCount) {
      vertexCodes = PApplet.subset(vertexCodes, 0, vertexCodeCount);
    }
    return vertexCodes;
  }

    /**
     *
     * @return
     */
    public int getVertexCodeCount() {
    return vertexCodeCount;
  }


  /**
   * One of VERTEX, BEZIER_VERTEX, CURVE_VERTEX, or BREAK.
     * @param index
     * @return 
   */
  public int getVertexCode(int index) {
    return vertexCodes[index];
  }

    /**
     *
     * @return
     */
    public boolean isClosed() {
    return close;
  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


  // http://www.ecse.rpi.edu/Homepages/wrf/Research/Short_Notes/pnpoly.html

    /**
     *
     * @param x
     * @param y
     * @return
     */
  public boolean contains(float x, float y) {
    if (family == PATH) {
      boolean c = false;
      for (int i = 0, j = vertexCount-1; i < vertexCount; j = i++) {
        if (((vertices[i][Y] > y) != (vertices[j][Y] > y)) &&
            (x <
                (vertices[j][X]-vertices[i][X]) *
                (y-vertices[i][Y]) /
                (vertices[j][1]-vertices[i][Y]) +
                vertices[i][X])) {
          c = !c;
        }
      }
      return c;
    } else {
      throw new IllegalArgumentException("The contains() method is only implemented for paths.");
    }
  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


  // translate, rotate, scale, apply (no push/pop)
  //   these each call matrix.translate, etc
  // if matrix is null when one is called,
  //   it is created and set to identity


/**
   * ( begin auto-generated from PShape_translate.xml )
   *
   * Specifies an amount to displace the shape. The <b>x</b> parameter
   * specifies left/right translation, the <b>y</b> parameter specifies
   * up/down translation, and the <b>z</b> parameter specifies translations
   * toward/away from the screen. Subsequent calls to the method accumulates
   * the effect. For example, calling <b>translate(50, 0)</b> and then
   * <b>translate(20, 0)</b> is the same as <b>translate(70, 0)</b>. This
   * transformation is applied directly to the shape, it's not refreshed each
   * time <b>draw()</b> is run.
   * <br /><br />
   * Using this method with the <b>z</b> parameter requires using the P3D
   * parameter in combination with size.
   *
   * ( end auto-generated )
   * @webref pshape:method
   * @usage web_application
   * @brief Displaces the shape
   * @param x left/right translation
   * @param y up/down translation
   * @see PShape#rotate(float)
   * @see PShape#scale(float)
   * @see PShape#resetMatrix()
   */
  public void translate(float x, float y) {
    checkMatrix(2);
    matrix.translate(x, y);
  }

  /**
     * @param x
   * @param z forward/back translation
     * @param y
   */
  public void translate(float x, float y, float z) {
    checkMatrix(3);
    matrix.translate(x, y, z);
  }

  /**
   * ( begin auto-generated from PShape_rotateX.xml )
   *
   * Rotates a shape around the x-axis the amount specified by the
   * <b>angle</b> parameter. Angles should be specified in radians (values
   * from 0 to TWO_PI) or converted to radians with the <b>radians()</b> method.
   * <br /><br />
   * Shapes are always rotated around the upper-left corner of their bounding
   * box. Positive numbers rotate objects in a clockwise direction.
   * Subsequent calls to the method accumulates the effect. For example,
   * calling <b>rotateX(HALF_PI)</b> and then <b>rotateX(HALF_PI)</b> is the
   * same as <b>rotateX(PI)</b>. This transformation is applied directly to
   * the shape, it's not refreshed each time <b>draw()</b> is run.
   * <br /><br />
   * This method requires a 3D renderer. You need to use P3D as a third
   * parameter for the <b>size()</b> function as shown in the example above.
   *
   * ( end auto-generated )
   * @webref pshape:method
   * @usage web_application
   * @brief Rotates the shape around the x-axis
   * @param angle angle of rotation specified in radians
   * @see PShape#rotate(float)
   * @see PShape#rotateY(float)
   * @see PShape#rotateZ(float)
   * @see PShape#scale(float)
   * @see PShape#translate(float, float)
   * @see PShape#resetMatrix()
   */
  public void rotateX(float angle) {
    rotate(angle, 1, 0, 0);
  }

  /**
   * ( begin auto-generated from PShape_rotateY.xml )
   *
   * Rotates a shape around the y-axis the amount specified by the
   * <b>angle</b> parameter. Angles should be specified in radians (values
   * from 0 to TWO_PI) or converted to radians with the <b>radians()</b> method.
   * <br /><br />
   * Shapes are always rotated around the upper-left corner of their bounding
   * box. Positive numbers rotate objects in a clockwise direction.
   * Subsequent calls to the method accumulates the effect. For example,
   * calling <b>rotateY(HALF_PI)</b> and then <b>rotateY(HALF_PI)</b> is the
   * same as <b>rotateY(PI)</b>. This transformation is applied directly to
   * the shape, it's not refreshed each time <b>draw()</b> is run.
   * <br /><br />
   * This method requires a 3D renderer. You need to use P3D as a third
   * parameter for the <b>size()</b> function as shown in the example above.
   *
   * ( end auto-generated )
   *
   * @webref pshape:method
   * @usage web_application
   * @brief Rotates the shape around the y-axis
   * @param angle angle of rotation specified in radians
   * @see PShape#rotate(float)
   * @see PShape#rotateX(float)
   * @see PShape#rotateZ(float)
   * @see PShape#scale(float)
   * @see PShape#translate(float, float)
   * @see PShape#resetMatrix()
   */
  public void rotateY(float angle) {
    rotate(angle, 0, 1, 0);
  }


  /**
   * ( begin auto-generated from PShape_rotateZ.xml )
   *
   * Rotates a shape around the z-axis the amount specified by the
   * <b>angle</b> parameter. Angles should be specified in radians (values
   * from 0 to TWO_PI) or converted to radians with the <b>radians()</b> method.
   * <br /><br />
   * Shapes are always rotated around the upper-left corner of their bounding
   * box. Positive numbers rotate objects in a clockwise direction.
   * Subsequent calls to the method accumulates the effect. For example,
   * calling <b>rotateZ(HALF_PI)</b> and then <b>rotateZ(HALF_PI)</b> is the
   * same as <b>rotateZ(PI)</b>. This transformation is applied directly to
   * the shape, it's not refreshed each time <b>draw()</b> is run.
   * <br /><br />
   * This method requires a 3D renderer. You need to use P3D as a third
   * parameter for the <b>size()</b> function as shown in the example above.
   *
   * ( end auto-generated )
   * @webref pshape:method
   * @usage web_application
   * @brief Rotates the shape around the z-axis
   * @param angle angle of rotation specified in radians
   * @see PShape#rotate(float)
   * @see PShape#rotateX(float)
   * @see PShape#rotateY(float)
   * @see PShape#scale(float)
   * @see PShape#translate(float, float)
   * @see PShape#resetMatrix()
   */
  public void rotateZ(float angle) {
    rotate(angle, 0, 0, 1);
  }

  /**
   * ( begin auto-generated from PShape_rotate.xml )
   *
   * Rotates a shape the amount specified by the <b>angle</b> parameter.
   * Angles should be specified in radians (values from 0 to TWO_PI) or
   * converted to radians with the <b>radians()</b> method.
   * <br /><br />
   * Shapes are always rotated around the upper-left corner of their bounding
   * box. Positive numbers rotate objects in a clockwise direction.
   * Transformations apply to everything that happens after and subsequent
   * calls to the method accumulates the effect. For example, calling
   * <b>rotate(HALF_PI)</b> and then <b>rotate(HALF_PI)</b> is the same as
   * <b>rotate(PI)</b>. This transformation is applied directly to the shape,
   * it's not refreshed each time <b>draw()</b> is run.
   *
   * ( end auto-generated )
   * @webref pshape:method
   * @usage web_application
   * @brief Rotates the shape
   * @param angle angle of rotation specified in radians
   * @see PShape#rotateX(float)
   * @see PShape#rotateY(float)
   * @see PShape#rotateZ(float)
   * @see PShape#scale(float)
   * @see PShape#translate(float, float)
   * @see PShape#resetMatrix()
   */
  public void rotate(float angle) {
    checkMatrix(2);  // at least 2...
    matrix.rotate(angle);
  }

/**
     * @param angle
     * @param v0
     * @param v1
     * @param v2
 * @nowebref
 */
  public void rotate(float angle, float v0, float v1, float v2) {
    checkMatrix(3);
    float norm2 = v0 * v0 + v1 * v1 + v2 * v2;
    if (Math.abs(norm2 - 1) > EPSILON) {
      // The rotation vector is not normalized.
      float norm = PApplet.sqrt(norm2);
      v0 /= norm;
      v1 /= norm;
      v2 /= norm;
    }
    matrix.rotate(angle, v0, v1, v2);
  }


  //

  /**
   * ( begin auto-generated from PShape_scale.xml )
   *
   * Increases or decreases the size of a shape by expanding and contracting
   * vertices. Shapes always scale from the relative origin of their bounding
   * box. Scale values are specified as decimal percentages. For example, the
   * method call <b>scale(2.0)</b> increases the dimension of a shape by
   * 200%. Subsequent calls to the method multiply the effect. For example,
   * calling <b>scale(2.0)</b> and then <b>scale(1.5)</b> is the same as
   * <b>scale(3.0)</b>. This transformation is applied directly to the shape,
   * it's not refreshed each time <b>draw()</b> is run.
   * <br /><br />
   * Using this method with the <b>z</b> parameter requires using the P3D
   * parameter in combination with size.
   *
   * ( end auto-generated )
   * @webref pshape:method
   * @usage web_application
   * @brief Increases and decreases the size of a shape
   * @param s percentate to scale the object
   * @see PShape#rotate(float)
   * @see PShape#translate(float, float)
   * @see PShape#resetMatrix()
   */
  public void scale(float s) {
    checkMatrix(2);  // at least 2...
    matrix.scale(s);
  }

    /**
     *
     * @param x
     * @param y
     */
    public void scale(float x, float y) {
    checkMatrix(2);
    matrix.scale(x, y);
  }

/**
 * @param x percentage to scale the object in the x-axis
 * @param y percentage to scale the object in the y-axis
 * @param z percentage to scale the object in the z-axis
 */
  public void scale(float x, float y, float z) {
    checkMatrix(3);
    matrix.scale(x, y, z);
  }


  //

/**
   * ( begin auto-generated from PShape_resetMatrix.xml )
   *
   * Replaces the current matrix of a shape with the identity matrix. The
   * equivalent function in OpenGL is glLoadIdentity().
   *
   * ( end auto-generated )
   * @webref pshape:method
   * @brief Replaces the current matrix of a shape with the identity matrix
   * @usage web_application
   * @see PShape#rotate(float)
   * @see PShape#scale(float)
   * @see PShape#translate(float, float)
 */
  public void resetMatrix() {
    checkMatrix(2);
    matrix.reset();
  }

    /**
     *
     * @param source
     */
    public void applyMatrix(PMatrix source) {
    if (source instanceof PMatrix2D) {
      applyMatrix((PMatrix2D) source);
    } else if (source instanceof PMatrix3D) {
      applyMatrix((PMatrix3D) source);
    }
  }

    /**
     *
     * @param source
     */
    public void applyMatrix(PMatrix2D source) {
    applyMatrix(source.m00, source.m01, 0, source.m02,
                source.m10, source.m11, 0, source.m12,
                0, 0, 1, 0,
                0, 0, 0, 1);
  }

    /**
     *
     * @param n00
     * @param n01
     * @param n02
     * @param n10
     * @param n11
     * @param n12
     */
    public void applyMatrix(float n00, float n01, float n02,
                          float n10, float n11, float n12) {
    checkMatrix(2);
    matrix.apply(n00, n01, n02,
                 n10, n11, n12);
  }

    /**
     *
     * @param source
     */
    public void applyMatrix(PMatrix3D source) {
    applyMatrix(source.m00, source.m01, source.m02, source.m03,
                source.m10, source.m11, source.m12, source.m13,
                source.m20, source.m21, source.m22, source.m23,
                source.m30, source.m31, source.m32, source.m33);
  }

    /**
     *
     * @param n00
     * @param n01
     * @param n02
     * @param n03
     * @param n10
     * @param n11
     * @param n12
     * @param n13
     * @param n20
     * @param n21
     * @param n22
     * @param n23
     * @param n30
     * @param n31
     * @param n32
     * @param n33
     */
    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) {
    checkMatrix(3);
    matrix.apply(n00, n01, n02, n03,
                 n10, n11, n12, n13,
                 n20, n21, n22, n23,
                 n30, n31, n32, n33);
  }


  //


  /**
   * Make sure that the shape's matrix is 1) not null, and 2) has a matrix
   * that can handle <em>at least</em> the specified number of dimensions.
     * @param dimensions
   */
  protected void checkMatrix(int dimensions) {
    if (matrix == null) {
      if (dimensions == 2) {
        matrix = new PMatrix2D();
      } else {
        matrix = new PMatrix3D();
      }
    } else if (dimensions == 3 && (matrix instanceof PMatrix2D)) {
      // time for an upgrayedd for a double dose of my pimpin'
      matrix = new PMatrix3D(matrix);
    }
  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


  /**
   * Center the shape based on its bounding box. Can't assume
   * that the bounding box is 0, 0, width, height. Common case will be
   * opening a letter size document in Illustrator, and drawing something
   * in the middle, then reading it in as an svg file.
   * This will also need to flip the y axis (scale(1, -1)) in cases
   * like Adobe Illustrator where the coordinates start at the bottom.
   */
//  public void center() {
//  }


  /**
   * Set the pivot point for all transformations.
     * @param mode
   */
//  public void pivot(float x, float y) {
//    px = x;
//    py = y;
//  }


  // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


  public void colorMode(int mode) {
    colorMode(mode, colorModeX, colorModeY, colorModeZ, colorModeA);
  }

  /**
     * @param mode
   * @param max range for all color elements
   */
  public void colorMode(int mode, float max) {
    colorMode(mode, max, max, max, max);
  }


  /**
     * @param mode
   * @param maxX range for the red or hue depending on the current color mode
   * @param maxY range for the green or saturation depending on the current color mode
   * @param maxZ range for the blue or brightness depending on the current color mode
   */
  public void colorMode(int mode, float maxX, float maxY, float maxZ) {
    colorMode(mode, maxX, maxY, maxZ, colorModeA);
  }

/**
     * @param mode
 * @param maxA range for the alpha
     * @param maxY
     * @param maxX
     * @param maxZ
 */
  public void colorMode(int mode,
                        float maxX, float maxY, float maxZ, float maxA) {
    colorMode = mode;

    colorModeX = maxX;  // still needs to be set for hsb
    colorModeY = maxY;
    colorModeZ = maxZ;
    colorModeA = maxA;

    // if color max values are all 1, then no need to scale
    colorModeScale =
      ((maxA != 1) || (maxX != maxY) || (maxY != maxZ) || (maxZ != maxA));

    // if color is rgb/0..255 this will make it easier for the
    // red() green() etc functions
    colorModeDefault = (colorMode == RGB) &&
      (colorModeA == 255) && (colorModeX == 255) &&
      (colorModeY == 255) && (colorModeZ == 255);
  }

    /**
     *
     * @param rgb
     */
    protected void colorCalc(int rgb) {
    if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) {
      colorCalc((float) rgb);

    } else {
      colorCalcARGB(rgb, colorModeA);
    }
  }

    /**
     *
     * @param rgb
     * @param alpha
     */
    protected void colorCalc(int rgb, float alpha) {
    if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) {  // see above
      colorCalc((float) rgb, alpha);

    } else {
      colorCalcARGB(rgb, alpha);
    }
  }

    /**
     *
     * @param gray
     */
    protected void colorCalc(float gray) {
    colorCalc(gray, colorModeA);
  }

    /**
     *
     * @param gray
     * @param alpha
     */
    protected void colorCalc(float gray, float alpha) {
    if (gray > colorModeX) gray = colorModeX;
    if (alpha > colorModeA) alpha = colorModeA;

    if (gray < 0) gray = 0;
    if (alpha < 0) alpha = 0;

    calcR = colorModeScale ? (gray / colorModeX) : gray;
    calcG = calcR;
    calcB = calcR;
    calcA = colorModeScale ? (alpha / colorModeA) : alpha;

    calcRi = (int)(calcR*255); calcGi = (int)(calcG*255);
    calcBi = (int)(calcB*255); calcAi = (int)(calcA*255);
    calcColor = (calcAi << 24) | (calcRi << 16) | (calcGi << 8) | calcBi;
    calcAlpha = (calcAi != 255);
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     */
    protected void colorCalc(float x, float y, float z) {
    colorCalc(x, y, z, colorModeA);
  }

    /**
     *
     * @param x
     * @param y
     * @param z
     * @param a
     */
    protected void colorCalc(float x, float y, float z, float a) {
    if (x > colorModeX) x = colorModeX;
    if (y > colorModeY) y = colorModeY;
    if (z > colorModeZ) z = colorModeZ;
    if (a > colorModeA) a = colorModeA;

    if (x < 0) x = 0;
    if (y < 0) y = 0;
    if (z < 0) z = 0;
    if (a < 0) a = 0;

    switch (colorMode) {
    case RGB:
      if (colorModeScale) {
        calcR = x / colorModeX;
        calcG = y / colorModeY;
        calcB = z / colorModeZ;
        calcA = a / colorModeA;
      } else {
        calcR = x; calcG = y; calcB = z; calcA = a;
      }
      break;

    case HSB:
      x /= colorModeX; // h
      y /= colorModeY; // s
      z /= colorModeZ; // b

      calcA = colorModeScale ? (a/colorModeA) : a;

      if (y == 0) {  // saturation == 0
        calcR = calcG = calcB = z;

      } else {
        float which = (x - (int)x) * 6.0f;
        float f = which - (int)which;
        float p = z * (1.0f - y);
        float q = z * (1.0f - y * f);
        float t = z * (1.0f - (y * (1.0f - f)));

        switch ((int)which) {
        case 0: calcR = z; calcG = t; calcB = p; break;
        case 1: calcR = q; calcG = z; calcB = p; break;
        case 2: calcR = p; calcG = z; calcB = t; break;
        case 3: calcR = p; calcG = q; calcB = z; break;
        case 4: calcR = t; calcG = p; calcB = z; break;
        case 5: calcR = z; calcG = p; calcB = q; break;
        }
      }
      break;
    }
    calcRi = (int)(255*calcR); calcGi = (int)(255*calcG);
    calcBi = (int)(255*calcB); calcAi = (int)(255*calcA);
    calcColor = (calcAi << 24) | (calcRi << 16) | (calcGi << 8) | calcBi;
    calcAlpha = (calcAi != 255);
  }

    /**
     *
     * @param argb
     * @param alpha
     */
    protected void colorCalcARGB(int argb, float alpha) {
    if (alpha == colorModeA) {
      calcAi = (argb >> 24) & 0xff;
      calcColor = argb;
    } else {
      calcAi = (int) (((argb >> 24) & 0xff) * (alpha / colorModeA));
      calcColor = (calcAi << 24) | (argb & 0xFFFFFF);
    }
    calcRi = (argb >> 16) & 0xff;
    calcGi = (argb >> 8) & 0xff;
    calcBi = argb & 0xff;
    calcA = calcAi / 255.0f;
    calcR = calcRi / 255.0f;
    calcG = calcGi / 255.0f;
    calcB = calcBi / 255.0f;
    calcAlpha = (calcAi != 255);
  }

}