diff --git a/core/src/processing/core/PShape.java b/core/src/processing/core/PShape.java index dc0bb1107..44ff15115 100644 --- a/core/src/processing/core/PShape.java +++ b/core/src/processing/core/PShape.java @@ -29,20 +29,20 @@ 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 loadShape() function. The shape() - * function is used to draw the shape to the display window. The - * PShape object contain a group of methods, linked below, that can - * operate on the shape data. - *

- * The loadShape() 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 ) + * ( 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 loadShape() function. The shape() + * function is used to draw the shape to the display window. The + * PShape object contain a group of methods, linked below, that can + * operate on the shape data. + *

+ * The loadShape() 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 ) *

Advanced

* * In-progress class to handle shape data, currently to be considered of @@ -2372,7 +2372,9 @@ public class PShape implements PConstants { } } - + /** + * @nowebref + */ public void setFill(boolean fill) { if (openShape) { PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setFill()"); @@ -2382,7 +2384,24 @@ public class PShape implements PConstants { this.fill = fill; } - + /** + * ( begin auto-generated from PShape_setFill.xml ) + * + * The setFill() method defines the fill color of a PShape. + * This method is used after shapes are created or when a shape is defined explicitly + * (e.g. createShape(RECT, 20, 20, 80, 80)) as shown in the above example. + * When a shape is created with beginShape() and endShape(), its + * attributes may be changed with fill() and stroke() within + * beginShape() and endShape(). However, after the shape is + * created, only the setFill() method can define a new fill value for + * the PShape. + * + * ( 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()"); @@ -2398,7 +2417,9 @@ public class PShape implements PConstants { } } - + /** + * @nowebref + */ public void setFill(int index, int fill) { if (openShape) { PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setFill()"); @@ -2507,7 +2528,9 @@ public class PShape implements PConstants { return (a << 24) | (r << 16) | (g << 8) | b; } - + /** + * @nowebref + */ public void setStroke(boolean stroke) { if (openShape) { PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStroke()"); @@ -2517,7 +2540,24 @@ public class PShape implements PConstants { this.stroke = stroke; } - + /** + * ( begin auto-generated from PShape_setStroke.xml ) + * + * The setStroke() method defines the outline color of a PShape. + * This method is used after shapes are created or when a shape is defined + * explicitly (e.g. createShape(RECT, 20, 20, 80, 80)) as shown in + * the above example. When a shape is created with beginShape() and + * endShape(), its attributes may be changed with fill() and + * stroke() within beginShape() and endShape(). + * However, after the shape is created, only the setStroke() method + * can define a new stroke value for the PShape. + * + * ( 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()"); @@ -2533,7 +2573,9 @@ public class PShape implements PConstants { } } - + /** + * @nowebref + */ public void setStroke(int index, int stroke) { if (openShape) { PGraphics.showWarning(INSIDE_BEGIN_END_ERROR, "setStroke()");