+ *
+ *
* function setup() {
* let name = 'ada';
* // Prints "hello, ada" to the console.
diff --git a/src/core/main.js b/src/core/main.js
index 75d10c7398..a5c9a6c93d 100644
--- a/src/core/main.js
+++ b/src/core/main.js
@@ -464,10 +464,14 @@ for (const k in constants) {
* ```
*
* Code placed in `setup()` will run once before code placed in
- * draw() begins looping. If the
- * preload() is declared, then `setup()` will
- * run immediately after preload() finishes
- *
+ * draw() begins looping.
+ * If `setup()` is declared `async` (e.g. `async function setup()`),
+ * execution pauses at each `await` until its promise resolves.
+ * For example, `font = await loadFont(...)` waits for the font asset
+ * to load because `loadFont()` function returns a promise, and the await
+ * keyword means the program will wait for the promise to resolve.
+ * This ensures that all assets are fully loaded before the sketch continues.
+
*
* loading assets.
*
@@ -539,7 +543,6 @@ for (const k in constants) {
*
*
*
+ * let rotationX = 0; // Angle in degrees
+ *
* function setup() {
- * createCanvas(100, 100, WEBGL);
+ * createCanvas(200, 200, WEBGL); // Create 3D canvas
* }
*
* function draw() {
- * background(200);
- * //rotateZ(radians(rotationZ));
- * rotateX(radians(rotationX));
- * //rotateY(radians(rotationY));
- * box(200, 200, 200);
- * describe(`red horizontal line right, green vertical line bottom.
- * black background.`);
+ * background(220); // Set light gray background
+ * rotateX(radians(rotationX)); // Rotate around X-axis
+ * normalMaterial(); // Apply simple shaded material
+ * box(60); // Draw 3D cube (60 units wide)
+ * rotationX = (rotationX + 2) % 360; // Increment rotation (2° per frame)
* }
*
*
@@ -175,18 +175,18 @@ function acceleration(p5, fn){
* @example
*
*
+ * let rotationY = 0; // Angle in degrees
+ *
* function setup() {
- * createCanvas(100, 100, WEBGL);
+ * createCanvas(200, 200, WEBGL); // Create 3D canvas
* }
*
* function draw() {
- * background(200);
- * //rotateZ(radians(rotationZ));
- * //rotateX(radians(rotationX));
- * rotateY(radians(rotationY));
- * box(200, 200, 200);
- * describe(`red horizontal line right, green vertical line bottom.
- * black background.`);
+ * background(220); // Set light gray background
+ * rotateY(radians(rotationY)); // Rotate around Y-axis (vertical)
+ * normalMaterial(); // Apply simple shaded material
+ * box(60); // Draw 3D cube (60 units wide)
+ * rotationY = (rotationY + 2) % 360; // Increment rotation (2° per frame)
* }
*
*
@@ -209,18 +209,18 @@ function acceleration(p5, fn){
* @example
*
*
+ * let rotationZ = 0; // Angle in degrees
+ *
* function setup() {
- * createCanvas(100, 100, WEBGL);
+ * createCanvas(200, 200, WEBGL); // Create 3D canvas
* }
*
* function draw() {
- * background(200);
- * rotateZ(radians(rotationZ));
- * //rotateX(radians(rotationX));
- * //rotateY(radians(rotationY));
- * box(200, 200, 200);
- * describe(`red horizontal line right, green vertical line bottom.
- * black background.`);
+ * background(220);
+ * rotateZ(radians(rotationZ)); // Rotate around Z-axis
+ * normalMaterial(); // Apply simple shaded material
+ * box(60); // Draw 3D cube
+ * rotationZ = (rotationZ + 2) % 360; // Increment rotation angle
* }
*
*
diff --git a/src/image/p5.Image.js b/src/image/p5.Image.js
index 4b1002012e..0fad23a429 100644
--- a/src/image/p5.Image.js
+++ b/src/image/p5.Image.js
@@ -1637,7 +1637,7 @@ class Image {
*
* async function setup() {
* // Load the image.
- * gif = await loadImage('assets/arnott-wallace-wink-loop-forever.gif');
+ * gif = await loadImage('assets/arnott-wallace-eye-loop-forever.gif');
*
* createCanvas(100, 100);
*
@@ -1677,7 +1677,7 @@ class Image {
*
* async function setup() {
* // Load the image.
- * gif = await loadImage('assets/arnott-wallace-wink-loop-forever.gif');
+ * gif = await loadImage('assets/arnott-wallace-eye-loop-forever.gif');
*
* createCanvas(100, 100);
*
@@ -1733,7 +1733,7 @@ class Image {
*
* async function setup() {
* // Load the image.
- * gif = await loadImage('assets/arnott-wallace-wink-loop-forever.gif');
+ * gif = await loadImage('assets/arnott-wallace-eye-loop-forever.gif');
*
* createCanvas(100, 100);
*
diff --git a/src/image/pixels.js b/src/image/pixels.js
index e1d1edd614..ebea101273 100644
--- a/src/image/pixels.js
+++ b/src/image/pixels.js
@@ -41,6 +41,7 @@ function pixels(p5, fn){
*
* function setup() {
* createCanvas(100, 100);
+ * background(128);
*
* // Load the pixels array.
* loadPixels();
diff --git a/src/io/files.js b/src/io/files.js
index b98bf009f6..2a23bb71db 100644
--- a/src/io/files.js
+++ b/src/io/files.js
@@ -950,7 +950,7 @@ function files(p5, fn){
* }
*
* function mousePressed() {
- * httpPost(url, 'json', postData, function(result) {
+ * httpPost(url, postData, 'json', function(result) {
* strokeWeight(2);
* text(result.body, mouseX, mouseY);
* });
@@ -970,8 +970,8 @@ function files(p5, fn){
* function mousePressed() {
* httpPost(
* url,
- * 'json',
* postData,
+ * 'json',
* function(result) {
* // ... won't be called
* },
@@ -1089,20 +1089,29 @@ function files(p5, fn){
* let eqFeatureIndex = 0;
*
* function setup() {
+ * createCanvas(100,100);
+ *
* let url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';
+ *
+ * const req = new Request(url, {
+ * method: 'GET',
+ * headers: {authorization: 'Bearer secretKey'}
+ * });
+ * // httpDo(path, method, datatype, success, error)
+ *
* httpDo(
- * url,
- * {
- * method: 'GET',
- * // Other Request options, like special headers for apis
- * headers: { authorization: 'Bearer secretKey' }
+ * req,
+ * 'GET',
+ * 'json',
+ * res => {
+ * earthquakes = res;
* },
- * function(res) {
- * earthquakes = res;
- * }
- * );
+ * err => {
+ * console.error('Error loading data:', err);
+ * }
+ * );
* }
- *
+ *
* function draw() {
* // wait until the data is loaded
* if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {
diff --git a/src/io/p5.TableRow.js b/src/io/p5.TableRow.js
index ae5f04652c..c5f1dfd4ea 100644
--- a/src/io/p5.TableRow.js
+++ b/src/io/p5.TableRow.js
@@ -255,8 +255,8 @@ class TableRow {
* let table;
*
* async function setup() {
- * // Create a 200x100 canvas and set a white background
- * createCanvas(200, 100);
+ * // Create a 300x100 canvas and set a white background
+ * createCanvas(300, 100);
* background(255);
*
* // Load the CSV file with a header row
diff --git a/src/type/textCore.js b/src/type/textCore.js
index e4a5a1107f..11c863d650 100644
--- a/src/type/textCore.js
+++ b/src/type/textCore.js
@@ -1240,7 +1240,7 @@ function textCore(p5, fn) {
* createCanvas(300, 300);
* background(220);
*
- * textSize(48);
+ * textSize(35);
* textAlign(LEFT, BASELINE);
* textFont('Georgia');
*
diff --git a/src/webgl/p5.Camera.js b/src/webgl/p5.Camera.js
index c6f30660c0..bca2efb2a2 100644
--- a/src/webgl/p5.Camera.js
+++ b/src/webgl/p5.Camera.js
@@ -71,7 +71,7 @@ class Camera {
* fill(0);
*
* // Display the value of eyeX, rounded to the nearest integer.
- * text(`eyeX: ${round(cam.eyeX)}`, 0, 55);
+ * text(`eyeX: ${round(cam.eyeX)}`, 0, 45);
* }
*
*