vislite 1.5.0-alpha.0 → 1.5.0

package/AUTHORS.txt

@@ -1,6 +1,6 @@
-Authors ordered by first contribution.
-
-zxl20070701 <1904314465@qq.com> <https://github.com/zxl20070701>
-
------------------------------------------------------
-We thank all of them for their contributions!
+Authors ordered by first contribution.
+
+zxl20070701 <1904314465@qq.com> <https://github.com/zxl20070701>
+
+-----------------------------------------------------
+We thank all of them for their contributions!

package/CHANGELOG

@@ -1,313 +1,317 @@
-v0.1.0:
-    date:2023-04-29
-    changes:
-      - 初始化版本
-        1、Canvas
-          （支持平台：H5、uni-app（包括：H5、微信小程序、支付宝小程序）、微信小程序）
-        2、SVG画笔
-          （支持平台：H5）
-        3、Eoap 等角斜方位投影
-        4、rotate 旋转
-        5、Matrix4 变换矩阵
-        6、插值函数
-          （包括：Hermite、Cardinal）
-        7、getLoopColors 循环色彩
-        8、animation 动画
-        9、ruler 刻度尺
-v0.1.1:
-    date:2023-05-07
-    changes:
-      - 修复bug
-        1、解决uni-app和微信小程序组件ui-canvas未绑定事件点击报错问题
-v0.2.0:
-    date:2023-06-03
-    changes:
-      - 修复bug
-        1、为解决this问题，同时优化参数内容，修改了uni-app和微信小程序组件ui-canvas事件语法
-          （对旧语法进行了向下兼容）
-        2、校对types中定义的类型信息
-        3、修复uni-app组件ui-canvas在支付宝小程序区域计算相关错误
-      - 优化改造
-        1、针对Canvas和SVG的画笔配置config的属性名，统一使用小驼峰
-          （对旧语法进行了向下兼容）
-      - 新增功能
-        1、WebGL画笔
-          （支持平台：H5）
-        2、Mercator 墨卡托投影
-        3、Canvas新增功能
-            * 多行文字:fillTexts、strokeTexts、fullTexts
-            * 获取原始画笔:getContext
-        4、uni-app平台的ui-canvas新增cover属性配置，支持非原生渲染模式
-        5、控制信息捕获 viewHandler
-          （支持平台：H5）
-v0.3.0:
-    date:2023-07-01
-    changes:
-      - 修复bug
-        1、Canvas画笔
-            * 在部分安卓手机上可能绘制失败问题
-        2、SVG画笔
-            * 部分情况下文字大小设置失败问题
-            * 配置失效问题
-            * 圆弧系列（fillArc、strokeArc、fullArc）和路径arc角度未正确使用角度值问题
-        3、WebGL画笔
-            * render方法中itemSize设置无效问题
-        4、修复Cardinal插值超过界限的值问题
-      - 新增功能
-        1、Canvas画笔
-            * createLinearGradient 线性渐变色
-            * createRadialGradient 环形渐变色
-            * clip 裁剪
-            * 绘制圆弧系列（fillArc、strokeArc、fullArc）的闭合方式添加```-round```选项
-            * getColor 获取指定位置颜色
-        2、SVG画笔
-            * 绘制圆弧系列（fillArc、strokeArc、fullArc）的闭合方式添加```-round```选项
-        3、WebGL画笔
-            * 材料material新增多颜色值colors
-        4、朴素的WebGL接口集合
-            * getWebGLContext 画笔
-            * Shader 着色器
-            * Buffer 缓冲区
-            * Texture 纹理
-v0.3.1:
-    date:2023-07-08
-    changes:
-      - 修复bug
-        1、Canvas画笔
-            * 优化区域计算有时候出错问题
-v0.4.0:
-    date:2023-07-22
-    changes:
-      - 新增功能
-        1、Canvas画笔
-            * textWidth 计算文字宽
-v0.4.1:
-    date:2023-09-03
-    changes:
-      - 修复bug
-        1、uni-app平台的ui-canvas在微信小程序环境下有时会绘制失败并渲染过慢问题
-        2、Canvas画笔
-            * 多行文字（fillTexts、strokeTexts、fullTexts）在处理有换行文字时的未正确处理
-        3、SVG画笔
-            * 部分默认值失效
-      - 优化改造
-        1、优化WebGL区域计算设计
-        2、丰富types并暴露更多有用的类型对象
-      - 新增功能
-        1、Canvas画笔
-            * 添加region配置，可以控制是否支持区域管理
-            * onlyRegion 区域模式
-        2、WebGL画笔
-            * 添加region配置，可以控制是否支持区域管理
-        3、uni-app平台的ui-canvas
-            * 画笔的draw方法对外暴露更丰富的参数
-            * 添加region属性，可以控制是否支持区域管理
-        4、微信小程序平台的ui-canvas
-            * 添加region属性，可以控制是否支持区域管理
-        5、viewHandler新增对悬浮hover事件的捕获并统一添加event参数
-        6、刻度尺算法ruler新增可选上下界约束
-        7、颜色格式化 formatColor
-          （支持平台：H5）
-        8、节点缩放监听 resizeObserver
-          （支持平台：H5）
-        9、节流函数 throttle
-        10、布局
-            * 树布局 treeLayout
-        11、着色器compile方法丰富参数（添加color、colors、image、cube四种内置着色器程序）
-v0.5.0:
-    date:2023-10-01
-    changes:
-      - 修复bug
-        1、SVG画笔
-            * 修改文字默认值错误（50恢复成16）
-      - 优化改造
-        1、一些types定义优化（比如 Array<number> 改成更具体的 [number, number] 类型）
-      - 新增功能
-        1、Geometry 立方体
-            * cylinder 圆柱体
-            * prism 棱柱体
-            * sphere 球体
-        2、SVG画笔
-            * bind 绑定事件
-        3、布局的bind和use方法新增第二个可选参数noOpens，用于控制结点默认是否闭合
-v0.5.2:
-    date:2023-11-04
-    changes:
-      - 修复bug
-        1、修复ui-canvas在支付宝小程序模拟器中的错误
-      - 新增功能
-        1、move 移动
-        2、scale 缩放
-        3、SVG画笔
-            * createLinearGradient 线性渐变色
-            * createRadialGradient 环形渐变色
-v0.6.0:
-    date:2023-12-17
-    changes:
-      - 修复bug
-        1、修复ruler值出现浮点“不精确”问题
-      - 优化改造
-        1、uni-app平台的ui-canvas明确为inline-block盒子
-        2、开发环境添加了eslint
-      - 新增功能
-        1、Canvas画笔
-            * getInfo 获取画布信息
-            * H5环境下创建的时候添加willReadFrequently配置
-        2、Matrix4 变换矩阵
-            * setValue 设置内置矩阵
-v0.7.0:
-    date:2024-01-14
-    changes:
-      - 修复bug
-        1、修复ui-canvas在HBuilderX中使用“发行”打包成H5后css代码未生效问题
-          （这应该是HBuilderX自身的BUG，但为了快速修复，内部消化）
-      - 优化改造
-        1、一些types定义优化
-            * 针对svg新增：svgElType、svgBoardType
-        2、Geometry 立方体运算
-            * 针对 “prism 棱柱体” 和 “cylinder 圆柱体” 新增直接设置起终点方式
-            * 给拼接成立方体的每个小片定义一个名称
-        3、开启严格模式并进行相关代码调整
-          （使得更多问题提前暴露出来，提高代码质量）
-v0.7.1:
-    date:2024-01-20
-    changes:
-      - 修复bug
-        1、修复types中类型定义错误
-            * Object3D.d.ts中LINE_STRIP被误写成INE_STRIP
-      - 优化改造
-        1、提高Canvas绘图清晰度
-            * 普通H5端
-            * uni-app端（支付宝小程序）
-v0.8.0:
-    date:2024-03-02
-    changes:
-      - 修复bug
-        1、修复“prism 棱柱体” 和 “cylinder 圆柱体”特殊情况下计算错误
-            * 未考虑方向无需调整时分母为零
-            * 未考虑计算的高需要判断正负性
-        2、修复同一个Canvas多次获取画笔会获取错误问题
-      - 优化改造
-        1、针对单独引入的方式添加types支持
-        2、一些types定义优化
-            * 针对ui-canvas补充标签ref类型
-      - 新增功能
-        1、Canvas画笔
-            * drawImage 绘制图片
-        2、WebGL画笔
-            * 画布缩放模式（mode）
-        3、Geometry 辅助方法
-            * splitNum 计算切割份数
-            * rotateLine 物体方向转换
-        4、Geometry 立方片段
-            * prismHorizontal 棱柱水平部分
-            * prismVertical 棱柱垂直部分
-            * sphereFragment 球体中的一瓣子
-        5、Geometry 立方体
-            * pie 饼柱体
-v1.0.0:
-    date:2024-05-25
-    changes:
-      - 基于更长远的考虑，部分反馈不好的API决定从v1.x开始废弃，后续专注基础技术积累，废弃业务模块，敬请理解
-        （原v0.x的功能将独立一个分支继续维护：https://github.com/oi-contrib/VISLite/blob/v0.x/CHANGELOG）
-      - 被废弃API或功能
-        1、Geometry 立方体
-        2、WebGL画笔
-        3、取消一些旧的向下兼容语句
-            * 微信小程序组件ui-canvas作为属性传递事件方式
-            * Canvas和SVG画笔配置属性key非驼峰方式
-        4、节点信息捕获 viewHandler
-        5、颜色格式化 formatColor
-        6、节点缩放监听 resizeObserver
-      - 修复bug
-        1、微信小程序ui-canvas
-            * 不支持绘制图片问题
-            * toDataURL不兼容新版本
-        2、Canvas画笔
-            * 修复drawImage后续内容被覆盖问题
-      - 优化改造
-        1、针对types文件丰富必要的注释
-        2、微信小程序和uni-app组件ui-canvas使用主包canvas以减低最终包体积
-        3、Canvas画笔
-            * draw方法兼容非uniapp环境
-            * 修复drawImage未正确绘制全图
-      - 新增功能
-        1、Canvas画笔
-            * H5环境下创建画笔对象的时候添加传递画布尺寸功能
-            * onlyView 绘制模式
-v1.1.0:
-    date:2024-06-08
-    changes:
-      - 新增功能
-        1、添加对uni-app（Vue3版本）的支持
-v1.2.0:
-    date:2024-09-01
-    changes:
-      - 修复bug
-        1、修复uni-app平台的ui-canvas组件在ts环境中引入报错问题
-        2、修复微信小程序版本的ui-canvas的region默认值设置错误问题
-        3、SVG 画笔
-            * 修复lineWidth不生效问题
-        4、Canvas画笔
-            * 修复drawImage在非H5端源图片尺寸错误问题
-      - 优化改造
-        1、getLoopColors 可修改基础色
-      - 新增功能
-        1、Canvas画笔
-            * H5环境下添加bind绑定事件方法
-            * createConicGradient 角度渐变色
-            * 配置config添加可配置项
-              > lineCap 线的端点类型
-              > lineJoin 线的拐角连接方式
-            * 支付宝小程序版本的ui-canvas
-            * 重置 reset
-        2、SVG 画笔
-            * 配置config添加可配置项
-              > lineCap 线的端点类型
-              > lineJoin 线的拐角连接方式
-            * 重置 reset
-        3、assemble 步进生成器
-        4、option 配置项
-            * initOption 初始化
-            * mergeOption 合并
-v1.2.1:
-    date:2024-09-21
-    changes:
-      - 修复bug
-        1、修复未定义RawCanvas类型问题
-      - 新增功能
-        1、树布局 treeLayout
-            * 新增doUpdate方法
-            * 新增deg文字建议旋转弧度
-v1.3.0:
-    date:2025-01-04
-    changes:
-      - 修复bug
-        1、SVG 画笔
-            * 修复图形stroke模式的lineWidth、lineDash、lineCap、lineJoin不生效问题
-        2、从types中移除被废弃的画笔属性
-      - 新增功能
-        1、Canvas画笔
-            * 配置config添加可配置项
-              > rectRadius 矩形圆角半径
-            * clearCircle 圆形橡皮擦
-        2、SVG画笔
-            * 配置config添加可配置项
-              > rectRadius 矩形圆角半径
-        3、坐标系
-            * 地理坐标系 mapCoordinate
-v1.4.0:
-    date:2025-05-18
-    changes:
-      - 新增功能
-        1、SVG画笔
-            * toDataURL 获取画布的base64地址
-        2、布局
-            * 饼布局 pieLayout
-            * 直方布局 barLayout
-v1.5.0:
-    date:
-    changes:
-      - 新增功能
-        1、Canvas画笔
+v0.1.0:
+    date:2023-04-29
+    changes:
+      - 初始化版本
+        1、Canvas
+          （支持平台：H5、uni-app（包括：H5、微信小程序、支付宝小程序）、微信小程序）
+        2、SVG画笔
+          （支持平台：H5）
+        3、Eoap 等角斜方位投影
+        4、rotate 旋转
+        5、Matrix4 变换矩阵
+        6、插值函数
+          （包括：Hermite、Cardinal）
+        7、getLoopColors 循环色彩
+        8、animation 动画
+        9、ruler 刻度尺
+v0.1.1:
+    date:2023-05-07
+    changes:
+      - 修复bug
+        1、解决uni-app和微信小程序组件ui-canvas未绑定事件点击报错问题
+v0.2.0:
+    date:2023-06-03
+    changes:
+      - 修复bug
+        1、为解决this问题，同时优化参数内容，修改了uni-app和微信小程序组件ui-canvas事件语法
+          （对旧语法进行了向下兼容）
+        2、校对types中定义的类型信息
+        3、修复uni-app组件ui-canvas在支付宝小程序区域计算相关错误
+      - 优化改造
+        1、针对Canvas和SVG的画笔配置config的属性名，统一使用小驼峰
+          （对旧语法进行了向下兼容）
+      - 新增功能
+        1、WebGL画笔
+          （支持平台：H5）
+        2、Mercator 墨卡托投影
+        3、Canvas新增功能
+            * 多行文字:fillTexts、strokeTexts、fullTexts
+            * 获取原始画笔:getContext
+        4、uni-app平台的ui-canvas新增cover属性配置，支持非原生渲染模式
+        5、控制信息捕获 viewHandler
+          （支持平台：H5）
+v0.3.0:
+    date:2023-07-01
+    changes:
+      - 修复bug
+        1、Canvas画笔
+            * 在部分安卓手机上可能绘制失败问题
+        2、SVG画笔
+            * 部分情况下文字大小设置失败问题
+            * 配置失效问题
+            * 圆弧系列（fillArc、strokeArc、fullArc）和路径arc角度未正确使用角度值问题
+        3、WebGL画笔
+            * render方法中itemSize设置无效问题
+        4、修复Cardinal插值超过界限的值问题
+      - 新增功能
+        1、Canvas画笔
+            * createLinearGradient 线性渐变色
+            * createRadialGradient 环形渐变色
+            * clip 裁剪
+            * 绘制圆弧系列（fillArc、strokeArc、fullArc）的闭合方式添加```-round```选项
+            * getColor 获取指定位置颜色
+        2、SVG画笔
+            * 绘制圆弧系列（fillArc、strokeArc、fullArc）的闭合方式添加```-round```选项
+        3、WebGL画笔
+            * 材料material新增多颜色值colors
+        4、朴素的WebGL接口集合
+            * getWebGLContext 画笔
+            * Shader 着色器
+            * Buffer 缓冲区
+            * Texture 纹理
+v0.3.1:
+    date:2023-07-08
+    changes:
+      - 修复bug
+        1、Canvas画笔
+            * 优化区域计算有时候出错问题
+v0.4.0:
+    date:2023-07-22
+    changes:
+      - 新增功能
+        1、Canvas画笔
+            * textWidth 计算文字宽
+v0.4.1:
+    date:2023-09-03
+    changes:
+      - 修复bug
+        1、uni-app平台的ui-canvas在微信小程序环境下有时会绘制失败并渲染过慢问题
+        2、Canvas画笔
+            * 多行文字（fillTexts、strokeTexts、fullTexts）在处理有换行文字时的未正确处理
+        3、SVG画笔
+            * 部分默认值失效
+      - 优化改造
+        1、优化WebGL区域计算设计
+        2、丰富types并暴露更多有用的类型对象
+      - 新增功能
+        1、Canvas画笔
+            * 添加region配置，可以控制是否支持区域管理
+            * onlyRegion 区域模式
+        2、WebGL画笔
+            * 添加region配置，可以控制是否支持区域管理
+        3、uni-app平台的ui-canvas
+            * 画笔的draw方法对外暴露更丰富的参数
+            * 添加region属性，可以控制是否支持区域管理
+        4、微信小程序平台的ui-canvas
+            * 添加region属性，可以控制是否支持区域管理
+        5、viewHandler新增对悬浮hover事件的捕获并统一添加event参数
+        6、刻度尺算法ruler新增可选上下界约束
+        7、颜色格式化 formatColor
+          （支持平台：H5）
+        8、节点缩放监听 resizeObserver
+          （支持平台：H5）
+        9、节流函数 throttle
+        10、布局
+            * 树布局 treeLayout
+        11、着色器compile方法丰富参数（添加color、colors、image、cube四种内置着色器程序）
+v0.5.0:
+    date:2023-10-01
+    changes:
+      - 修复bug
+        1、SVG画笔
+            * 修改文字默认值错误（50恢复成16）
+      - 优化改造
+        1、一些types定义优化（比如 Array<number> 改成更具体的 [number, number] 类型）
+      - 新增功能
+        1、Geometry 立方体
+            * cylinder 圆柱体
+            * prism 棱柱体
+            * sphere 球体
+        2、SVG画笔
+            * bind 绑定事件
+        3、布局的bind和use方法新增第二个可选参数noOpens，用于控制结点默认是否闭合
+v0.5.2:
+    date:2023-11-04
+    changes:
+      - 修复bug
+        1、修复ui-canvas在支付宝小程序模拟器中的错误
+      - 新增功能
+        1、move 移动
+        2、scale 缩放
+        3、SVG画笔
+            * createLinearGradient 线性渐变色
+            * createRadialGradient 环形渐变色
+v0.6.0:
+    date:2023-12-17
+    changes:
+      - 修复bug
+        1、修复ruler值出现浮点“不精确”问题
+      - 优化改造
+        1、uni-app平台的ui-canvas明确为inline-block盒子
+        2、开发环境添加了eslint
+      - 新增功能
+        1、Canvas画笔
+            * getInfo 获取画布信息
+            * H5环境下创建的时候添加willReadFrequently配置
+        2、Matrix4 变换矩阵
+            * setValue 设置内置矩阵
+v0.7.0:
+    date:2024-01-14
+    changes:
+      - 修复bug
+        1、修复ui-canvas在HBuilderX中使用“发行”打包成H5后css代码未生效问题
+          （这应该是HBuilderX自身的BUG，但为了快速修复，内部消化）
+      - 优化改造
+        1、一些types定义优化
+            * 针对svg新增：svgElType、svgBoardType
+        2、Geometry 立方体运算
+            * 针对 “prism 棱柱体” 和 “cylinder 圆柱体” 新增直接设置起终点方式
+            * 给拼接成立方体的每个小片定义一个名称
+        3、开启严格模式并进行相关代码调整
+          （使得更多问题提前暴露出来，提高代码质量）
+v0.7.1:
+    date:2024-01-20
+    changes:
+      - 修复bug
+        1、修复types中类型定义错误
+            * Object3D.d.ts中LINE_STRIP被误写成INE_STRIP
+      - 优化改造
+        1、提高Canvas绘图清晰度
+            * 普通H5端
+            * uni-app端（支付宝小程序）
+v0.8.0:
+    date:2024-03-02
+    changes:
+      - 修复bug
+        1、修复“prism 棱柱体” 和 “cylinder 圆柱体”特殊情况下计算错误
+            * 未考虑方向无需调整时分母为零
+            * 未考虑计算的高需要判断正负性
+        2、修复同一个Canvas多次获取画笔会获取错误问题
+      - 优化改造
+        1、针对单独引入的方式添加types支持
+        2、一些types定义优化
+            * 针对ui-canvas补充标签ref类型
+      - 新增功能
+        1、Canvas画笔
+            * drawImage 绘制图片
+        2、WebGL画笔
+            * 画布缩放模式（mode）
+        3、Geometry 辅助方法
+            * splitNum 计算切割份数
+            * rotateLine 物体方向转换
+        4、Geometry 立方片段
+            * prismHorizontal 棱柱水平部分
+            * prismVertical 棱柱垂直部分
+            * sphereFragment 球体中的一瓣子
+        5、Geometry 立方体
+            * pie 饼柱体
+v1.0.0:
+    date:2024-05-25
+    changes:
+      - 基于更长远的考虑，部分反馈不好的API决定从v1.x开始废弃，后续专注基础技术积累，废弃业务模块，敬请理解
+        （原v0.x的功能将独立一个分支继续维护：https://github.com/oi-contrib/VISLite/blob/v0.x/CHANGELOG）
+      - 被废弃API或功能
+        1、Geometry 立方体
+        2、WebGL画笔
+        3、取消一些旧的向下兼容语句
+            * 微信小程序组件ui-canvas作为属性传递事件方式
+            * Canvas和SVG画笔配置属性key非驼峰方式
+        4、节点信息捕获 viewHandler
+        5、颜色格式化 formatColor
+        6、节点缩放监听 resizeObserver
+      - 修复bug
+        1、微信小程序ui-canvas
+            * 不支持绘制图片问题
+            * toDataURL不兼容新版本
+        2、Canvas画笔
+            * 修复drawImage后续内容被覆盖问题
+      - 优化改造
+        1、针对types文件丰富必要的注释
+        2、微信小程序和uni-app组件ui-canvas使用主包canvas以减低最终包体积
+        3、Canvas画笔
+            * draw方法兼容非uniapp环境
+            * 修复drawImage未正确绘制全图
+      - 新增功能
+        1、Canvas画笔
+            * H5环境下创建画笔对象的时候添加传递画布尺寸功能
+            * onlyView 绘制模式
+v1.1.0:
+    date:2024-06-08
+    changes:
+      - 新增功能
+        1、添加对uni-app（Vue3版本）的支持
+v1.2.0:
+    date:2024-09-01
+    changes:
+      - 修复bug
+        1、修复uni-app平台的ui-canvas组件在ts环境中引入报错问题
+        2、修复微信小程序版本的ui-canvas的region默认值设置错误问题
+        3、SVG 画笔
+            * 修复lineWidth不生效问题
+        4、Canvas画笔
+            * 修复drawImage在非H5端源图片尺寸错误问题
+      - 优化改造
+        1、getLoopColors 可修改基础色
+      - 新增功能
+        1、Canvas画笔
+            * H5环境下添加bind绑定事件方法
+            * createConicGradient 角度渐变色
+            * 配置config添加可配置项
+              > lineCap 线的端点类型
+              > lineJoin 线的拐角连接方式
+            * 支付宝小程序版本的ui-canvas
+            * 重置 reset
+        2、SVG 画笔
+            * 配置config添加可配置项
+              > lineCap 线的端点类型
+              > lineJoin 线的拐角连接方式
+            * 重置 reset
+        3、assemble 步进生成器
+        4、option 配置项
+            * initOption 初始化
+            * mergeOption 合并
+v1.2.1:
+    date:2024-09-21
+    changes:
+      - 修复bug
+        1、修复未定义RawCanvas类型问题
+      - 新增功能
+        1、树布局 treeLayout
+            * 新增doUpdate方法
+            * 新增deg文字建议旋转弧度
+v1.3.0:
+    date:2025-01-04
+    changes:
+      - 修复bug
+        1、SVG 画笔
+            * 修复图形stroke模式的lineWidth、lineDash、lineCap、lineJoin不生效问题
+        2、从types中移除被废弃的画笔属性
+      - 新增功能
+        1、Canvas画笔
+            * 配置config添加可配置项
+              > rectRadius 矩形圆角半径
+            * clearCircle 圆形橡皮擦
+        2、SVG画笔
+            * 配置config添加可配置项
+              > rectRadius 矩形圆角半径
+        3、坐标系
+            * 地理坐标系 mapCoordinate
+v1.4.0:
+    date:2025-05-18
+    changes:
+      - 新增功能
+        1、SVG画笔
+            * toDataURL 获取画布的base64地址
+        2、布局
+            * 饼布局 pieLayout
+            * 直方布局 barLayout
+v1.5.0:
+    date:2025-09-15
+    changes:
+      - 修复bug
+        1、修复ui-canvas（uniapp版）方法toDataURL在部分端未正确解析成base64返回
+          （包括：微信小程序）
+        2、修复ui-canvas（微信小程序版）方法toDataURL未正确解析成base64返回
+      - 新增功能
+        1、Canvas画笔
             * 添加scale配置，可以控制画布缩放倍率