diff --git a/src/accessibility/outputs.js b/src/accessibility/outputs.js index 38ba679e38..e8af902fef 100644 --- a/src/accessibility/outputs.js +++ b/src/accessibility/outputs.js @@ -37,6 +37,19 @@ import p5 from '../core/main'; * Writing accessible canvas descriptions * to learn more about making sketches accessible. * + * `textOutput()` currently generates descriptions in English only. + * Text drawn with text() is not included in + * descriptions. WEBGL mode and 3D shapes are not supported. When rendering + * 2D primitives in WEBGL, descriptions may be imprecise as the camera's + * perspective is not accounted for. Shapes with similar features may be + * combined, which can affect shape counts. Shapes positioned outside the + * canvas boundaries may still be included in descriptions. Custom 2D shapes + * created with beginShape() are not supported. + * + * For more precise control over canvas descriptions, consider using + * describe() and + * describeElement(). + * * @method textOutput * @param {Constant} [display] either FALLBACK or LABEL. * @@ -82,10 +95,12 @@ import p5 from '../core/main'; * *
- * function draw() {
+ * function setup() {
* // Add the text description.
* textOutput();
+ * }
*
+ * function draw() {
* // Draw a moving circle.
* background(200);
* let x = frameCount * 0.1;
@@ -102,11 +117,13 @@ import p5 from '../core/main';
*
*
*
- * function draw() {
+ * function setup() {
* // Add the text description and
* // display it for debugging.
* textOutput(LABEL);
+ * }
*
+ * function draw() {
* // Draw a moving circle.
* background(200);
* let x = frameCount * 0.1;
@@ -172,6 +189,19 @@ p5.prototype.textOutput = function(display) {
* Writing accessible canvas descriptions
* to learn more about making sketches accessible.
*
+ * `gridOutput()` currently generates descriptions in English only.
+ * Text drawn with text() is not included in
+ * descriptions. WEBGL mode and 3D shapes are not supported. When rendering
+ * 2D primitives in WEBGL, descriptions may be imprecise as the camera's
+ * perspective is not accounted for. Shapes with similar features may be
+ * combined, which can affect shape counts. Shapes positioned outside the
+ * canvas boundaries may still be included in descriptions. Custom 2D shapes
+ * created with beginShape() are not supported.
+ *
+ * For more precise control over canvas descriptions, consider using
+ * describe() and
+ * describeElement().
+ *
* @method gridOutput
* @param {Constant} [display] either FALLBACK or LABEL.
*
@@ -217,10 +247,12 @@ p5.prototype.textOutput = function(display) {
*
*
*
- * function draw() {
+ * function setup() {
* // Add the grid description.
* gridOutput();
+ * }
*
+ * function draw() {
* // Draw a moving circle.
* background(200);
* let x = frameCount * 0.1;
@@ -237,11 +269,13 @@ p5.prototype.textOutput = function(display) {
*
*
*
- * function draw() {
+ * function setup() {
* // Add the grid description and
* // display it for debugging.
* gridOutput(LABEL);
+ * }
*
+ * function draw() {
* // Draw a moving circle.
* background(200);
* let x = frameCount * 0.1;