changes to reference docs

Author: hx2A

py5_docs/Reference/api_en/Py5Graphics_bezier_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-bezier_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+bezier_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of bezier vertex coordinates with 6 or 9 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of bezier vertex coordinates with 6 or 9 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of bezier vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5graphics_bezier_vertex) in a loop. For a large number of bezier vertices, the performance of `bezier_vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Graphics_curve_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-curve_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+curve_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of curve vertex coordinates with 2 or 3 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of curve vertex coordinates with 2 or 3 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of curve vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5graphics_curve_vertex) in a loop. For a large number of curve vertices, the performance of `curve_vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Graphics_lines.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = 2d_primitives
 
 @@ signatures
-lines(coordinates: npt.NDArray[np.floating], /) -> None
+lines(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of line coordinates with 4 or 6 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of line coordinates with 4 or 6 columns for 2D or 3D points, respectively
 
 @@ description
 Draw a collection of lines to the Py5Graphics drawing surface. The purpose of this method is to provide an alternative to repeatedly calling [](py5graphics_line) in a loop. For a large number of lines, the performance of `lines()` will be much faster.

py5_docs/Reference/api_en/Py5Graphics_mask.txt

@@ -8,11 +8,11 @@ processing_name = mask
 
 @@ signatures
 mask(img: Py5Image, /) -> None
-mask(mask_array: npt.NDArray[np.integer], /) -> None
+mask(mask_array: Iterator[int], /) -> None
 
 @@ variables
 img: Py5Image - image to use as the mask
-mask_array: npt.NDArray[np.integer] - 1D array of integers used as the alpha channel, needs to be the same length as the image's pixel array
+mask_array: Iterator[int] - 1D array of integers used as the alpha channel, needs to be the same length as the image's pixel array
 
 @@ description
 Masks part of the Py5Graphics drawing surface from displaying by loading an image and using it as an alpha channel. This mask image should only contain grayscale data, but only the blue color channel is used. The mask image needs to be the same size as the image to which it is applied.

py5_docs/Reference/api_en/Py5Graphics_points.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = 2d_primitives
 
 @@ signatures
-points(coordinates: npt.NDArray[np.floating], /) -> None
+points(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of point coordinates with 2 or 3 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of point coordinates with 2 or 3 columns for 2D or 3D points, respectively
 
 @@ description
 Draw a collection of points, each a coordinate in space at the dimension of one pixel. The purpose of this method is to provide an alternative to repeatedly calling [](py5graphics_point) in a loop. For a large number of points, the performance of `points()` will be much faster.

py5_docs/Reference/api_en/Py5Graphics_quadratic_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-quadratic_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+quadratic_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of quadratic vertex coordinates with 4 or 6 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of quadratic vertex coordinates with 4 or 6 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of quadratic vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5graphics_quadratic_vertex) in a loop. For a large number of quadratic vertices, the performance of `quadratic_vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Graphics_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-vertices(coordinates: npt.NDArray[np.floating], /) -> None
+vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of vertex coordinates and optional UV texture mapping values
+coordinates: Iterator[Iterator[float]] - 2D array of vertex coordinates and optional UV texture mapping values
 
 @@ description
 Create a collection of vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5graphics_vertex) in a loop. For a large number of vertices, the performance of `vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Image_mask.txt

@@ -8,11 +8,11 @@ processing_name = mask
 
 @@ signatures
 mask(img: Py5Image, /) -> None
-mask(mask_array: npt.NDArray[np.integer], /) -> None
+mask(mask_array: Iterator[int], /) -> None
 
 @@ variables
 img: Py5Image - image to use as the mask
-mask_array: npt.NDArray[np.integer] - 1D array of integers used as the alpha channel, needs to be the same length as the image's pixel array
+mask_array: Iterator[int] - 1D array of integers used as the alpha channel, needs to be the same length as the image's pixel array
 
 @@ description
 Masks part of an image from displaying by loading another image and using it as an alpha channel. This mask image should only contain grayscale data, but only the blue color channel is used. The mask image needs to be the same size as the image to which it is applied.

py5_docs/Reference/api_en/Py5Shader_set.txt

@@ -11,12 +11,12 @@ set(name: str, boolvec: JArray(JBoolean), ncoords: int, /) -> None
 set(name: str, mat: npt.NDArray[np.floating], /) -> None
 set(name: str, mat: npt.NDArray[np.floating], use3x3: bool, /) -> None
 set(name: str, tex: Py5Image, /) -> None
+set(name: str, vec: Iterator[float], /) -> None
+set(name: str, vec: Iterator[float], ncoords: int, /) -> None
+set(name: str, vec: Iterator[int], /) -> None
+set(name: str, vec: Iterator[int], ncoords: int, /) -> None
 set(name: str, vec: JArray(JBoolean), /) -> None
 set(name: str, vec: Py5Vector, /) -> None
-set(name: str, vec: npt.NDArray[np.floating], /) -> None
-set(name: str, vec: npt.NDArray[np.floating], ncoords: int, /) -> None
-set(name: str, vec: npt.NDArray[np.integer], /) -> None
-set(name: str, vec: npt.NDArray[np.integer], ncoords: int, /) -> None
 set(name: str, x: bool, /) -> None
 set(name: str, x: bool, y: bool, /) -> None
 set(name: str, x: bool, y: bool, z: bool, /) -> None
@@ -37,10 +37,10 @@ name: str - the name of the uniform variable to modify
 ncoords: int - number of coordinates per element, max 4
 tex: Py5Image - sets the sampler uniform variable to read from this image texture
 use3x3: bool - enforces the numpy array is 3 x 3
+vec: Iterator[float] - 1D numpy array of values to modify all the components of an array/vector uniform variable
+vec: Iterator[int] - 1D numpy array of values to modify all the components of an array/vector uniform variable
 vec: JArray(JBoolean) - modifies all the components of an array/vector uniform variable
 vec: Py5Vector - vector of values to modify all the components of an array/vector uniform variable
-vec: npt.NDArray[np.floating] - 1D numpy array of values to modify all the components of an array/vector uniform variable
-vec: npt.NDArray[np.integer] - 1D numpy array of values to modify all the components of an array/vector uniform variable
 w: bool - fourth component of the variable to modify. The variable has to be declared with an array/vector type in the shader (i.e.: int[4], vec4)
 w: float - fourth component of the variable to modify. The variable has to be declared with an array/vector type in the shader (i.e.: int[4], vec4)
 w: int - fourth component of the variable to modify. The variable has to be declared with an array/vector type in the shader (i.e.: int[4], vec4)

py5_docs/Reference/api_en/Py5Shape_bezier_vertices.txt

@@ -6,10 +6,10 @@ category = vertices
 subcategory = None
 
 @@ signatures
-bezier_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+bezier_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of bezier vertex coordinates with 6 or 9 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of bezier vertex coordinates with 6 or 9 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of bezier vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5shape_bezier_vertex) in a loop. For a large number of bezier vertices, the performance of `bezier_vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Shape_curve_vertices.txt

@@ -6,10 +6,10 @@ category = vertices
 subcategory = None
 
 @@ signatures
-curve_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+curve_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of curve vertex coordinates with 2 or 3 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of curve vertex coordinates with 2 or 3 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of curve vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5shape_curve_vertex) in a loop. For a large number of curve vertices, the performance of `curve_vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Shape_get_vertex_codes.txt

@@ -7,7 +7,7 @@ category = vertices
 subcategory = None
 
 @@ signatures
-get_vertex_codes() -> npt.NDArray[np.integer]
+get_vertex_codes() -> Iterator[int]
 
 @@ description
 Get the vertex codes for a `Py5Shape` object. The vertex codes can be used to inspect a shape's geometry to determine what kind of vertices it has. Each can be one of `BREAK`, `VERTEX`, `BEZIER_VERTEX`, `QUADRATIC_VERTEX` or `CURVE_VERTEX`.

py5_docs/Reference/api_en/Py5Shape_quadratic_vertices.txt

@@ -6,10 +6,10 @@ category = vertices
 subcategory = None
 
 @@ signatures
-quadratic_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+quadratic_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of quadratic vertex coordinates with 4 or 6 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of quadratic vertex coordinates with 4 or 6 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of quadratic vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5shape_quadratic_vertex) in a loop. For a large number of quadratic vertices, the performance of `quadratic_vertices()` will be much faster.

py5_docs/Reference/api_en/Py5Shape_set_fills.txt

@@ -5,10 +5,10 @@ subcategory = fill
 type = method
 
 @@ signatures
-set_fills(fills: npt.NDArray[np.int32], /) -> None
+set_fills(fills: Iterator[int], /) -> None
 
 @@ variables
-fills: npt.NDArray[np.int32] - array of fill colors
+fills: Iterator[int] - array of fill colors
 
 @@ description
 Set the fill color for each of the individual vertices of a `Py5Shape`. The length of the passed `fills` array must equal the number of vertices in the shape. This method exists to provide an alternative to repeatedly calling [](py5shape_set_fill) in a loop.

py5_docs/Reference/api_en/Py5Shape_set_path.txt

@@ -7,11 +7,11 @@ category = vertices
 subcategory = None
 
 @@ signatures
-set_path(vcount: int, verts: npt.NDArray[np.floating], /) -> None
+set_path(vcount: int, verts: Iterator[Iterator[float]], /) -> None
 
 @@ variables
 vcount: int - number of vertices
-verts: npt.NDArray[np.floating] - 2D array of vertex coordinates
+verts: Iterator[Iterator[float]] - 2D array of vertex coordinates
 
 @@ description
 Set many vertex points at the same time, using a numpy array. This will be faster and more efficient than repeatedly calling [](py5shape_set_vertex) in a loop. Setting the vertex codes is not supported, so the vertices will be regular vertices and not bezier, quadratic or curve vertices.

py5_docs/Reference/api_en/Py5Shape_set_strokes.txt

@@ -5,10 +5,10 @@ subcategory = stroke
 type = method
 
 @@ signatures
-set_strokes(strokes: npt.NDArray[np.int32], /) -> None
+set_strokes(strokes: Iterator[int], /) -> None
 
 @@ variables
-strokes: npt.NDArray[np.int32] - array of stroke colors
+strokes: Iterator[int] - array of stroke colors
 
 @@ description
 Set the stroke color for each of the individual vertices of a `Py5Shape`. The length of the passed `strokes` array must equal the number of vertices in the shape. This method exists to provide an alternative to repeatedly calling [](py5shape_set_fill) in a loop.

py5_docs/Reference/api_en/Py5Shape_vertices.txt

@@ -6,10 +6,10 @@ category = vertices
 subcategory = None
 
 @@ signatures
-vertices(coordinates: npt.NDArray[np.floating], /) -> None
+vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of vertex coordinates and optional UV texture mapping values
+coordinates: Iterator[Iterator[float]] - 2D array of vertex coordinates and optional UV texture mapping values
 
 @@ description
 Create a collection of vertices. The purpose of this method is to provide an alternative to repeatedly calling [](py5shape_vertex) in a loop. For a large number of vertices, the performance of `vertices()` will be much faster.

py5_docs/Reference/api_en/Sketch_bezier_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-bezier_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+bezier_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of bezier vertex coordinates with 6 or 9 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of bezier vertex coordinates with 6 or 9 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of bezier vertices. The purpose of this method is to provide an alternative to repeatedly calling [](sketch_bezier_vertex) in a loop. For a large number of bezier vertices, the performance of `bezier_vertices()` will be much faster.

py5_docs/Reference/api_en/Sketch_curve_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-curve_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+curve_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of curve vertex coordinates with 2 or 3 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of curve vertex coordinates with 2 or 3 columns for 2D or 3D points, respectively
 
 @@ description
 Create a collection of curve vertices. The purpose of this method is to provide an alternative to repeatedly calling [](sketch_curve_vertex) in a loop. For a large number of curve vertices, the performance of `curve_vertices()` will be much faster.

py5_docs/Reference/api_en/Sketch_lines.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = 2d_primitives
 
 @@ signatures
-lines(coordinates: npt.NDArray[np.floating], /) -> None
+lines(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of line coordinates with 4 or 6 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of line coordinates with 4 or 6 columns for 2D or 3D points, respectively
 
 @@ description
 Draw a collection of lines to the screen. The purpose of this method is to provide an alternative to repeatedly calling [](sketch_line) in a loop. For a large number of lines, the performance of `lines()` will be much faster.

py5_docs/Reference/api_en/Sketch_points.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = 2d_primitives
 
 @@ signatures
-points(coordinates: npt.NDArray[np.floating], /) -> None
+points(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of point coordinates with 2 or 3 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - 2D array of point coordinates with 2 or 3 columns for 2D or 3D points, respectively
 
 @@ description
 Draw a collection of points, each a coordinate in space at the dimension of one pixel. The purpose of this method is to provide an alternative to repeatedly calling [](sketch_point) in a loop. For a large number of points, the performance of `points()` will be much faster.

py5_docs/Reference/api_en/Sketch_quadratic_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-quadratic_vertices(coordinates: npt.NDArray[np.floating], /) -> None
+quadratic_vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of quadratic vertex coordinates with 4 or 6 columns for 2D or 3D points, respectively
+coordinates: Iterator[Iterator[float]] - missing variable description
 
 @@ description
 Create a collection of quadratic vertices. The purpose of this method is to provide an alternative to repeatedly calling [](sketch_quadratic_vertex) in a loop. For a large number of quadratic vertices, the performance of `quadratic_vertices()` will be much faster.

py5_docs/Reference/api_en/Sketch_vertices.txt

@@ -6,10 +6,10 @@ category = shape
 subcategory = vertex
 
 @@ signatures
-vertices(coordinates: npt.NDArray[np.floating], /) -> None
+vertices(coordinates: Iterator[Iterator[float]], /) -> None
 
 @@ variables
-coordinates: npt.NDArray[np.floating] - 2D array of vertex coordinates and optional UV texture mapping values
+coordinates: Iterator[Iterator[float]] - 2D array of vertex coordinates and optional UV texture mapping values
 
 @@ description
 Create a collection of vertices. The purpose of this method is to provide an alternative to repeatedly calling [](sketch_vertex) in a loop. For a large number of vertices, the performance of `vertices()` will be much faster.