updated inline jsdocs for all setters that have them

Author: dhowe

src/color/setting.js

@@ -1777,6 +1777,8 @@ function setting(p5, fn){
    *                EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,
    *                SOFT_LIGHT, DODGE, BURN, ADD, REMOVE or SUBTRACT
    *
+   * Calling `blendMode()` without an argument returns the current blendMode.
+   *
    * @example
    * function setup() {
    *   createCanvas(100, 100);
@@ -2145,6 +2147,10 @@ function setting(p5, fn){
    *   describe('A yellow line and a turquoise line form an X on a gray background. The area where they overlap is green.');
    * }
    */
+  /**
+   * @method blendMode
+   * @return {(BLEND|DARKEST|LIGHTEST|DIFFERENCE|MULTIPLY|EXCLUSION|SCREEN|REPLACE|OVERLAY|HARD_LIGHT|SOFT_LIGHT|DODGE|BURN|ADD|REMOVE|SUBTRACT)}      the current blend mode.
+   */
   fn.blendMode = function (mode) {
     // p5._validateParameters('blendMode', arguments);
     if (mode === constants.NORMAL) {

src/core/environment.js

@@ -215,6 +215,8 @@ function environment(p5, fn, lifecycles){
    * cursor, `x` and `y` set the location pointed to within the image. They are
    * both 0 by default, so the cursor points to the image's top-left corner. `x`
    * and `y` must be less than the image's width and height, respectively.
+   * 
+   * Calling `cursor()` without an argument returns the current cursor type as a string.
    *
    * @method cursor
    * @param {(ARROW|CROSS|HAND|MOVE|TEXT|WAIT|String)} type Built-in: either ARROW, CROSS, HAND, MOVE, TEXT, or WAIT.
@@ -281,6 +283,10 @@ function environment(p5, fn, lifecycles){
    *   }
    * }
    */
+  /**
+   * @method cursor
+   * @return {(ARROW|CROSS|HAND|MOVE|TEXT|WAIT|String)} the current cursor type
+   */
   fn.cursor = function(type, x, y) {
     let cursor = 'auto';
     const canvas = this._curElement.elt;

src/image/loading_displaying.js

@@ -1325,6 +1325,8 @@ function loadingDisplaying(p5, fn){
    * <a href="#/p5/image">image()</a> as the x- and y-coordinates of the image's
    * center. The next parameters are its width and height.
    *
+   * Calling `imageMode()` without an argument returns the current image mode, either `CORNER`, `CORNERS`, or `CENTER`.
+   *
    * @method imageMode
    * @param {(CORNER|CORNERS|CENTER)} mode either CORNER, CORNERS, or CENTER.
    *
@@ -1388,6 +1390,10 @@ function loadingDisplaying(p5, fn){
    *   describe('A square image of a brick wall is drawn on a gray square.');
    * }
    */
+  /**
+   * @method imageMode
+   * @return {(CORNER|CORNERS|CENTER)}      the current image mode
+   */
   fn.imageMode = function(m) {
     // p5._validateParameters('imageMode', arguments);
     if (typeof m === 'undefined') { // getter

src/shape/attributes.js

@@ -35,6 +35,8 @@ function attributes(p5, fn){
    * the constants `CENTER`, `RADIUS`, `CORNER`, and `CORNERS` are defined this
    * way. JavaScript is a case-sensitive language.
    *
+   * Calling `ellipseMode()` without an argument returns the current ellipseMode, either `CENTER`, `RADIUS`, `CORNER`, or `CORNERS`.
+   * 
    * @method ellipseMode
    * @param  {(CENTER|RADIUS|CORNER|CORNERS)} mode either CENTER, RADIUS, CORNER, or CORNERS
    * @chainable
@@ -77,6 +79,10 @@ function attributes(p5, fn){
    *   describe('A white circle with a gray circle at its top-left corner. Both circles have black outlines.');
    * }
    */
+  /**
+   * @method ellipseMode
+   * @return {(CENTER|RADIUS|CORNER|CORNERS)}      the current ellipseMode.
+   */
   fn.ellipseMode = function(m) {
     // p5._validateParameters('ellipseMode', arguments);
     if (typeof m === 'undefined') { // getter
@@ -416,6 +422,8 @@ function attributes(p5, fn){
    * the constants `MITER`, `BEVEL`, and `ROUND` are defined this way.
    * JavaScript is a case-sensitive language.
    *
+   * Calling `strokeJoin()` without an argument returns the current stroke join style, either `MITER`, `BEVEL`, or `ROUND`.
+   *
    * @method strokeJoin
    * @param  {(MITER|BEVEL|ROUND)} join either MITER, BEVEL, or ROUND
    * @chainable
@@ -482,6 +490,10 @@ function attributes(p5, fn){
    *   describe('A right-facing arrowhead shape with a rounded tip in center of canvas.');
    * }
    */
+  /**
+   * @method strokeJoin
+   * @return {(MITER|BEVEL|ROUND)}      the current stroke join style.
+   */
   fn.strokeJoin = function(join) {
     // p5._validateParameters('strokeJoin', arguments);
     if (typeof join === 'undefined') { // getter
@@ -503,6 +515,8 @@ function attributes(p5, fn){
    *
    * Note: `strokeWeight()` is affected by transformations, especially calls to
    * <a href="#/p5/scale">scale()</a>.
+   * 
+   * Calling `strokeWeight()` without an argument returns the current stroke weight as a number.
    *
    * @method strokeWeight
    * @param  {Number} weight the weight of the stroke (in pixels).
@@ -545,6 +559,10 @@ function attributes(p5, fn){
    *   describe('Two horizontal black lines. The top line is thin and the bottom is five times thicker than the top.');
    * }
    */
+  /**
+   * @method strokeWeight
+   * @return {Number} the current stroke weight.
+   */
   fn.strokeWeight = function(w) {
     // p5._validateParameters('strokeWeight', arguments);
     return this._renderer.strokeWeight(w);

src/shape/custom_shapes.js

@@ -1611,6 +1611,8 @@ function customShapes(p5, fn) {
    * Note: `bezierVertex()` won’t work when an argument is passed to
    * <a href="#/p5/beginShape">beginShape()</a>.
    *
+   * Calling `bezierOrder()` without an argument returns the current Bézier order.
+   *
    * @method bezierOrder
    * @param {Number} order The new order to set. Can be either 2 or 3, by default 3
    *

src/webgl/material.js

@@ -2652,6 +2652,8 @@ function material(p5, fn) {
    *
    * Note: `textureMode()` can only be used in WebGL mode.
    *
+   * Calling `textureMode()` with no arguments returns the current texture mode.
+   *
    * @method  textureMode
    * @param {(IMAGE|NORMAL)} mode either IMAGE or NORMAL.
    *
@@ -2714,6 +2716,10 @@ function material(p5, fn) {
    *   endShape();
    * }
    */
+  /**
+   * @method textureMode
+   * @return {(IMAGE|NORMAL)} The current texture mode, either IMAGE or NORMAL.
+   */
   fn.textureMode = function (mode) {
     if (typeof mode === 'undefined') { // getter
       return this._renderer.states.textureMode;
@@ -2825,6 +2831,9 @@ function material(p5, fn) {
    *
    * Note: `textureWrap()` can only be used in WebGL mode.
    *
+   * Calling `textureWrap()` with no arguments returns an object with the current
+   * mode for x and y directions, as in `{ wrapX: CLAMP, wrapY: REPEAT }`.
+   *
    * @method textureWrap
    * @param {(CLAMP|REPEAT|MIRROR)} wrapX either CLAMP, REPEAT, or MIRROR
    * @param {(CLAMP|REPEAT|MIRROR)} [wrapY=wrapX] either CLAMP, REPEAT, or MIRROR
@@ -2980,6 +2989,10 @@ function material(p5, fn) {
    *   endShape();
    * }
    */
+  /**
+   * @method textureWrap
+   * @return {{x: (CLAMP|REPEAT|MIRROR), y: (CLAMP|REPEAT|MIRROR)}} The current texture wrapping for x and y.
+   */
   fn.textureWrap = function (wrapX, wrapY = wrapX) {
     if (typeof wrapX === 'undefined') { // getter
       return {