@antv/l7-renderer 2.9.21 → 2.9.23

package/es/index.js

@@ -1,3 +1,5 @@
-import ReglRendererService from './regl';
-export { ReglRendererService };
-//# sourceMappingURL=index.js.map
+/**
+ *
+ */
+import ReglRendererService from "./regl";
+export { ReglRendererService };

package/es/regl/ReglAttribute.js

@@ -1,15 +1,13 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
-var ReglAttribute = function () {
+/**
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#attributes
+ */
+var ReglAttribute = /*#__PURE__*/function () {
   function ReglAttribute(gl, options) {
     _classCallCheck(this, ReglAttribute);
 
-    _defineProperty(this, "attribute", void 0);
-
-    _defineProperty(this, "buffer", void 0);
-
     var buffer = options.buffer,
         offset = options.offset,
         stride = options.stride,
@@ -50,5 +48,4 @@ var ReglAttribute = function () {
   return ReglAttribute;
 }();
 
-export { ReglAttribute as default };
-//# sourceMappingURL=ReglAttribute.js.map
+export { ReglAttribute as default };

package/es/regl/ReglBuffer.js

@@ -1,22 +1,24 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { gl } from '@antv/l7-core';
-import { dataTypeMap, usageMap } from './constants';
+import { dataTypeMap, usageMap } from "./constants";
+/**
+ * adaptor for regl.Buffer
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#buffers
+ */
 
-var ReglBuffer = function () {
+var ReglBuffer = /*#__PURE__*/function () {
   function ReglBuffer(reGl, options) {
     _classCallCheck(this, ReglBuffer);
 
-    _defineProperty(this, "buffer", void 0);
-
     var data = options.data,
         usage = options.usage,
         type = options.type;
     this.buffer = reGl.buffer({
       data: data,
       usage: usageMap[usage || gl.STATIC_DRAW],
-      type: dataTypeMap[type || gl.UNSIGNED_BYTE]
+      type: dataTypeMap[type || gl.UNSIGNED_BYTE] // length: 0,
+
     });
   }
 
@@ -42,5 +44,4 @@ var ReglBuffer = function () {
   return ReglBuffer;
 }();
 
-export { ReglBuffer as default };
-//# sourceMappingURL=ReglBuffer.js.map
+export { ReglBuffer as default };

package/es/regl/ReglElements.js

@@ -1,15 +1,15 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { gl } from '@antv/l7-core';
-import { dataTypeMap, usageMap } from './constants';
+import { dataTypeMap, usageMap } from "./constants";
+/**
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#elements
+ */
 
-var ReglElements = function () {
+var ReglElements = /*#__PURE__*/function () {
   function ReglElements(reGl, options) {
     _classCallCheck(this, ReglElements);
 
-    _defineProperty(this, "elements", void 0);
-
     var data = options.data,
         usage = options.usage,
         type = options.type,
@@ -35,11 +35,11 @@ var ReglElements = function () {
     }
   }, {
     key: "destroy",
-    value: function destroy() {}
+    value: function destroy() {// this.elements.destroy();
+    }
   }]);
 
   return ReglElements;
 }();
 
-export { ReglElements as default };
-//# sourceMappingURL=ReglElements.js.map
+export { ReglElements as default };

package/es/regl/ReglFramebuffer.js

@@ -1,13 +1,14 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
-var ReglFramebuffer = function () {
+/**
+ * adaptor for regl.Framebuffer
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#framebuffers
+ */
+var ReglFramebuffer = /*#__PURE__*/function () {
   function ReglFramebuffer(reGl, options) {
     _classCallCheck(this, ReglFramebuffer);
 
-    _defineProperty(this, "framebuffer", void 0);
-
     var width = options.width,
         height = options.height,
         color = options.color,
@@ -27,7 +28,8 @@ var ReglFramebuffer = function () {
 
     if (color && typeof color !== 'boolean') {
       framebufferOptions.color = color.get();
-    }
+    } // TODO: depth & stencil
+
 
     this.framebuffer = reGl.framebuffer(framebufferOptions);
   }
@@ -54,5 +56,4 @@ var ReglFramebuffer = function () {
   return ReglFramebuffer;
 }();
 
-export { ReglFramebuffer as default };
-//# sourceMappingURL=ReglFramebuffer.js.map
+export { ReglFramebuffer as default };

package/es/regl/ReglModel.js

@@ -1,34 +1,21 @@
 import _typeof from "@babel/runtime/helpers/typeof";
+import _objectSpread from "@babel/runtime/helpers/objectSpread2";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import _isTypedArray from "lodash/isTypedArray";
-import _isPlainObject from "lodash/isPlainObject";
-import _cloneDeep from "lodash/cloneDeep";
-
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-
 import { gl } from '@antv/l7-core';
-import { blendEquationMap, blendFuncMap, cullFaceMap, depthFuncMap, primitiveMap, stencilFuncMap, stencilOpMap } from './constants';
+import { cloneDeep, isPlainObject, isTypedArray } from 'lodash';
+import { blendEquationMap, blendFuncMap, cullFaceMap, depthFuncMap, primitiveMap, stencilFuncMap, stencilOpMap } from "./constants";
 
-var ReglModel = function () {
+/**
+ * adaptor for regl.DrawCommand
+ */
+var ReglModel = /*#__PURE__*/function () {
   function ReglModel(reGl, options) {
     _classCallCheck(this, ReglModel);
 
-    _defineProperty(this, "reGl", void 0);
-
     _defineProperty(this, "destroyed", false);
 
-    _defineProperty(this, "drawCommand", void 0);
-
-    _defineProperty(this, "drawPickCommand", void 0);
-
-    _defineProperty(this, "drawParams", void 0);
-
-    _defineProperty(this, "options", void 0);
-
     _defineProperty(this, "uniforms", {});
 
     this.reGl = reGl;
@@ -50,6 +37,8 @@ var ReglModel = function () {
     if (uniforms) {
       this.uniforms = this.extractUniforms(uniforms);
       Object.keys(uniforms).forEach(function (uniformName) {
+        // use regl prop API
+        // @ts-ignore
         reglUniforms[uniformName] = reGl.prop(uniformName);
       });
     }
@@ -69,7 +58,8 @@ var ReglModel = function () {
 
     if (instances) {
       drawParams.instances = instances;
-    }
+    } // elements 中可能包含 count，此时不应传入
+
 
     if (count) {
       drawParams.count = count;
@@ -92,9 +82,7 @@ var ReglModel = function () {
       cull: cull
     }, drawParams);
     this.drawCommand = reGl(drawParams);
-
-    var pickDrawParams = _cloneDeep(drawParams);
-
+    var pickDrawParams = cloneDeep(drawParams);
     pickDrawParams.blend = _objectSpread(_objectSpread({}, pickDrawParams.blend), {}, {
       enable: false
     });
@@ -112,9 +100,7 @@ var ReglModel = function () {
       this.drawParams.attributes = reglAttributes;
       this.drawParams.elements = elements.get();
       this.drawCommand = this.reGl(this.drawParams);
-
-      var pickDrawParams = _cloneDeep(this.drawParams);
-
+      var pickDrawParams = cloneDeep(this.drawParams);
       pickDrawParams.blend = _objectSpread(_objectSpread({}, pickDrawParams.blend), {}, {
         enable: false
       });
@@ -129,9 +115,7 @@ var ReglModel = function () {
       });
       this.drawParams.attributes = reglAttributes;
       this.drawCommand = this.reGl(this.drawParams);
-
-      var pickDrawParams = _cloneDeep(this.drawParams);
-
+      var pickDrawParams = cloneDeep(this.drawParams);
       pickDrawParams.blend = _objectSpread(_objectSpread({}, pickDrawParams.blend), {}, {
         enable: false
       });
@@ -145,6 +129,7 @@ var ReglModel = function () {
   }, {
     key: "draw",
     value: function draw(options, pick) {
+      // console.log('options', this.drawParams)
       if (this.drawParams.attributes && Object.keys(this.drawParams.attributes).length === 0) {
         return;
       }
@@ -155,32 +140,41 @@ var ReglModel = function () {
       Object.keys(uniforms).forEach(function (uniformName) {
         var type = _typeof(uniforms[uniformName]);
 
-        if (type === 'boolean' || type === 'number' || Array.isArray(uniforms[uniformName]) || uniforms[uniformName].BYTES_PER_ELEMENT) {
+        if (type === 'boolean' || type === 'number' || Array.isArray(uniforms[uniformName]) || // @ts-ignore
+        uniforms[uniformName].BYTES_PER_ELEMENT) {
           reglDrawProps[uniformName] = uniforms[uniformName];
         } else {
           reglDrawProps[uniformName] = uniforms[uniformName].get();
         }
-      });
+      }); // TODO: 在进行拾取操作的绘制中，不应该使用叠加模式 - picking 根据拾取的颜色作为判断的输入，而叠加模式会产生新的，在 id 序列中不存在的颜色
 
       if (!pick) {
         this.drawCommand(reglDrawProps);
       } else {
         this.drawPickCommand(reglDrawProps);
-      }
+      } // this.drawCommand(reglDrawProps);
+      // this.drawPickCommand(reglDrawProps);
+
     }
   }, {
     key: "destroy",
     value: function destroy() {
+      // @ts-ignore
       this.drawParams.elements.destroy();
 
       if (this.options.attributes) {
         Object.values(this.options.attributes).forEach(function (attr) {
+          // @ts-ignore
           attr.destroy();
         });
       }
 
       this.destroyed = true;
     }
+    /**
+     * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#depth-buffer
+     */
+
   }, {
     key: "initDepthDrawParams",
     value: function initDepthDrawParams(_ref, drawParams) {
@@ -195,6 +189,10 @@ var ReglModel = function () {
         };
       }
     }
+    /**
+     * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#blending
+     */
+
   }, {
     key: "initBlendDrawParams",
     value: function initBlendDrawParams(_ref2, drawParams) {
@@ -205,7 +203,8 @@ var ReglModel = function () {
             func = blend.func,
             equation = blend.equation,
             _blend$color = blend.color,
-            color = _blend$color === void 0 ? [0, 0, 0, 0] : _blend$color;
+            color = _blend$color === void 0 ? [0, 0, 0, 0] : _blend$color; // @ts-ignore
+
         drawParams.blend = {
           enable: !!enable,
           func: {
@@ -222,6 +221,10 @@ var ReglModel = function () {
         };
       }
     }
+    /**
+     * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#stencil
+     */
+
   }, {
     key: "initStencilDrawParams",
     value: function initStencilDrawParams(_ref3, drawParams) {
@@ -268,6 +271,10 @@ var ReglModel = function () {
         };
       }
     }
+    /**
+     * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#culling
+     */
+
   }, {
     key: "initCullDrawParams",
     value: function initCullDrawParams(_ref4, drawParams) {
@@ -283,6 +290,12 @@ var ReglModel = function () {
         };
       }
     }
+    /**
+     * 考虑结构体命名, eg:
+     * a: { b: 1 }  ->  'a.b'
+     * a: [ { b: 1 } ] -> 'a[0].b'
+     */
+
   }, {
     key: "extractUniforms",
     value: function extractUniforms(uniforms) {
@@ -299,21 +312,30 @@ var ReglModel = function () {
     value: function extractUniformsRecursively(uniformName, uniformValue, uniforms, prefix) {
       var _this2 = this;
 
-      if (uniformValue === null || typeof uniformValue === 'number' || typeof uniformValue === 'boolean' || Array.isArray(uniformValue) && typeof uniformValue[0] === 'number' || _isTypedArray(uniformValue) || uniformValue === '' || 'resize' in uniformValue) {
+      if (uniformValue === null || typeof uniformValue === 'number' || // u_A: 1
+      typeof uniformValue === 'boolean' || // u_A: false
+      Array.isArray(uniformValue) && typeof uniformValue[0] === 'number' || // u_A: [1, 2, 3]
+      isTypedArray(uniformValue) || // u_A: Float32Array
+      // @ts-ignore
+      uniformValue === '' || 'resize' in uniformValue) {
         uniforms["".concat(prefix && prefix + '.').concat(uniformName)] = uniformValue;
         return;
-      }
+      } // u_Struct.a.b.c
 
-      if (_isPlainObject(uniformValue)) {
+
+      if (isPlainObject(uniformValue)) {
         Object.keys(uniformValue).forEach(function (childName) {
-          _this2.extractUniformsRecursively(childName, uniformValue[childName], uniforms, "".concat(prefix && prefix + '.').concat(uniformName));
+          _this2.extractUniformsRecursively(childName, // @ts-ignore
+          uniformValue[childName], uniforms, "".concat(prefix && prefix + '.').concat(uniformName));
         });
-      }
+      } // u_Struct[0].a
+
 
       if (Array.isArray(uniformValue)) {
         uniformValue.forEach(function (child, idx) {
           Object.keys(child).forEach(function (childName) {
-            _this2.extractUniformsRecursively(childName, child[childName], uniforms, "".concat(prefix && prefix + '.').concat(uniformName, "[").concat(idx, "]"));
+            _this2.extractUniformsRecursively(childName, // @ts-ignore
+            child[childName], uniforms, "".concat(prefix && prefix + '.').concat(uniformName, "[").concat(idx, "]"));
           });
         });
       }
@@ -323,5 +345,4 @@ var ReglModel = function () {
   return ReglModel;
 }();
 
-export { ReglModel as default };
-//# sourceMappingURL=ReglModel.js.map
+export { ReglModel as default };

package/es/regl/ReglRenderbuffer.js

@@ -1,14 +1,15 @@
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { formatMap } from './constants';
+import { formatMap } from "./constants";
+/**
+ * adaptor for regl.Renderbuffer
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#renderbuffers
+ */
 
-var ReglRenderbuffer = function () {
+var ReglRenderbuffer = /*#__PURE__*/function () {
   function ReglRenderbuffer(reGl, options) {
     _classCallCheck(this, ReglRenderbuffer);
 
-    _defineProperty(this, "renderbuffer", void 0);
-
     var width = options.width,
         height = options.height,
         format = options.format;
@@ -41,5 +42,4 @@ var ReglRenderbuffer = function () {
   return ReglRenderbuffer;
 }();
 
-export { ReglRenderbuffer as default };
-//# sourceMappingURL=ReglRenderbuffer.js.map
+export { ReglRenderbuffer as default };

package/es/regl/ReglTexture2D.js

@@ -2,18 +2,16 @@ import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { gl } from '@antv/l7-core';
-import { colorSpaceMap, dataTypeMap, filterMap, formatMap, mipmapMap, wrapModeMap } from './constants';
+import { colorSpaceMap, dataTypeMap, filterMap, formatMap, mipmapMap, wrapModeMap } from "./constants";
+/**
+ * adaptor for regl.Buffer
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md#buffers
+ */
 
-var ReglTexture2D = function () {
+var ReglTexture2D = /*#__PURE__*/function () {
   function ReglTexture2D(reGl, options) {
     _classCallCheck(this, ReglTexture2D);
 
-    _defineProperty(this, "texture", void 0);
-
-    _defineProperty(this, "width", void 0);
-
-    _defineProperty(this, "height", void 0);
-
     _defineProperty(this, "isDistroy", false);
 
     var data = options.data,
@@ -54,10 +52,12 @@ var ReglTexture2D = function () {
     var textureOptions = {
       width: width,
       height: height,
+      // @ts-ignore
       type: dataTypeMap[type],
       format: formatMap[format],
       wrapS: wrapModeMap[wrapS],
       wrapT: wrapModeMap[wrapT],
+      // @ts-ignore
       mag: filterMap[mag],
       min: filterMap[min],
       alignment: alignment,
@@ -65,12 +65,14 @@ var ReglTexture2D = function () {
       colorSpace: colorSpaceMap[colorSpace],
       premultiplyAlpha: premultiplyAlpha,
       aniso: aniso,
+      // copy pixels from current bind framebuffer
       x: x,
       y: y,
       copy: copy
     };
 
     if (data) {
+      // @ts-ignore
       textureOptions.data = data;
     }
 
@@ -97,6 +99,7 @@ var ReglTexture2D = function () {
   }, {
     key: "bind",
     value: function bind() {
+      // @ts-ignore
       this.texture._texture.bind();
     }
   }, {
@@ -124,5 +127,4 @@ var ReglTexture2D = function () {
   return ReglTexture2D;
 }();
 
-export { ReglTexture2D as default };
-//# sourceMappingURL=ReglTexture2D.js.map
+export { ReglTexture2D as default };

package/es/regl/constants.js

@@ -2,7 +2,11 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 
 var _primitiveMap, _usageMap, _dataTypeMap, _formatMap, _mipmapMap, _filterMap, _wrapModeMap, _colorSpaceMap, _depthFuncMap, _blendEquationMap, _blendFuncMap, _stencilFuncMap, _stencilOpMap, _cullFaceMap;
 
+/**
+ * @desc 由于 regl 使用大量字符串而非 WebGL 常量，因此需要映射
+ */
 import { gl } from '@antv/l7-core';
+// @see https://github.com/regl-project/regl/blob/gh-pages/lib/constants/primitives.json
 export var primitiveMap = (_primitiveMap = {}, _defineProperty(_primitiveMap, gl.POINTS, 'points'), _defineProperty(_primitiveMap, gl.LINES, 'lines'), _defineProperty(_primitiveMap, gl.LINE_LOOP, 'line loop'), _defineProperty(_primitiveMap, gl.LINE_STRIP, 'line strip'), _defineProperty(_primitiveMap, gl.TRIANGLES, 'triangles'), _defineProperty(_primitiveMap, gl.TRIANGLE_FAN, 'triangle fan'), _defineProperty(_primitiveMap, gl.TRIANGLE_STRIP, 'triangle strip'), _primitiveMap);
 export var usageMap = (_usageMap = {}, _defineProperty(_usageMap, gl.STATIC_DRAW, 'static'), _defineProperty(_usageMap, gl.DYNAMIC_DRAW, 'dynamic'), _defineProperty(_usageMap, gl.STREAM_DRAW, 'stream'), _usageMap);
 export var dataTypeMap = (_dataTypeMap = {}, _defineProperty(_dataTypeMap, gl.BYTE, 'int8'), _defineProperty(_dataTypeMap, gl.UNSIGNED_INT, 'int16'), _defineProperty(_dataTypeMap, gl.INT, 'int32'), _defineProperty(_dataTypeMap, gl.UNSIGNED_BYTE, 'uint8'), _defineProperty(_dataTypeMap, gl.UNSIGNED_SHORT, 'uint16'), _defineProperty(_dataTypeMap, gl.UNSIGNED_INT, 'uint32'), _defineProperty(_dataTypeMap, gl.FLOAT, 'float'), _dataTypeMap);
@@ -16,5 +20,4 @@ export var blendEquationMap = (_blendEquationMap = {}, _defineProperty(_blendEqu
 export var blendFuncMap = (_blendFuncMap = {}, _defineProperty(_blendFuncMap, gl.ZERO, 'zero'), _defineProperty(_blendFuncMap, gl.ONE, 'one'), _defineProperty(_blendFuncMap, gl.SRC_COLOR, 'src color'), _defineProperty(_blendFuncMap, gl.ONE_MINUS_SRC_COLOR, 'one minus src color'), _defineProperty(_blendFuncMap, gl.SRC_ALPHA, 'src alpha'), _defineProperty(_blendFuncMap, gl.ONE_MINUS_SRC_ALPHA, 'one minus src alpha'), _defineProperty(_blendFuncMap, gl.DST_COLOR, 'dst color'), _defineProperty(_blendFuncMap, gl.ONE_MINUS_DST_COLOR, 'one minus dst color'), _defineProperty(_blendFuncMap, gl.DST_ALPHA, 'dst alpha'), _defineProperty(_blendFuncMap, gl.ONE_MINUS_DST_ALPHA, 'one minus dst alpha'), _defineProperty(_blendFuncMap, gl.CONSTANT_COLOR, 'constant color'), _defineProperty(_blendFuncMap, gl.ONE_MINUS_CONSTANT_COLOR, 'one minus constant color'), _defineProperty(_blendFuncMap, gl.CONSTANT_ALPHA, 'constant alpha'), _defineProperty(_blendFuncMap, gl.ONE_MINUS_CONSTANT_ALPHA, 'one minus constant alpha'), _defineProperty(_blendFuncMap, gl.SRC_ALPHA_SATURATE, 'src alpha saturate'), _blendFuncMap);
 export var stencilFuncMap = (_stencilFuncMap = {}, _defineProperty(_stencilFuncMap, gl.NEVER, 'never'), _defineProperty(_stencilFuncMap, gl.ALWAYS, 'always'), _defineProperty(_stencilFuncMap, gl.LESS, 'less'), _defineProperty(_stencilFuncMap, gl.LEQUAL, 'lequal'), _defineProperty(_stencilFuncMap, gl.GREATER, 'greater'), _defineProperty(_stencilFuncMap, gl.GEQUAL, 'gequal'), _defineProperty(_stencilFuncMap, gl.EQUAL, 'equal'), _defineProperty(_stencilFuncMap, gl.NOTEQUAL, 'notequal'), _stencilFuncMap);
 export var stencilOpMap = (_stencilOpMap = {}, _defineProperty(_stencilOpMap, gl.ZERO, 'zero'), _defineProperty(_stencilOpMap, gl.KEEP, 'keep'), _defineProperty(_stencilOpMap, gl.REPLACE, 'replace'), _defineProperty(_stencilOpMap, gl.INVERT, 'invert'), _defineProperty(_stencilOpMap, gl.INCR, 'increment'), _defineProperty(_stencilOpMap, gl.DECR, 'decrement'), _defineProperty(_stencilOpMap, gl.INCR_WRAP, 'increment wrap'), _defineProperty(_stencilOpMap, gl.DECR_WRAP, 'decrement wrap'), _stencilOpMap);
-export var cullFaceMap = (_cullFaceMap = {}, _defineProperty(_cullFaceMap, gl.FRONT, 'front'), _defineProperty(_cullFaceMap, gl.BACK, 'back'), _cullFaceMap);
-//# sourceMappingURL=constants.js.map
+export var cullFaceMap = (_cullFaceMap = {}, _defineProperty(_cullFaceMap, gl.FRONT, 'front'), _defineProperty(_cullFaceMap, gl.BACK, 'back'), _cullFaceMap);

package/es/regl/index.js

@@ -6,36 +6,31 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 var _dec, _class;
 
 import _regeneratorRuntime from "@babel/runtime/regenerator";
+
+/**
+ * render w/ regl
+ * @see https://github.com/regl-project/regl/blob/gh-pages/API.md
+ */
 import { isMini } from '@antv/l7-utils';
 import { injectable } from 'inversify';
 import regl from 'l7regl';
 import 'reflect-metadata';
-import ReglAttribute from './ReglAttribute';
-import ReglBuffer from './ReglBuffer';
-import ReglElements from './ReglElements';
-import ReglFramebuffer from './ReglFramebuffer';
-import ReglModel from './ReglModel';
-import ReglTexture2D from './ReglTexture2D';
-var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
+import ReglAttribute from "./ReglAttribute";
+import ReglBuffer from "./ReglBuffer";
+import ReglElements from "./ReglElements";
+import ReglFramebuffer from "./ReglFramebuffer";
+import ReglModel from "./ReglModel";
+import ReglTexture2D from "./ReglTexture2D";
+/**
+ * regl renderer
+ */
+
+var ReglRendererService = (_dec = injectable(), _dec(_class = /*#__PURE__*/function () {
   function ReglRendererService() {
     var _this = this;
 
     _classCallCheck(this, ReglRendererService);
 
-    _defineProperty(this, "extensionObject", void 0);
-
-    _defineProperty(this, "gl", void 0);
-
-    _defineProperty(this, "$container", void 0);
-
-    _defineProperty(this, "canvas", void 0);
-
-    _defineProperty(this, "width", void 0);
-
-    _defineProperty(this, "height", void 0);
-
-    _defineProperty(this, "isDirty", void 0);
-
     _defineProperty(this, "createModel", function (options) {
       return new ReglModel(_this.gl, options);
     });
@@ -69,6 +64,7 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
     _defineProperty(this, "clear", function (options) {
       var _this$gl;
 
+      // @see https://github.com/regl-project/regl/blob/gh-pages/API.md#clear-the-draw-buffer
       var color = options.color,
           depth = options.depth,
           stencil = options.stencil,
@@ -89,6 +85,8 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
           width = _ref.width,
           height = _ref.height;
 
+      // use WebGL context directly
+      // @see https://github.com/regl-project/regl/blob/gh-pages/API.md#unsafe-escape-hatch
       _this.gl._gl.viewport(x, y, width, height);
 
       _this.width = width;
@@ -135,6 +133,7 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
     });
 
     _defineProperty(this, "getCanvas", function () {
+      // return this.$container?.getElementsByTagName('canvas')[0] || null;
       return _this.canvas;
     });
 
@@ -145,10 +144,14 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
     _defineProperty(this, "destroy", function () {
       var _this$gl2, _this$gl2$_gl, _this$gl2$_gl$getExte;
 
-      _this.canvas = null;
-      (_this$gl2 = _this.gl) === null || _this$gl2 === void 0 ? void 0 : (_this$gl2$_gl = _this$gl2._gl) === null || _this$gl2$_gl === void 0 ? void 0 : (_this$gl2$_gl$getExte = _this$gl2$_gl.getExtension('WEBGL_lose_context')) === null || _this$gl2$_gl$getExte === void 0 ? void 0 : _this$gl2$_gl$getExte.loseContext();
+      // this.canvas = null 清除对 webgl 实例的引用
+      // @ts-ignore
+      _this.canvas = null; // make sure release webgl context
+
+      (_this$gl2 = _this.gl) === null || _this$gl2 === void 0 ? void 0 : (_this$gl2$_gl = _this$gl2._gl) === null || _this$gl2$_gl === void 0 ? void 0 : (_this$gl2$_gl$getExte = _this$gl2$_gl.getExtension('WEBGL_lose_context')) === null || _this$gl2$_gl$getExte === void 0 ? void 0 : _this$gl2$_gl$getExte.loseContext(); // @see https://github.com/regl-project/regl/blob/gh-pages/API.md#clean-up
+
+      _this.gl.destroy(); // @ts-ignore
 
-      _this.gl.destroy();
 
       _this.gl = null;
     });
@@ -157,32 +160,40 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
   _createClass(ReglRendererService, [{
     key: "init",
     value: function () {
-      var _init = _asyncToGenerator(_regeneratorRuntime.mark(function _callee(canvas, cfg) {
+      var _init = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(canvas, cfg) {
         var _this2 = this;
 
         return _regeneratorRuntime.wrap(function _callee$(_context) {
           while (1) {
             switch (_context.prev = _context.next) {
               case 0:
-                this.canvas = canvas;
+                // this.$container = $container;
+                this.canvas = canvas; // tslint:disable-next-line:typedef
+
                 _context.next = 3;
                 return new Promise(function (resolve, reject) {
                   regl({
                     canvas: _this2.canvas,
                     attributes: {
                       alpha: true,
+                      // use TAA instead of MSAA
+                      // @see https://www.khronos.org/registry/webgl/specs/1.0/#5.2.1
                       antialias: cfg.antialias,
                       premultipliedAlpha: true,
                       preserveDrawingBuffer: cfg.preserveDrawingBuffer,
                       stencil: cfg.stencil
                     },
-                    extensions: ['OES_element_index_uint', 'OES_standard_derivatives', 'ANGLE_instanced_arrays'],
+                    // TODO: use extensions
+                    extensions: ['OES_element_index_uint', 'OES_standard_derivatives', // wireframe
+                    'ANGLE_instanced_arrays' // VSM shadow map
+                    ],
                     optionalExtensions: ['oes_texture_float_linear', 'OES_texture_float', 'EXT_texture_filter_anisotropic', 'EXT_blend_minmax', 'WEBGL_depth_texture'],
                     profile: true,
                     onDone: function onDone(err, r) {
                       if (err || !r) {
                         reject(err);
-                      }
+                      } // @ts-ignore
+
 
                       resolve(r);
                     }
@@ -217,11 +228,13 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
   }, {
     key: "testExtension",
     value: function testExtension(name) {
+      // OES_texture_float
       return !!this.getGLContext().getExtension(name);
     }
   }, {
     key: "setState",
-    value: function setState() {
+    value: // TODO: 临时方法
+    function setState() {
       this.gl({
         cull: {
           enable: false,
@@ -285,5 +298,4 @@ var ReglRendererService = (_dec = injectable(), _dec(_class = function () {
 
   return ReglRendererService;
 }()) || _class);
-export { ReglRendererService as default };
-//# sourceMappingURL=index.js.map
+export { ReglRendererService as default };