diff --git a/core/src/processing/core/PApplet.java b/core/src/processing/core/PApplet.java index a4b95f5f8..b834e4e1f 100644 --- a/core/src/processing/core/PApplet.java +++ b/core/src/processing/core/PApplet.java @@ -10639,12 +10639,12 @@ public class PApplet implements PConstants { /** * - * Sets the current normal vector. Used for drawing three dimensional shapes and - * surfaces, normal() specifies a vector perpendicular to a shape's - * surface which, in turn, determines how lighting affects it. Processing - * attempts to automatically assign normals to shapes, but since that's - * imperfect, this is a better option when you want more control. This function - * is identical to glNormal3f() in OpenGL. + * Sets the current normal vector. Used for drawing three-dimensional + * shapes and surfaces, normal() specifies a vector perpendicular + * to a shape's surface which, in turn, determines how lighting affects it. + * Processing attempts to automatically assign normals to shapes, but since + * that's imperfect, this is a better option when you want more control. + * This function is identical to glNormal3f() in OpenGL. * * @webref lights_camera:lights * @webBrief Sets the current normal vector @@ -10721,12 +10721,10 @@ public class PApplet implements PConstants { /** - * * Defines if textures repeat or draw once within a texture map. * The two parameters are CLAMP (the default behavior) and REPEAT. * This function only works with the P2D and P3D renderers. * - * * @webref image:textures * @webBrief Defines if textures repeat or draw once within a texture map * @param wrap Either CLAMP (default) or REPEAT @@ -10740,12 +10738,11 @@ public class PApplet implements PConstants { /** - * * Sets a texture to be applied to vertex points. The texture() function * must be called between beginShape() and endShape() and before * any calls to vertex(). This function only works with the P2D and P3D - * renderers.
- *
+ * renderers. + *

* When textures are in use, the fill color is ignored. Instead, use * tint() to specify the color of the texture as it is applied to the * shape. @@ -10846,7 +10843,7 @@ public class PApplet implements PConstants { /** * Use the beginContour() and endContour() function to * create negative shapes within shapes such as the center of the - * letter 'O'. beginContour() begins recording vertices for the + * letter "O". beginContour() begins recording vertices for the * shape and endContour() stops recording. The vertices that * define a negative shape must "wind" in the opposite direction from * the exterior shape. First draw vertices for the exterior shape in @@ -10870,7 +10867,7 @@ public class PApplet implements PConstants { /** * Use the beginContour() and endContour() function to * create negative shapes within shapes such as the center of the - * letter 'O'. beginContour() begins recording vertices for + * letter "O". beginContour() begins recording vertices for * the shape and endContour() stops recording. The vertices * that define a negative shape must "wind" in the opposite direction * from the exterior shape. First draw vertices for the exterior shape @@ -10901,7 +10898,7 @@ public class PApplet implements PConstants { * * The endShape() function is the companion to beginShape() * and may only be called after beginShape(). When endshape() - * is called, all of image data defined since the previous call to + * is called, all the image data defined since the previous call to * beginShape() is written into the image buffer. The constant CLOSE * as the value for the MODE parameter to close the shape (to connect the * beginning and the end). @@ -11048,7 +11045,6 @@ public class PApplet implements PConstants { * Applies the shader specified by the parameters. It's compatible with * the P2D and P3D renderers, but not with the default renderer. * - * * @webref rendering:shaders * @webBrief Applies the shader specified by the parameters * @param shader name of shader file @@ -11069,11 +11065,9 @@ public class PApplet implements PConstants { /** - * * Restores the default shaders. Code that runs after resetShader() * will not be affected by previously defined shaders. * - * * @webref rendering:shaders * @webBrief Restores the default shaders */ @@ -11107,7 +11101,6 @@ public class PApplet implements PConstants { * by the parameters. The boundaries are drawn based on the state * of the imageMode() function, either CORNER, CORNERS, or CENTER. * - * * @webref rendering * @webBrief Limits the rendering to the boundaries of a rectangle defined * by the parameters @@ -11123,10 +11116,8 @@ public class PApplet implements PConstants { /** - * * Disables the clipping previously started by the clip() function. * - * * @webref rendering * @webBrief Disables the clipping previously started by the clip() function */ @@ -11171,7 +11162,6 @@ public class PApplet implements PConstants { * BURN. On older hardware, the LIGHTEST, DARKEST, and DIFFERENCE modes might * not be available as well. * - * * @webref rendering * @webBrief Blends the pixels in the display window according to a defined mode * @param mode the blending mode to use @@ -11192,9 +11182,9 @@ public class PApplet implements PConstants { /** * - * Specifies vertex coordinates for Bezier curves. Each call to + * Specifies vertex coordinates for Bézier curves. Each call to * bezierVertex() defines the position of two control points and one - * anchor point of a Bezier curve, adding a new segment to a line or shape. + * anchor point of a Bézier curve, adding a new segment to a line or shape. * The first time bezierVertex() is used within a * beginShape() call, it must be prefaced with a call to * vertex() to set the first anchor point. This function must be @@ -11228,9 +11218,9 @@ public class PApplet implements PConstants { /** - * Specifies vertex coordinates for quadratic Bezier curves. Each call + * Specifies vertex coordinates for quadratic Bézier curves. Each call * to quadraticVertex() defines the position of one control - * point and one anchor point of a Bezier curve, adding a new segment + * point and one anchor point of a Bézier curve, adding a new segment * to a line or shape. The first time quadraticVertex() is used * within a beginShape() call, it must be prefaced with a call * to vertex() to set the first anchor point. This function must @@ -11269,19 +11259,17 @@ public class PApplet implements PConstants { /** - * - * Specifies vertex coordinates for curves. This function may only be used - * between beginShape() and endShape() and only when there is - * no MODE parameter specified to beginShape(). The first and last - * points in a series of curveVertex() lines will be used to guide - * the beginning and end of a the curve. A minimum of four points is - * required to draw a tiny curve between the second and third points. - * Adding a fifth point with curveVertex() will draw the curve - * between the second, third, and fourth points. The curveVertex() - * function is an implementation of Catmull-Rom splines. Using the 3D - * version requires rendering with P3D (see the Environment reference for - * more information). - * + * Specifies vertex coordinates for curves. This function may only be used + * between beginShape() and endShape() and only when there is + * no MODE parameter specified to beginShape(). The first and last + * points in a series of curveVertex() lines will be used to guide + * the beginning and end of the curve. A minimum of four points is + * required to draw a tiny curve between the second and third points. + * Adding a fifth point with curveVertex() will draw the curve + * between the second, third, and fourth points. The curveVertex() + * function is an implementation of Catmull-Rom splines. Using the 3D + * version requires rendering with P3D (see the Environment reference for + * more information). * * @webref shape:vertex * @webBrief Specifies vertex coordinates for curves @@ -11329,7 +11317,6 @@ public class PApplet implements PConstants { * setting the pixel using set() or drawing the point using either * circle() or square(). * - * * @webref shape:2d primitives * @webBrief Draws a point, a coordinate in space at the dimension of one pixel * @param x x-coordinate of the point @@ -11491,7 +11478,6 @@ public class PApplet implements PConstants { * each corner separately, starting with the top-left corner and moving * clockwise around the rectangle. * - * * @webref shape:2d primitives * @webBrief Draws a rectangle to the screen * @param a x-coordinate of the rectangle by default @@ -11538,7 +11524,6 @@ public class PApplet implements PConstants { * these parameters are interpreted, however, may be changed with the * rectMode() function. * - * * @webref shape:2d primitives * @webBrief Draws a square to the screen * @param x x-coordinate of the rectangle by default @@ -11684,10 +11669,8 @@ public class PApplet implements PConstants { /** - * - * A box is an extruded rectangle. A box with equal dimension on all sides - * is a cube. - * + * A box is an extruded rectangle. A box with equal dimension + * on all sides is a cube. * * @webref shape:3d primitives * @webBrief A box is an extruded rectangle @@ -11726,7 +11709,6 @@ public class PApplet implements PConstants { * and vertical resolution independently, use the version of the functions * with two parameters. * - * *

Advanced

* Code for sphereDetail() submitted by toxi [031031]. * Code for enhanced u/v version from davbol [080801]. @@ -11754,10 +11736,8 @@ public class PApplet implements PConstants { /** - * * A sphere is a hollow ball made from tessellated triangles. * - * *

Advanced

*

* Implementation notes: @@ -11767,7 +11747,7 @@ public class PApplet implements PConstants { * in the center point *

* sphere is a series of concentric circles who radii vary - * along the shape, based on, er.. cos or something + * along the shape, based on, err... cos or something *

    * [toxi 031031] new sphere code. removed all multiplies with
    * radius, as scale() will take care of that anyway
@@ -11795,10 +11775,9 @@ public class PApplet implements PConstants {
    * Evaluates the Bezier at point t for points a, b, c, d. The parameter t
    * varies between 0 and 1, a and d are points on the curve, and b and c are
    * the control points. This can be done once with the x coordinates and a
-   * second time with the y coordinates to get the location of a bezier curve
+   * second time with the y coordinates to get the location of a Bézier curve
    * at t.
    *
-   *
    * 

Advanced

* For instance, to convert the following example:
    * stroke(255, 102, 0);
@@ -11837,17 +11816,15 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
-   * Calculates the tangent of a point on a Bezier curve. There is a good
+   * Calculates the tangent of a point on a Bézier curve. There is a good
    * definition of tangent on Wikipedia.
    *
-   *
    * 

Advanced

* Code submitted by Dave Bollinger (davbol) for release 0136. * * @webref shape:curves - * @webBrief Calculates the tangent of a point on a Bezier curve + * @webBrief Calculates the tangent of a point on a Bézier curve * @param a coordinate of first point on the curve * @param b coordinate of first control point * @param c coordinate of second control point @@ -11863,14 +11840,12 @@ public class PApplet implements PConstants { /** - * - * Sets the resolution at which Beziers display. The default value is 20. This - * function is only useful when using the P3D renderer; the default - * P2D renderer does not use this information. - * + * Sets the resolution at which Bézier curves display. The default value is 20. + * This function is only useful when using the P2D or P3D renderer; + * the default (JAVA2D) renderer does not use this information. * * @webref shape:curves - * @webBrief Sets the resolution at which Beziers display + * @webBrief Sets the resolution at which Bézier curves display * @param detail resolution of the curves * @see PGraphics#curve(float, float, float, float, float, float, float, float, * float, float, float, float) @@ -11894,17 +11869,16 @@ public class PApplet implements PConstants { /** * - * Draws a Bezier curve on the screen. These curves are defined by a series + * Draws a Bézier curve on the screen. These curves are defined by a series * of anchor and control points. The first two parameters specify the first * anchor point and the last two parameters specify the other anchor point. * The middle parameters specify the control points which define the shape - * of the curve. Bezier curves were developed by French engineer Pierre + * of the curve. The curves were developed by French engineer Pierre * Bezier. Using the 3D version requires rendering with P3D (see the * Environment reference for more information). * - * *

Advanced

- * Draw a cubic bezier curve. The first and last points are + * Draw a cubic Bézier curve. The first and last points are * the on-curve points. The middle two are the 'control' points, * or 'handles' in an application like Illustrator. *

@@ -11927,7 +11901,7 @@ public class PApplet implements PConstants { *

bezier(x1, y1, cx, cy, cx, cy, x2, y2);
* * @webref shape:curves - * @webBrief Draws a Bezier curve on the screen + * @webBrief Draws a Bézier curve on the screen * @param x1 coordinates for the first anchor point * @param y1 coordinates for the first anchor point * @param z1 coordinates for the first anchor point @@ -11954,7 +11928,6 @@ public class PApplet implements PConstants { /** - * * Evaluates the curve at point t for points a, b, * c, d. The parameter t may range from 0 (the start of the * curve) and 1 (the end of the curve). a and d are the control @@ -11963,7 +11936,6 @@ public class PApplet implements PConstants { * second time with the y coordinates to get the location of a curve at * t. * - * * @webref shape:curves * @webBrief Evaluates the curve at point t for points a, b, c, d * @param a coordinate of first control point @@ -11982,12 +11954,10 @@ public class PApplet implements PConstants { /** - * * Calculates the tangent of a point on a curve. There's a good definition * of tangent on Wikipedia. * - * *

Advanced

* Code thanks to Dave Bollinger (Bug #715) * @@ -12009,12 +11979,10 @@ public class PApplet implements PConstants { /** - * * Sets the resolution at which curves display. The default value is 20. * This function is only useful when using the P3D renderer as the default * P2D renderer does not use this information. * - * * @webref shape:curves * @webBrief Sets the resolution at which curves display * @param detail resolution of the curves @@ -12065,12 +12033,11 @@ public class PApplet implements PConstants { * implementation of Catmull-Rom splines. Using the 3D version requires * rendering with P3D (see the Environment reference for more information). * - * *

Advanced

* As of revision 0070, this function no longer doubles the first * and last points. The curves are a bit more boring, but it's more * mathematically correct, and properly mirrored in curvePoint(). - *

+ *

* Identical to typing out:

    * beginShape();
    * curveVertex(x1, y1);
@@ -12139,7 +12106,6 @@ public class PApplet implements PConstants {
    * The parameter must be written in ALL CAPS because Processing is a
    * case-sensitive language.
    *
-   *
    * @webref image:loading & displaying
    * @webBrief Modifies the location from which images draw
    * @param mode either CORNER, CORNERS, or CENTER
@@ -12229,8 +12195,7 @@ public class PApplet implements PConstants {
    * shapeMode(CENTER) draws the shape from its center point and uses
    * the third and forth parameters of shape() to specify the width
    * and height. The parameter must be written in "ALL CAPS" because
-   * Processing is a case sensitive language.
-   *
+   * Processing is a case-sensitive language.
    *
    * @webref shape:loading & displaying
    * @webBrief Modifies the location from which shapes draw
@@ -12252,7 +12217,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Draws shapes to the display window. Shapes must be in the sketch's "data"
    * directory to load correctly. Select "Add file..." from the "Sketch" menu to
    * add the shape. Processing currently works with SVG, OBJ, and custom-created
@@ -12262,7 +12226,6 @@ public class PApplet implements PConstants {
    * d parameters specify a different size. The shapeMode() function
    * can be used to change the way these parameters are interpreted.
    *
-   *
    * @webref shape:loading & displaying
    * @webBrief Displays shapes to the screen
    * @param shape the shape to display
@@ -12271,8 +12234,6 @@ public class PApplet implements PConstants {
    * @see PShape
    * @see PApplet#loadShape(String)
    * @see PGraphics#shapeMode(int)
-   *
-   *      Convenience method to draw at a particular location.
    */
   public void shape(PShape shape, float x, float y) {
     if (recorder != null) recorder.shape(shape, x, y);
@@ -12299,7 +12260,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Sets the current alignment for drawing text. The parameters LEFT, CENTER, and
    * RIGHT set the display characteristics of the letters in relation to the
    * values for the x and y parameters of the text()
@@ -12324,8 +12284,6 @@ public class PApplet implements PConstants {
    * textDescent() so that the hack works even if you change the size of
    * the font.
    *
-   *
-   *
    * @webref typography:attributes
    * @webBrief Sets the current alignment for drawing text
    * @param alignX horizontal alignment, either LEFT, CENTER, or RIGHT
@@ -12344,11 +12302,9 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Returns ascent of the current font at its current size. This information is
    * useful for determining the height of the font above the baseline.
    *
-   *
    * @webref typography:metrics
    * @webBrief Returns ascent of the current font at its current size
    * @see PGraphics#textDescent()
@@ -12359,7 +12315,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Returns descent of the current font at its current size. This information is
    * useful for determining the height of the font below the baseline.
    *
@@ -12417,7 +12372,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Sets the spacing between lines of text in units of pixels. This setting will
    * be used in all subsequent calls to the text() function. Note, however,
    * that the leading is reset by textSize(). For example, if the leading
@@ -12425,7 +12379,6 @@ public class PApplet implements PConstants {
    * at a later point, the leading will be reset to the default for the text size
    * of 48.
    *
-   *
    * @webref typography:attributes
    * @webBrief Sets the spacing between lines of text in units of pixels
    * @param leading the size in pixels for spacing between lines
@@ -12442,7 +12395,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Sets the way text draws to the screen, either as texture maps or as vector
    * geometry. The default textMode(MODEL), uses textures to render the
    * fonts. The textMode(SHAPE) mode draws text using the glyph outlines of
@@ -12476,11 +12428,9 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Sets the current font size. This size will be used in all subsequent
    * calls to the text() function. Font size is measured in units of pixels.
    *
-   *
    * @webref typography:attributes
    * @webBrief Sets the current font size
    * @param size the size of the letters in units of pixels
@@ -12504,10 +12454,8 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Calculates and returns the width of any character or text string.
    *
-   *
    * @webref typography:attributes
    * @webBrief Calculates and returns the width of any character or text string
    * @param str the String of characters to measure
@@ -12531,7 +12479,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Draws text to the screen. Displays the information specified in the first
    * parameter on the screen in the position specified by the additional
    * parameters. A default font will be used unless a font is set with the
@@ -12551,7 +12498,6 @@ public class PApplet implements PConstants {
    * a PFont with textFont(). In that case, a generic sans-serif font will
    * be used instead. (See the third example above.)
    *
-   *
    * @webref typography:loading & displaying
    * @webBrief Draws text to the screen
    * @param c the alphanumeric character to be displayed
@@ -12712,7 +12658,6 @@ public class PApplet implements PConstants {
    * transformations (rotate, scale, translate) and the drawing styles
    * at the same time.
    *
-   *
    * @webref structure
    * @webBrief The push() function saves the current drawing style
    * settings and transformations, while pop() restores these
@@ -12751,7 +12696,6 @@ public class PApplet implements PConstants {
    * transformations (rotate, scale, translate) and the drawing styles
    * at the same time.
    *
-   *
    * @webref structure
    * @webBrief The pop() function restores the previous drawing style
    * settings and transformations after push() has changed them
@@ -12764,7 +12708,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Pushes the current transformation matrix onto the matrix stack.
    * Understanding pushMatrix() and popMatrix() requires
    * understanding the concept of a matrix stack. The pushMatrix()
@@ -12774,7 +12717,6 @@ public class PApplet implements PConstants {
    * the other transformation functions and may be embedded to control the
    * scope of the transformations.
    *
-   *
    * @webref transform
    * @webBrief Pushes the current transformation matrix onto the matrix stack
    * @see PGraphics#popMatrix()
@@ -12792,7 +12734,6 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Pops the current transformation matrix off the matrix stack.
    * Understanding pushing and popping requires understanding the concept of
    * a matrix stack. The pushMatrix() function saves the current
@@ -12801,7 +12742,6 @@ public class PApplet implements PConstants {
    * in conjunction with the other transformation functions and may be
    * embedded to control the scope of the transformations.
    *
-   *
    * @webref transform
    * @webBrief Pops the current transformation matrix off the matrix stack
    * @see PGraphics#pushMatrix()
@@ -12813,14 +12753,13 @@ public class PApplet implements PConstants {
 
 
   /**
-   *
    * Specifies an amount to displace objects within the display window. The
    * x parameter specifies left/right translation, the y parameter
    * specifies up/down translation, and the z parameter specifies
    * translations toward/away from the screen. Using this function with the
    * z parameter requires using P3D as a parameter in combination with size
-   * as shown in the above example. 
- *
+ * as shown in the above example. + *

* Transformations are cumulative and apply to everything that happens after and * subsequent calls to the function accumulates the effect. For example, calling * translate(50, 0) and then translate(20, 0) is the same as @@ -12829,7 +12768,6 @@ public class PApplet implements PConstants { * function can be further controlled by using pushMatrix() and * popMatrix(). * - * * @webref transform * @webBrief Specifies an amount to displace objects within the display window * @param x left/right translation @@ -12875,7 +12813,6 @@ public class PApplet implements PConstants { * matrix by a rotation matrix. This function can be further controlled by * the pushMatrix() and popMatrix(). * - * * @webref transform * @webBrief Rotates a shape the amount specified by the angle parameter * @param angle angle of rotation specified in radians @@ -12908,7 +12845,6 @@ public class PApplet implements PConstants { * This function requires using P3D as a third parameter to size() * as shown in the example above. * - * * @webref transform * @webBrief Rotates a shape around the x-axis the amount specified by the * angle parameter @@ -12942,7 +12878,6 @@ public class PApplet implements PConstants { * This function requires using P3D as a third parameter to size() * as shown in the examples above. * - * * @webref transform * @webBrief Rotates a shape around the y-axis the amount specified by the * angle parameter @@ -12976,7 +12911,6 @@ public class PApplet implements PConstants { * This function requires using P3D as a third parameter to size() * as shown in the examples above. * - * * @webref transform * @webBrief Rotates a shape around the z-axis the amount specified by the * angle parameter @@ -13023,7 +12957,6 @@ public class PApplet implements PConstants { * example above. This function can be further controlled with * pushMatrix() and popMatrix(). * - * * @webref transform * @webBrief Increases or decreases the size of a shape by expanding and * contracting vertices @@ -13045,7 +12978,7 @@ public class PApplet implements PConstants { /** *

Advanced

* Scale in X and Y. Equivalent to scale(sx, sy, 1). - * + *

* Not recommended for use in 3D, because the z-dimension is just * scaled by 1, since there's no way to know what else to scale it by. * @@ -13084,7 +13017,6 @@ public class PApplet implements PConstants { * matrix by a rotation matrix. This function can be further controlled by * the pushMatrix() and popMatrix() functions. * - * * @webref transform * @webBrief Shears a shape around the x-axis the amount specified by the * angle parameter @@ -13119,7 +13051,6 @@ public class PApplet implements PConstants { * matrix by a rotation matrix. This function can be further controlled by * the pushMatrix() and popMatrix() functions. * - * * @webref transform * @webBrief Shears a shape around the y-axis the amount specified by the * angle parameter @@ -13138,10 +13069,8 @@ public class PApplet implements PConstants { /** - * - * Replaces the current matrix with the identity matrix. The equivalent function - * in OpenGL is glLoadIdentity(). - * + * Replaces the current matrix with the identity matrix. + * The equivalent function in OpenGL is glLoadIdentity(). * * @webref transform * @webBrief Replaces the current matrix with the identity matrix @@ -13157,16 +13086,14 @@ public class PApplet implements PConstants { /** - * * Multiplies the current matrix by the one specified through the * parameters. This is very slow because it will try to calculate the * inverse of the transform, so avoid it whenever possible. The equivalent * function in OpenGL is glMultMatrix(). * - * * @webref transform - * @webBrief Multiplies the current matrix by the one specified through the - * parameters + * @webBrief Multiplies the current matrix by the one specified in the + * parameter * @see PGraphics#pushMatrix() * @see PGraphics#popMatrix() * @see PGraphics#resetMatrix() @@ -13277,11 +13204,9 @@ public class PApplet implements PConstants { /** - * * Prints the current matrix to the Console (the text window at the bottom * of Processing). * - * * @webref transform * @webBrief Prints the current matrix to the Console (the text window at the bottom * of Processing) @@ -13297,7 +13222,6 @@ public class PApplet implements PConstants { /** - * * The beginCamera() and endCamera() functions enable * advanced customization of the camera space. The functions are useful if * you want to more control over camera movement, however for most users, @@ -13315,7 +13239,6 @@ public class PApplet implements PConstants { * following endCamera() and pairs of beginCamera() and * endCamera() cannot be nested. * - * * @webref lights_camera:camera * @webBrief The beginCamera() and endCamera() functions enable * advanced customization of the camera space @@ -13333,12 +13256,10 @@ public class PApplet implements PConstants { /** - * * The beginCamera() and endCamera() functions enable * advanced customization of the camera space. Please see the reference for * beginCamera() for a description of how the functions are used. * - * * @webref lights_camera:camera * @webBrief The beginCamera() and endCamera() functions enable * advanced customization of the camera space @@ -13352,7 +13273,6 @@ public class PApplet implements PConstants { /** - * * Sets the position of the camera through setting the eye position, the * center of the scene, and which axis is facing upward. Moving the eye * position and the direction it is pointing (the center of the scene) @@ -13363,7 +13283,6 @@ public class PApplet implements PConstants { * 180.0), width/2.0, height/2.0, 0, 0, 1, 0). This function is similar * to gluLookAt() in OpenGL, but it first clears the current camera settings. * - * * @webref lights_camera:camera * @webBrief Sets the position of the camera * @see PGraphics#beginCamera() @@ -13421,7 +13340,6 @@ public class PApplet implements PConstants { * are the minimum and maximum z values. If no parameters are given, the default * is used: ortho(-width/2, width/2, -height/2, height/2). * - * * @webref lights_camera:camera * @webBrief Sets an orthographic projection and defines a parallel clipping * volume @@ -13470,7 +13388,6 @@ public class PApplet implements PConstants { * default values are: perspective(PI/3.0, width/height, cameraZ/10.0, * cameraZ*10.0) where cameraZ is ((height/2.0) / tan(PI*60.0/360.0)) * - * * @webref lights_camera:camera * @webBrief Sets a perspective projection applying foreshortening, making distant * objects appear smaller than closer ones @@ -13485,7 +13402,7 @@ public class PApplet implements PConstants { * @param fovy field-of-view angle (in radians) for vertical direction * @param aspect ratio of width to height * @param zNear z-position of nearest clipping plane - * @param zFar z-position of farthest clipping plane + * @param zFar z-position of the farthest clipping plane */ public void perspective(float fovy, float aspect, float zNear, float zFar) { if (recorder != null) recorder.perspective(fovy, aspect, zNear, zFar); @@ -13515,7 +13432,6 @@ public class PApplet implements PConstants { * Works like glFrustum, except it wipes out the current perspective matrix * rather than multiplying itself with it. * - * * @webref lights_camera:camera * @webBrief Sets a perspective matrix defined through the parameters * @param left left coordinate of the clipping plane @@ -13540,11 +13456,9 @@ public class PApplet implements PConstants { /** - * * Prints the current projection matrix to the Console (the text window at * the bottom of Processing). * - * * @webref lights_camera:camera * @webBrief Prints the current projection matrix to the Console * @see PGraphics#camera(float, float, float, float, float, float, float, float, float) @@ -13556,11 +13470,9 @@ public class PApplet implements PConstants { /** - * * Takes a three-dimensional X, Y, Z position and returns the X value for * where it will appear on a (two-dimensional) screen. * - * * @webref lights_camera:coordinates * @webBrief Takes a three-dimensional X, Y, Z position and returns the X value for * where it will appear on a (two-dimensional) screen @@ -13575,11 +13487,9 @@ public class PApplet implements PConstants { /** - * * Takes a three-dimensional X, Y, Z position and returns the Y value for * where it will appear on a (two-dimensional) screen. * - * * @webref lights_camera:coordinates * @webBrief Takes a three-dimensional X, Y, Z position and returns the Y value for * where it will appear on a (two-dimensional) screen @@ -13610,11 +13520,9 @@ public class PApplet implements PConstants { /** - * * Takes a three-dimensional X, Y, Z position and returns the Z value for * where it will appear on a (two-dimensional) screen. * - * * @webref lights_camera:coordinates * @webBrief Takes a three-dimensional X, Y, Z position and returns the Z value for * where it will appear on a (two-dimensional) screen @@ -13644,7 +13552,6 @@ public class PApplet implements PConstants { * (x, y, z) coordinate returned by the model functions is used to place * another box in the same location. * - * * @webref lights_camera:coordinates * @webBrief Returns the three-dimensional X, Y, Z position in model space * @param x 3D x-coordinate to be mapped @@ -13659,7 +13566,6 @@ public class PApplet implements PConstants { /** - * * Returns the three-dimensional X, Y, Z position in model space. This * returns the Y value for a given coordinate based on the current set of * transformations (scale, rotate, translate, etc.) The Y value can be used @@ -13673,7 +13579,6 @@ public class PApplet implements PConstants { * (x, y, z) coordinate returned by the model functions is used to place * another box in the same location. * - * * @webref lights_camera:coordinates * @webBrief Returns the three-dimensional X, Y, Z position in model space * @param x 3D x-coordinate to be mapped @@ -13702,7 +13607,6 @@ public class PApplet implements PConstants { * (x, y, z) coordinate returned by the model functions is used to place * another box in the same location. * - * * @webref lights_camera:coordinates * @webBrief Returns the three-dimensional X, Y, Z position in model space * @param x 3D x-coordinate to be mapped @@ -13733,7 +13637,6 @@ public class PApplet implements PConstants { * textAlign(), textFont(), textMode(), textSize(), textLeading(), * emissive(), specular(), shininess(), ambient() * - * * @webref structure * @webBrief Saves the current style settings and popStyle() restores the prior settings * @see PGraphics#popStyle() @@ -13745,7 +13648,6 @@ public class PApplet implements PConstants { /** - * * The pushStyle() function saves the current style settings and * popStyle() restores the prior settings; these functions are * always used together. They allow you to change the style settings and @@ -13754,7 +13656,6 @@ public class PApplet implements PConstants { * pushStyle() and popStyle() functions can be embedded to * provide more control (see the second example above for a demonstration.) * - * * @webref structure * @webBrief Saves the current style settings and popStyle() restores the prior settings * @see PGraphics#pushStyle() @@ -13772,7 +13673,6 @@ public class PApplet implements PConstants { /** - * * Sets the width of the stroke used for lines, points, and the border around * shapes. All widths are set in units of pixels.
*
@@ -13781,7 +13681,6 @@ public class PApplet implements PConstants { * setting the pixel using set() or drawing the point using either * circle() or square(). * - * * @webref shape:attributes * @webBrief Sets the width of the stroke used for lines, points, and the border * around shapes @@ -13797,12 +13696,10 @@ public class PApplet implements PConstants { /** - * * Sets the style of the joints which connect line segments. These joints are * either mitered, beveled, or rounded and specified with the corresponding * parameters MITER, BEVEL, and ROUND. The default joint is MITER. * - * * @webref shape:attributes * @webBrief Sets the style of the joints which connect line segments * @param join either MITER, BEVEL, ROUND @@ -13817,7 +13714,6 @@ public class PApplet implements PConstants { /** - * * Sets the style for rendering line endings. These ends are either squared, * extended, or rounded, each of which specified with the corresponding * parameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND.
@@ -13840,11 +13736,9 @@ public class PApplet implements PConstants { /** - * * Disables drawing the stroke (outline). If both noStroke() and * noFill() are called, nothing will be drawn to the screen. * - * * @webref color:setting * @webBrief Disables drawing the stroke (outline) * @see PGraphics#stroke(int, float) @@ -13945,7 +13839,6 @@ public class PApplet implements PConstants { * Removes the current fill value for displaying images and reverts to * displaying images with their original hues. * - * * @webref image:loading & displaying * @webBrief Removes the current fill value for displaying images and reverts to * displaying images with their original hues @@ -13984,7 +13877,6 @@ public class PApplet implements PConstants { * The tint() function is also used to control the coloring of textures * in 3D. * - * * @webref image:loading & displaying * @webBrief Sets the fill value for displaying images * @usage web_application @@ -14044,7 +13936,6 @@ public class PApplet implements PConstants { * Disables filling geometry. If both noStroke() and noFill() * are called, nothing will be drawn to the screen. * - * * @webref color:setting * @webBrief Disables filling geometry * @usage web_application @@ -14080,7 +13971,6 @@ public class PApplet implements PConstants { *

* To change the color of an image (or a texture), use tint(). * - * * @webref color:setting * @webBrief Sets the color used to fill shapes * @usage web_application @@ -14149,7 +14039,6 @@ public class PApplet implements PConstants { * reflect. Used in combination with emissive(), specular(), * and shininess() in setting the material properties of shapes. * - * * @webref lights_camera:material properties * @webBrief Sets the ambient reflectance for shapes drawn to the screen * @usage web_application @@ -14192,7 +14081,6 @@ public class PApplet implements PConstants { * with emissive(), ambient(), and shininess() in * setting the material properties of shapes. * - * * @webref lights_camera:material properties * @webBrief Sets the specular color of the materials used for shapes drawn to the * screen, which sets the color of highlights @@ -14237,7 +14125,6 @@ public class PApplet implements PConstants { * with ambient(), specular(), and emissive() in * setting the material properties of shapes. * - * * @webref lights_camera:material properties * @webBrief Sets the amount of gloss in the surface of shapes * @usage web_application @@ -14259,7 +14146,6 @@ public class PApplet implements PConstants { * specular(), and shininess() in setting the material * properties of shapes. * - * * @webref lights_camera:material properties * @webBrief Sets the emissive color of the material used for drawing shapes drawn to * the screen @@ -14307,7 +14193,6 @@ public class PApplet implements PConstants { * looping program will cause them to only have an effect the first time * through the loop. * - * * @webref lights_camera:lights * @webBrief Sets the default ambient light, directional light, falloff, and specular * values @@ -14331,7 +14216,6 @@ public class PApplet implements PConstants { * lighting so that 2D geometry (which does not require lighting) can be * drawn after a set of lighted 3D geometry. * - * * @webref lights_camera:lights * @webBrief Disable all lighting * @usage web_application @@ -14354,7 +14238,6 @@ public class PApplet implements PConstants { * through the loop. The v1, v2, and v3 parameters are * interpreted as either RGB or HSB values, depending on the current color mode. * - * * @webref lights_camera:lights * @webBrief Adds an ambient light * @usage web_application @@ -14388,7 +14271,7 @@ public class PApplet implements PConstants { /** * * Adds a directional light. Directional light comes from one direction and - * is stronger when hitting a surface squarely and weaker if it hits at a a + * is stronger when hitting a surface squarely and weaker if it hits at a * gentle angle. After hitting a surface, a directional lights scatters in * all directions. Lights need to be included in the draw() to * remain persistent in a looping program. Placing them in the @@ -14399,7 +14282,6 @@ public class PApplet implements PConstants { * direction the light is facing. For example, setting ny to -1 will * cause the geometry to be lit from below (the light is facing directly upward). * - * * @webref lights_camera:lights * @webBrief Adds a directional light * @usage web_application @@ -14430,7 +14312,6 @@ public class PApplet implements PConstants { * as either RGB or HSB values, depending on the current color mode. The * x, y, and z parameters set the position of the light. * - * * @webref lights_camera:lights * @webBrief Adds a point light * @usage web_application @@ -14455,7 +14336,7 @@ public class PApplet implements PConstants { /** * - * Adds a spot light. Lights need to be included in the draw() to remain + * Adds a spotlight. Lights need to be included in the draw() to remain * persistent in a looping program. Placing them in the setup() of a * looping program will cause them to only have an effect the first time through * the loop. The v1, v2, and v3 parameters are interpreted @@ -14467,7 +14348,7 @@ public class PApplet implements PConstants { * that cone. * * @webref lights_camera:lights - * @webBrief Adds a spot light + * @webBrief Adds a spotlight * @usage web_application * @param v1 red or hue value (depending on current color mode) * @param v2 green or saturation value (depending on current color @@ -14477,9 +14358,9 @@ public class PApplet implements PConstants { * @param x x-coordinate of the light * @param y y-coordinate of the light * @param z z-coordinate of the light - * @param nx direction along the x axis - * @param ny direction along the y axis - * @param nz direction along the z axis + * @param nx direction along the x-axis + * @param ny direction along the y-axis + * @param nz direction along the z-axis * @param angle angle of the spotlight cone * @param concentration exponent determining the center bias of the cone * @see PGraphics#lights() @@ -14498,7 +14379,7 @@ public class PApplet implements PConstants { /** * - * Sets the falloff rates for point lights, spot lights, and ambient lights. + * Sets the falloff rates for point lights, spotlights, and ambient lights. * Like fill(), it affects only the elements which are created after it * in the code. The default value is lightFalloff(1.0, 0.0, 0.0), and the * parameters are used to calculate the falloff with the following @@ -14513,9 +14394,8 @@ public class PApplet implements PConstants { * location and falloff. You can think of it as a point light that doesn't care * which direction a surface is facing. * - * * @webref lights_camera:lights - * @webBrief Sets the falloff rates for point lights, spot lights, and ambient + * @webBrief Sets the falloff rates for point lights, spotlights, and ambient * lights * @usage web_application * @param constant constant value or determining falloff @@ -14544,7 +14424,6 @@ public class PApplet implements PConstants { * specular material qualities set through the specular() and * shininess() functions. * - * * @webref lights_camera:lights * @webBrief Sets the specular color for lights * @usage web_application @@ -14582,7 +14461,6 @@ public class PApplet implements PConstants { * background colors on the main drawing surface. It can only be used along with * a PGraphics object and createGraphics(). * - * *

Advanced

*

* Clear the background with a color that includes an alpha value. This can only @@ -14659,7 +14537,7 @@ public class PApplet implements PConstants { * function. Unlike the main graphics context (the display window), * pixels in additional graphics areas created with createGraphics() * can be entirely or partially transparent. This function clears - * everything in a PGraphics object to make all of the pixels + * everything in a PGraphics object to make all the pixels * 100% transparent. * * @webref color:setting @@ -14711,7 +14589,6 @@ public class PApplet implements PConstants { * instance, instead of colorMode(RGB), write colorMode(RGB, 255, 255, * 255). * - * * @webref color:setting * @webBrief Changes the way Processing interprets color data * @usage web_application @@ -14932,10 +14809,8 @@ public class PApplet implements PConstants { /** - * * Extracts the brightness value from a color. * - * * @webref color:creating & reading * @webBrief Extracts the brightness value from a color * @usage web_application