p5 2.2.1-rc.0 → 2.2.1

package/dist/type/textCore.js

@@ -1,14 +1,13 @@
-import { R as Renderer } from '../p5.Renderer-QoFcvj3f.js';
-import '../creating_reading-CgHCHxqN.js';
+import { R as Renderer } from '../p5.Renderer-D-5LdCRz.js';
+import '../creating_reading-ZXzcZEsb.js';
 import 'colorjs.io/fn';
 import '../color/color_spaces/hsb.js';
-import '../constants-DEJVKr9Z.js';
+import '../constants-DQyACdzq.js';
 import '../image/filters.js';
 import '../math/p5.Vector.js';
 import '../shape/custom_shapes.js';
 import '../core/States.js';
 import '../io/utilities.js';
-import 'file-saver';
 
 /**
  * @module Typography
@@ -105,8 +104,6 @@ function textCore(p5, fn) {
    *
    * @for p5
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background(200);
@@ -114,11 +111,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "hi" written in black in the middle of a gray square.');
    * }
-   * </code>
-   * </div>
    *
-   * <div>
-   * <code>
+   * @example
    * function setup() {
    *   createCanvas(100, 100);
    *   background('skyblue');
@@ -127,12 +121,8 @@ function textCore(p5, fn) {
    *
    *   describe('A rainbow in a blue sky.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   textSize(32);
@@ -143,12 +133,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "hi" written in white with a black outline.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background('black');
@@ -164,12 +150,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "rainbows" written on several lines, each in a different color.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background(200);
@@ -178,12 +160,8 @@ function textCore(p5, fn) {
    *
    *   describe('The sample text "The quick brown fox..." written in black across several lines.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background(200);
@@ -193,12 +171,8 @@ function textCore(p5, fn) {
    *
    *   describe('The sample text "The quick brown fox..." written in black across several lines.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div modernizr='webgl'>
-   * <code>
    * let font;
    *
    * async function setup() {
@@ -216,8 +190,6 @@ function textCore(p5, fn) {
    *
    *   describe('The text "p5*js" written in white and spinning in 3D.');
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -245,8 +217,6 @@ function textCore(p5, fn) {
    * @param {TOP|BOTTOM|CENTER|BASELINE} [vertAlign] vertical alignment
    * @returns {Object} If no arguments are provided, returns an object with current horizontal and vertical alignment
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -271,12 +241,8 @@ function textCore(p5, fn) {
    *
    *   describe('The letters ABCD displayed at top-left, EFGH at center, and IJKL at bottom-right. A vertical line divides the canvas in half.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -306,8 +272,6 @@ function textCore(p5, fn) {
    *
    *   describe('The words "TOP", "CENTER", "BASELINE", and "BOTTOM" each drawn relative to a horizontal line. Their positions demonstrate different vertical alignments.');
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -327,8 +291,6 @@ function textCore(p5, fn) {
    * @returns {Number} The ascent value in pixels.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(400, 300);
    *   background(220);
@@ -357,13 +319,8 @@ function textCore(p5, fn) {
    *   textSize(16);
    *   text("textAscent: " + asc.toFixed(2) + " pixels", x, y - asc - 10);
    * }
-   * </code>
-   * </div>
-   *
    *
    * @example
-   * <div>
-   * <code>
    * let font;
    *
    * async function setup()  {
@@ -402,11 +359,8 @@ function textCore(p5, fn) {
    *
    *   describe('The letters "dp" written twice in different sizes. Each version has a horizontal baseline. A vertical line extends upward from each baseline to the top of the "d".');
    * }
-   * </code>
-   * </div>
    */
 
-
   /**
    * Returns the descent of the text.
    *
@@ -424,8 +378,6 @@ function textCore(p5, fn) {
    * @returns {Number} The descent value in pixels.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(400, 300);
    *   background(220);
@@ -454,12 +406,8 @@ function textCore(p5, fn) {
    *   textSize(16);
    *   text("textDescent: " + desc.toFixed(2) + " pixels", x, y + desc + 20);
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * let font;
    *
    * async function setup()  {
@@ -498,8 +446,6 @@ function textCore(p5, fn) {
    *
    *   describe('The letters "dp" written twice in different sizes. Each version has a horizontal baseline. A vertical line extends downward from each baseline to the bottom of the "p".');
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -516,8 +462,6 @@ function textCore(p5, fn) {
    * @returns {Number} If no arguments are provided, the current text leading
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -535,8 +479,6 @@ function textCore(p5, fn) {
    *
    *   describe('The words "one" and "two" written on separate lines twice. The words on the left have less vertical spacing than the words on the right.');
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -561,8 +503,6 @@ function textCore(p5, fn) {
    * @for p5
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background(200);
@@ -572,12 +512,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "hi" written in a black, monospace font on a gray background.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background('black');
@@ -588,12 +524,8 @@ function textCore(p5, fn) {
    *
    *   describe('A text prompt from a game is written in a green, monospace font on a black background.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *   background(200);
@@ -603,12 +535,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "Verdana" written in a black, sans-serif font on a gray background.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * let fontRegular;
    * let fontItalic;
    * let fontBold;
@@ -629,8 +557,6 @@ function textCore(p5, fn) {
    *
    *   describe('The statements "I am Normal", "I am Italic", and "I am Bold" written in black on separate lines. The statements have normal, italic, and bold fonts, respectively.');
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -649,8 +575,6 @@ function textCore(p5, fn) {
    * @returns {Number} If no arguments are provided, the current text size in pixels.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(600, 200);
    *   background(240);
@@ -670,12 +594,8 @@ function textCore(p5, fn) {
    *   textSize(16);
    *   text("Current text size: " + currentSize, width / 2, height - 20);
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -695,8 +615,6 @@ function textCore(p5, fn) {
    *
    *   describe('The text "Font Size 12" drawn small, "Font Size 14" drawn medium, and "Font Size 16" drawn large.');
    * }
-   * </code>
-   * </div>
    */
   /**
    * @method textSize
@@ -720,8 +638,6 @@ function textCore(p5, fn) {
    * @returns {NORMAL|ITALIC|BOLD|BOLDITALIC} If no arguments are provided, the current style
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -749,8 +665,6 @@ function textCore(p5, fn) {
    *
    *   describe('The words "Normal" displayed normally, "Italic" in italic, "Bold" in bold, and "Bold Italic" in bold italics.');
    * }
-   * </code>
-   * </div>
    */
   /**
    * @method textStyle
@@ -780,8 +694,6 @@ function textCore(p5, fn) {
    * @returns {Number} The width of the text
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(200, 200);
    *   background(220);
@@ -805,12 +717,8 @@ function textCore(p5, fn) {
    *   textSize(20);
    *   text("Text width: " + tw, 10, 150);
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -832,12 +740,8 @@ function textCore(p5, fn) {
    *
    *   describe('The word "yoyo" underlined.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(200, 160);
    *   background(235);
@@ -874,12 +778,8 @@ function textCore(p5, fn) {
    *
    *   describe('Three lines: Hello with 0, 2, and many trailing spaces. Red boxes use textWidth and are identical. Captions show spaces as dots.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -902,8 +802,6 @@ function textCore(p5, fn) {
    *
    *   describe('The word "yo" written twice, one copy beneath the other. The words are divided by a horizontal line.');
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -931,8 +829,6 @@ function textCore(p5, fn) {
    * @returns {CHAR|WORD} If no arguments are provided, the current wrapping style
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -947,12 +843,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "Have a wonderful day" written across three lines.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -967,12 +859,8 @@ function textCore(p5, fn) {
    *
    *   describe('The text "Have a wonderful day" written across two lines.');
    * }
-   * </code>
-   * </div>
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(100, 100);
    *
@@ -987,8 +875,6 @@ function textCore(p5, fn) {
    *
    *   describe('The text "祝你有美好的一天" written across two lines.');
    * }
-   * </code>
-   * </div>
    */
   /**
    * @method textWrap
@@ -996,7 +882,6 @@ function textCore(p5, fn) {
    * @returns {CHAR|WORD} The current wrapping style
    */
 
-
   /**
    * Computes the tight bounding box for a block of text.
    *
@@ -1021,8 +906,6 @@ function textCore(p5, fn) {
    *                   bounding box of the rendered text.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 200);
    *   background(220);
@@ -1044,11 +927,8 @@ function textCore(p5, fn) {
    *   stroke('red');
    *   rect(bounds.x, bounds.y, bounds.w, bounds.h);
    * }
-   * </code>
-   * </div>
    */
 
-
   /**
    * Sets or gets the text drawing direction.
    *
@@ -1066,8 +946,6 @@ function textCore(p5, fn) {
    * @returns {String} If no arguments are provided, the current text direction, either "ltr", "rtl", or "inherit"
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 300);
    *   background(240);
@@ -1091,8 +969,6 @@ function textCore(p5, fn) {
    *   textAlign(LEFT, TOP);
    *   text("Current textDirection: " + textDirection(), 50, 250);
    * }
-   * </code>
-   * </div>
    */
   /**
    * @method textDirection
@@ -1121,8 +997,6 @@ function textCore(p5, fn) {
    * @returns If no arguments are provided, the current value of the specified text property
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 300);
    *   background(240);
@@ -1147,8 +1021,6 @@ function textCore(p5, fn) {
    *   text("Current textAlign: " + currentAlign, 50, 150);
    *   text("Current textBaseline: " + currentBaseline, 50, 170);
    * }
-   * </code>
-   * </div>
    */
   /**
    * @method textProperty
@@ -1202,8 +1074,6 @@ function textCore(p5, fn) {
    *                   bounding box of the text based on the font's intrinsic metrics.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 200);
    *   background(240);
@@ -1229,11 +1099,8 @@ function textCore(p5, fn) {
    *   text("Font Bounds: x=" + bounds.x.toFixed(1) + ", y=" + bounds.y.toFixed(1) +
    *        ", w=" + bounds.w.toFixed(1) + ", h=" + bounds.h.toFixed(1), 8, 100);
    * }
-   * </code>
-   * </div>
    */
 
-
   /**
    * Returns the loose width of a text string based on the current font.
    *
@@ -1251,8 +1118,6 @@ function textCore(p5, fn) {
    * @returns {Number} The loose width of the text in pixels.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 200);
    *   background(240);
@@ -1275,11 +1140,8 @@ function textCore(p5, fn) {
    *   textSize(16);
    *   text("Font width: " + fw.toFixed(2) + " pixels", 50, 100);
    * }
-   * </code>
-   * </div>
    */
 
-
   /**
    * Returns the loose ascent of the text based on the font's intrinsic metrics.
    *
@@ -1294,8 +1156,6 @@ function textCore(p5, fn) {
    * @returns {Number} The loose ascent value in pixels.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 300);
    *   background(220);
@@ -1324,8 +1184,6 @@ function textCore(p5, fn) {
    *   textSize(16);
    *   text("fontAscent: " + fasc.toFixed(2) + " pixels", x, y + fdesc + 20);
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -1342,8 +1200,6 @@ function textCore(p5, fn) {
    * @returns {Number} The loose descent value in pixels.
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 300);
    *   background(220);
@@ -1372,8 +1228,6 @@ function textCore(p5, fn) {
    *   textSize(16);
    *   text("fontDescent: " + fdesc.toFixed(2) + " pixels", x, y + fdesc + 20);
    * }
-   * </code>
-   * </div>
    */
 
   /**
@@ -1392,8 +1246,6 @@ function textCore(p5, fn) {
    * @returns {Number} If no arguments are provided, the current font weight
    *
    * @example
-   * <div>
-   * <code>
    * function setup() {
    *   createCanvas(300, 200);
    *   background(240);
@@ -1425,11 +1277,8 @@ function textCore(p5, fn) {
    *   text("Normal Weight: " + normalWeight, 150, 52);
    *   text("Bold Weight: " + boldWeight, 150, 100);
    * }
-   * </code>
-   * </div>
    *
-   * <div>
-   * <code>
+   * @example
    * let font;
    *
    * async function setup() {
@@ -1448,8 +1297,6 @@ function textCore(p5, fn) {
    *   text('p5*js', 0, 10);
    *   describe('The text p5*js pulsing its weight over time');
    * }
-   * </code>
-   * </div>
    */
   /**
    * @method textWeight