@thi.ng/webgl 6.4.23 → 6.5.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-08-31T10:05:26Z
+- **Last updated**: 2023-09-25T07:43:28Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [6.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/webgl@6.5.0) (2023-09-19)
+
+#### 🚀 Features
+
+- update clearCanvas(), add defaultViewport() ([a7b47a2](https://github.com/thi-ng/umbrella/commit/a7b47a2))
+
 ### [6.4.20](https://github.com/thi-ng/umbrella/tree/@thi.ng/webgl@6.4.20) (2023-08-31)
 
 #### ♻️ Refactoring

package/README.md

@@ -96,7 +96,7 @@ For Node.js REPL:
 const webgl = await import("@thi.ng/webgl");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 11.39 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 11.44 KB
 
 ## Dependencies
 

package/canvas.d.ts

@@ -9,12 +9,22 @@ export declare const glCanvas: (opts?: Partial<WeblGLCanvasOpts>) => {
 };
 export declare const getExtensions: <K extends keyof WebGLExtensionMap>(gl: WebGLRenderingContext, ids: K[], required?: boolean) => Pick<WebGLExtensionMap, K>;
 /**
- * Sets clear color to given RGBA `color` and clears viewport's
+ * Sets clear color to given RGB(A) `color` and clears viewport's
  * `COLOR_BUFFER_BIT` and (by default) also `DEPTH_BUFFER_BIT`.
  *
+ * @remarks
+ * If the given color vector only contains RGB values, alpha will default to
+ * 1.0.
+ *
  * @param gl
  * @param color
  * @param depth
  */
 export declare const clearCanvas: (gl: WebGLRenderingContext, [r, g, b, a]: ReadonlyVec, depth?: boolean) => void;
+/**
+ * Resets viewport to full drawing buffer size.
+ *
+ * @param gl
+ */
+export declare const defaultViewport: (gl: WebGLRenderingContext) => void;
 //# sourceMappingURL=canvas.d.ts.map

package/canvas.js

@@ -49,14 +49,24 @@ export const getExtensions = (gl, ids, required = true) => {
     return ext;
 };
 /**
- * Sets clear color to given RGBA `color` and clears viewport's
+ * Sets clear color to given RGB(A) `color` and clears viewport's
  * `COLOR_BUFFER_BIT` and (by default) also `DEPTH_BUFFER_BIT`.
  *
+ * @remarks
+ * If the given color vector only contains RGB values, alpha will default to
+ * 1.0.
+ *
  * @param gl
  * @param color
  * @param depth
  */
 export const clearCanvas = (gl, [r, g, b, a], depth = true) => {
-    gl.clearColor(r, g, b, a);
+    gl.clearColor(r, g, b, a != null ? a : 1);
     gl.clear(gl.COLOR_BUFFER_BIT | (depth ? gl.DEPTH_BUFFER_BIT : 0));
 };
+/**
+ * Resets viewport to full drawing buffer size.
+ *
+ * @param gl
+ */
+export const defaultViewport = (gl) => gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/webgl",
-  "version": "6.4.23",
+  "version": "6.5.1",
   "description": "WebGL & GLSL abstraction layer",
   "type": "module",
   "module": "./index.js",
@@ -45,7 +45,7 @@
     "@thi.ng/equiv": "^2.1.30",
     "@thi.ng/errors": "^2.3.5",
     "@thi.ng/logger": "^1.4.21",
-    "@thi.ng/matrices": "^2.1.72",
+    "@thi.ng/matrices": "^2.1.73",
     "@thi.ng/memoize": "^3.1.38",
     "@thi.ng/pixel": "^4.2.22",
     "@thi.ng/shader-ast": "^0.12.68",
@@ -219,5 +219,5 @@
     ],
     "year": 2014
   },
-  "gitHead": "c22e8996cee284ebe8ea88582beb1ab5fc6ee503\n"
+  "gitHead": "fb2697579b193b609ec52237ea0d99c7295b6d3c\n"
 }