@shijiu/jsview-vue 2.1.200 → 2.1.340-test.0

package/utils/JsViewVueTools/JsvRuntimeBridge.js

@@ -25,7 +25,7 @@ function direct_call(name, ...args) {
     return null;
 }
 
-/**
+/*!
  * 获取当前集成JsView的APP目前支持的扩展功能列表
  *
  * @returns {string} 功能列表，以逗号隔开，包含:
@@ -40,7 +40,7 @@ function getExtFeatureSupports() {
     return feature_supports;
 }
 
-/**
+/*!
  * 获取设备mac地址，优先获取有线mac，无则获取wifi mac
  * @returns {string} mac address
  *
@@ -49,7 +49,7 @@ function getMac(){
     return direct_call("getMac");
 }
 
-/**
+/*!
  * 获取设备有线mac地址
  * @returns {string} mac address
  *
@@ -58,7 +58,7 @@ function getWireMac(){
     return direct_call("getWireMac");
 }
 
-/**
+/*!
  * 获取设备wifi mac地址
  * @returns {string} mac address
  *
@@ -67,7 +67,7 @@ function getWifiMac(){
     return direct_call("getWifiMac");
 }
 
-/**
+/*!
  * 获取设备UUID
  * @returns {string} UUID
  *
@@ -76,7 +76,7 @@ function getDeviceUUID(){
     return direct_call("getDeviceUUID");
 }
 
-/**
+/*!
  * 获取设备Android ID
  * @returns {string} Android ID
  *
@@ -85,7 +85,7 @@ function getAndroidId(){
     return direct_call("getAndroidId");
 }
 
-/**
+/*!
  * 打开另外一个小程序
  * @param {string} url 小程序url
  * @param {string} startup_image 启动图url
@@ -109,7 +109,7 @@ function openWindow(url, startup_image, startup_video, startup_duration, add_his
     direct_call("openWindow", url, JSON.stringify(setting));
 }
 
-/**
+/*!
  * 关闭当前小程序
  *
  */
@@ -117,7 +117,7 @@ function closePage(){
     direct_call("closePage");
 }
 
-/**
+/*!
  * 获取设备UUID
  * @param {string} key 属性名称
  * @returns {string} 属性值
@@ -127,7 +127,7 @@ function getSystemProperty(key){
     return direct_call("getSystemProperty", key);
 }
 
-/**
+/*!
  * 获取已安装应用列表
  * @returns {string} 应用列表，JSON结构的数组
  *
@@ -136,7 +136,7 @@ function getInstalledApps(){
     return direct_call("getInstalledApps");
 }
 
-/**
+/*!
  * 启动安卓APP
  * @param {string} package_name 包名
  * @param {string} activity Activity方式启动
@@ -192,7 +192,7 @@ function sendNativeBroadcast(package_name, broadcast, action, uri, flags, param)
     direct_call("sendNativeBroadcast", JSON.stringify(obj));
 }
 
-/**
+/*!
  * 获取设备信息
  * @returns {string} 终端设备信息，JSON数据结构
  *
@@ -201,7 +201,7 @@ function getDeviceInfo() {
     return direct_call("getDeviceInfo");
 }
 
-/**
+/*!
  * 获取自己的app信息
  * @returns 
  */
@@ -209,7 +209,7 @@ function getAppInfo(){
     return direct_call("getAppInfo");
 }
 
-/**
+/*!
  * 页面加载成功后调用去除启动图
  *
  */
@@ -224,7 +224,7 @@ function notifyPageLoaded() {
     direct_call("notifyPageLoaded");
 }
 
-/**
+/*!
  * 是否支持收藏功能
  * @returns {boolean} true支持，false不支持
  *
@@ -237,7 +237,7 @@ function hasFavouriteFunction(){
     return false;
 }
 
-/**
+/*!
  * 获取启动内核版本和引擎
  * @returns {Object} 包含
  *      COREVERSIONRANGE: 启动时设定的内核版本范围
@@ -252,7 +252,7 @@ function getStartParams() {
     }
 }
 
-/**
+/*!
  * 添加收藏
  * @param {string} url 收藏的url
  * @param {function} callback  执行接口回调, 处理可能被用户否决
@@ -273,7 +273,7 @@ function addFavourite(url, callback) {
     }
 }
 
-/**
+/*!
  * 更新收藏
  * @param {string} url 收藏的url
  * @param {function} callback  执行接口回调, 处理可能被用户否决
@@ -294,7 +294,7 @@ function updateFavourite(url, callback) {
     }
 }
 
-/**
+/*!
  * 删除指定收藏
  * @param {string} app_name app name 唯一标识
  * @param {function} callback  执行接口回调, 处理可能被用户否决
@@ -315,7 +315,7 @@ function removeFavourite(app_name, callback) {
     }
 }
 
-/**
+/*!
  * 获取指定收藏
  * @param {string} app_name app name 唯一标识
  */
@@ -326,7 +326,7 @@ function getFavourite(app_name) {
     return null;
 }
 
-/**
+/*!
  * 获取所有收藏
  *
  */
@@ -337,7 +337,7 @@ function getFavouriteAll() {
     return null;
 }
 
-/**
+/*!
  * 浮窗控制接口，设置从本浮窗界面进行预热的二级浮窗的启动默认尺寸(若不设置则为全屏)
  * @param {string} mode    全屏模式还是需要Resize的模式。取值范围: "full" 或者 "mini"
  *                         设置成 "mini" 模式后，启动后的界面内需要调用popupResizePosition来调整尺寸才能可见
@@ -346,7 +346,7 @@ function setPopupInitSize(mode) {
     direct_call("setPopupInitSize", mode);
 }
 
-/**
+/*!
  * 浮窗控制接口，设置浮窗显示区域，以相对定位的方式调整弹出框的位置(弹出框弹出后先以尺寸1x1的方式展现)
  * @param {string} align    横纵对齐方式，有left, right, bottom, top, center可选择
  *                          例如: 右下角"right bottom", 居中"center center"
@@ -359,7 +359,7 @@ function popupResizePosition(align, max_width, max_height, aspect) {
     direct_call("popupResizePosition", align, max_width, max_height, aspect);
 }
 
-/**
+/*!
  * 浮窗系统认为自己准备好后，调用此接口，获取设备的焦点。若不调用的话，默认浮窗系统捕获的焦点
  */
 function popupGainFocus() {
@@ -370,7 +370,7 @@ function popupDiscardFocus(){
     direct_call("popupGainFocus");
 }
 
-/**
+/*!
  * 页面预热接口，预热页面将会将以一个新的FrameLayout(内含JsView)的方式加载一个新的应用
  * 但这个应用在warmLoadView之前，不会创建texture/surface的实际描画资源，也不会加载图片
  * 仅加载所有JS代码，并正常走完所有启动逻辑(包括描画逻辑)，但不会走setTimeout对应的延时逻辑，也不会显示
@@ -399,7 +399,7 @@ function warmUpView(mode, app_url) {
     return direct_call("warmUpView", mode, app_url);
 }
 
-/**
+/*!
  * 将warmUpView后的View展示出来
  * 若warmUpView中app_url不为null，进行了全预热，则本调用的app_url可以为null
  * 当warmUpView中设置了app_url时，仍可以新的app_url调整history hash(#)部分进行子页面切换
@@ -412,7 +412,7 @@ function warmLoadView(view_refer_id, app_url, add_history) {
     direct_call("warmLoadView", view_refer_id, app_url, !!add_history);
 }
 
-/**
+/*!
  * 关闭warmUp后未进行warmLoad的View，释放资源
  * @param {number} view_refer_id warmUpView调用后返回来的View ID
  */
@@ -420,7 +420,7 @@ function closeWarmedView(view_refer_id) {
     direct_call("closeWarmedView", view_refer_id);
 }
 
-/**
+/*!
  * 触发预下载内核
  * @param {string} core_version 带branch(主分支版本不带此信息)和版本信息的内核版本, 
  *                              例如: 1021265_release_build_xxx
@@ -430,7 +430,7 @@ function preDownloadSdk(core_version){
     return direct_call("preDownloadSdk", core_version);
 }
 
-// 显示声明，可以提高执行速度和利用上编辑器的成员名提示功能
+//! 显示声明，可以提高执行速度和利用上编辑器的成员名提示功能
 const bridge = {
     getMac,
     getWireMac,

package/utils/JsViewVueTools/JsvStyleClass.js

@@ -2,7 +2,7 @@
  * Created by donglin.lu@qcast.cn on 4/30/2020.
  */
 
-/*
+/*!
  * 【模块 export 内容】
  * JsvStyleClass：面向对象类，定义一组可以复用的Style，模拟css中的.class的概念
  *      功能函数：(参数说明见函数本体)
@@ -37,7 +37,7 @@ import { Forge } from "@shijiu/jsview/dom/jsv-forge-define";
 
 let sIdGenerator = 100;
 
-// 转换CSS名称的对应表
+//! 转换CSS名称的对应表
 let sCssNamesMap = null;
 let sUnitSuffixMap = null;
 
@@ -118,7 +118,7 @@ function _ConvertStyles(styles_define) {
 const CONST_TYPE_BASE = null;
 const CONST_TYPE_TEXT = "text";
 
-// 全局多实例互斥
+//! 全局多实例互斥
 if (typeof window.__JsvStyleClassMutex === 'undefined') {
   window.__JsvStyleClassMutex = 0;
 }

package/utils/JsViewVueTools/JsvStyleSheetsDeclarer.js

@@ -1,5 +1,5 @@
 
-/*
+/*!
  * 【模块 export 内容】
  * JsvStyleSheetsDeclarer: 动态和删除全局的 CssStyle
  *      接口：

package/utils/JsViewVueTools/JsvTextTools.js

@@ -6,7 +6,7 @@
  * @Description: file content
  */
 
-/**
+/*!
  * 获取文字宽度, 一般用于测量文字宽度
  *
  * @param {string} text   文字
@@ -24,20 +24,20 @@ const getTextWidth = (text, style) => {
   return window.PlatformUtils.GetTextWidth(textParams);
 };
 
-/**
+/*!
  * @typedef {object} SliceInfo
  * @property {int} start - 文字起始index
  * @property {int} end - 文字结束index
  * @property {int} width - 文字宽度
  */
 
-/**
+/*!
  * @typedef {object} TextInfo
  * @property {int} totalWidth - 文字整体宽度
  * @property {Array<SliceInfo>} sliceInfo - 每段文字的信息
  */
 
-/**
+/*!
  * 单行超长文字会切成多个div拼接, 由于jsview坐标的取整机制, 拼接出的width和文字width会产生误差, 此接口会返回拼接后的width
  *
  * @param {string} text   文字

package/utils/JsViewVueTools/JsvTextureStore/CanvasTexture/CanvasTexture.ts

@@ -107,7 +107,7 @@ class CanvasTexture extends TextureBase {
      * @param {Number} fromX 绘制起点X
      * @param {Number} fromY 绘制起点Y
      * @param {Number} toX 绘制终点X
-     * @param {Number} toX 绘制终点Y
+     * @param {Number} toY 绘制终点Y
      * @param {Number} lineWidth 线宽
      * @param {String} color 颜色设定，例如rgba(red:0~255, green:0~255, blue:0~255, alpla:0~1.0), 或则 #AARRGGBB
      */
@@ -123,6 +123,34 @@ class CanvasTexture extends TextureBase {
         })
     }
 
+    /**
+     * fillLinearGradient
+     * 用渐变色填充一个矩形区域
+     * 
+     * @param {int} fromX 绘制起点X
+     * @param {int} fromY 绘制起点Y
+     * @param {int} toX 绘制终点X
+     * @param {int} toY 绘制终点Y
+     * @param {Array<String>} colorArray 颜色设定的数组
+     * @param {Array<double>} stopsArray 与color数组个数相同,颜色基准点位置
+     */
+    fillLinearGradient(
+        fromX: Number, fromY: Number,
+        toX: Number, toY: Number,
+        colorArray: Array<String>,
+        stopsArray: Array<Number>,
+    ) {
+        this.drawCommands?.push({
+            "cmd": Constants.CMD_FILL_LINEAR_GRADIENT,
+            "x0": fromX,
+            "y0": fromY,
+            "x1": toX,
+            "y1": toY,
+            "clrs": colorArray,
+            "stops": stopsArray
+        })
+    }
+
     // override
     commit(): String {
         if (!this.commited) {

package/utils/JsViewVueTools/JsvTextureStore/CanvasTexture/CommandList.ts

@@ -1,23 +1,24 @@
 export const CMD_INVALID = 0;
 
-// Canvas初始化
+//! Canvas初始化
 export const CMD_ALLOC_CANVAS = 1;
 
-// Paint初始化
+//! Paint初始化
 export const CMD_PREPARE_PAINT = 2;
 
-// Path初始化
+//! Path初始化
 export const CMD_PREPARE_PATH = 3;
 
-// 绘制指令
+//! 绘制指令
 export const CMD_CLEAR_CANVAS = 10;
 export const CMD_DRAW_COLOR = 11;
 export const CMD_DRAW_CIRCLE_WITH_PAINT = 12;
 export const CMD_DRAW_RECT_WITH_PAINT = 13;
 export const CMD_DRAW_PATH_WITH_PAINT = 14;
 export const CMD_DRAW_LINE = 15;
+export const CMD_FILL_LINEAR_GRADIENT = 16;
 
-// Path的子命令
+//! Path的子命令
 export const PATH_CMD_MOVE_TO = 30;
 export const PATH_CMD_LINE_TO = 31;
 export const PATH_CMD_ARC_TO = 32;

package/utils/JsViewVueTools/JsvTextureStore/JsvTextureStore.ts

@@ -1,6 +1,30 @@
+/*! 
+ *  JsvTextureStoreApi
+ *      canvasTexture:
+ *          创建texture(图片纹理)句柄, 通过 CanvasTexture 的API进行绘制, 使用注意以下几点
+ *          a. commit() 接口调用之前可以任意绘制, commit之后就无法更改, commit之后才能使用, commit后绘制内容会被全局保存
+ *          b. commit()的返回是其使用名称, 在div.backgroundImage和img.src中可使用, 格式: jsvtexturestore://commit返回名
+ *          c.【非常重要】CanvasTexture是全局管理, commit()之后 不会自动释放, 需要手动调用 deleteTexture, 其参数是commit的返回值
+ *      deleteTexture:
+ *          删除全局保存的texture(图片纹理)
+ *      
+ *  CanvasTexture的接口(见 ./CanvasTexture/CanvasTexture.ts 的函数头):
+ *      Path类型: 例如 rectPath, circlePath (见 ./CanvasTexture/Path.ts 的函数头)
+ *          通过 canvasTexture.xxxPath() 获得一个path操作对象，然后通过其接口进行游标运动形成绘制路径
+ *          Path.fill() 或者 Path.stroke 调用前可以移动游标进行路径规划, 一旦fill或者stroke后就不能更改了。
+ *      非Path接口: 完成单一绘制动作，例如drawLine, drawColor
+ */
+
 import CanvasTexture from "./CanvasTexture/CanvasTexture";
 import sStore from "./Store";
 
+let sJsvTextureConst = {
+    LEFT: 1,
+    TOP: 2,
+    RIGHT: 3,
+    BOTTOM: 4,
+}
+
 let sTextureStoreApi: Object = {
     /**
      * canvasTexture
@@ -12,10 +36,44 @@ let sTextureStoreApi: Object = {
      * @param {String|null} baseName 可选, 访问名的前缀信息
      * @return {CanvasTexture}
      */
-    canvasTexture: (width: Number, height: Number, baseName: String | null) => {
+    canvasTexture: (width: Number, height: Number, baseName: String | null): Object => {
         return new CanvasTexture(width, height, baseName);
     },
 
+    /**
+     * getLinearGradientTexture
+     * 按照要求创建一个绘制渐变色的纹理,
+     * 绘制从起始位置到终止位置的一条线，
+     * 例如从右边上的中点绘制到上边缘的中点的直线: RIGHT:0.5 -> TOP:0.5
+     * 返回值为访问名
+     * 
+     * @param {int} startSide  JsvTextureConst的 LEFT/TOP/RIGHT/BOTTOM, 起始位置
+     * @param {double} startSidePercent  起始点在所在边的比例位置
+     * @param {int} endSide  JsvTextureConst的 LEFT/TOP/RIGHT/BOTTOM, 终止位置
+     * @param {double} endSidePercent  终止点在所在边的比例位置
+     * @param {Array<String>} colorArray 颜色基准点的颜色队列
+     * @param {int} stopsDenominator  stops信息百分比的分母，值越小其texture越省内存
+     * @param {Array<int>} stopsArray  颜色基准点的百分比的分子队列
+     * 
+     * @return {String} 此Texture的访问名，可以在 img.src 或者 div.backgroundImage 通过 "texturestore://访问名"使用
+     */
+    getLinearGradientTexture: (
+        startSide: Number, startSidePercent: Number,
+        endSide: Number, endSidePercent: Number,
+        colorArray: Array<String>,
+        stopsDenominator: Number, stopsArray: Array<Number>
+    ): String => {
+        // TODO: 仿照ResProvider的GetLinearGradientTexture调用 this.canvasTexture 创建width+x/height+x的的texture
+        // 然后进行绘制一个填满整个canvas的texture
+        return "";
+    },
+
+    /**
+     * deleteTexture
+     * 删除commit后的texture
+     * 
+     * @param {String} storeName 此Texture的应用名称, 是canvasTexture.commit()后的返回值
+     */
     deleteTexture: (storeName: String) => {
         let textureRef = sStore.getFromStore(storeName);
         if (textureRef) {
@@ -25,7 +83,7 @@ let sTextureStoreApi: Object = {
     }
 }
 
-
 export {
     sTextureStoreApi as JsvTextureStoreApi,
+    sJsvTextureConst as JsvTextureConst,
 }

package/utils/JsViewVueTools/NinePatchHelper.js

@@ -3,7 +3,7 @@ function toHtmlBorderSet() {
 }
 
 
-/*
+/*!
  * imageWidth { int } // (必填)原图信息: 原图的宽度(由于正方形,宽高相同)
  * centerWidth  { int } // (必填)原图信息: .9图的中心区域宽度(repeat区域)
  * imageDspWidth { int } // (选填)原图缩放后的显示宽度，计算方法: 

package/utils/JsViewVueWidget/JsvActorMove/ActorControlBase.js

@@ -7,7 +7,7 @@
  */
 import { Forge } from "@shijiu/jsview/dom/jsv-forge-define";
 
-// JsvSpriteBase comes from JsView React Project
+//! JsvSpriteBase comes from JsView React Project
 
 class ActorControlBase {
   constructor(params_count) {

package/utils/JsViewVueWidget/JsvActorMove/JsvActorMoveControl.js

@@ -13,7 +13,7 @@ const CONST_MOVE_TYPE_ACC = 1; // 抛物变速运动
 const CONST_MOVE_TYPE_UNIFORM = 2; // 匀速运动
 const CONST_MOVE_TYPE_JUMP = 3; // 无动画，直接调整坐标到目标位置
 
-// 单向运动控制模块，单方向指的是只能进行一个方向的运动，要不是x，要不是y
+//! 单向运动控制模块，单方向指的是只能进行一个方向的运动，要不是x，要不是y
 class JsvActorMoveControl extends ActorControlBase {
   constructor() {
     // 0: X位置,

package/utils/JsViewVueWidget/JsvApic/{BrowserApic → JsvApic}/BrowserApic.vue

@@ -6,10 +6,12 @@
  * @Description: file content
 -->
 <script setup>
-import Viewer from "./Viewer";
-import WebpData from "./WebpData";
-import GifData from "./GifData";
-import { LoopType } from "./LoopToolBase";
+import {
+  Viewer,
+  WebpData,
+  GifData
+} from "../JsvBrowserApicLib/BrowserApicLib";
+import { LoopType } from "../JsvCommonLoopToolBase";
 import { onMounted, shallowRef } from "vue";
 
 const loadImage = (url) => {
@@ -75,6 +77,14 @@ const props = defineProps({
 let viewer = null;
 let canvasProxyRef = shallowRef(null);
 
+const play = () => {
+  viewer?.play(props.loopType, props.loopInfo);
+};
+
+const stop = () => {
+  viewer?.stop();
+};
+
 onMounted(() => {
   let domLayoutView = canvasProxyRef.value.jsvGetProxyView();
   domLayoutView.RegisterOnProxyReady(() => {
@@ -90,37 +100,24 @@ onMounted(() => {
           onstart: props.onStart,
           onend: props.onEnd,
         };
-        viewer = new Viewer(
-          data,
-          canvas,
-          listener,
-          props.autoPlay,
-          props.loopType,
-          props.loopInfo
-        );
+        viewer = new Viewer(data, canvas, listener);
         if (props.onLoad) {
           props.onLoad();
         }
+        if (props.autoPlay) {
+          play();
+        }
       })
       .catch((err) => console.error(err));
   });
 });
 
 defineExpose({
-  play: () => {
-    viewer?.play();
-  },
-  stop: () => {
-    viewer?.stop();
-  },
+  play,
+  stop,
 });
 </script>
 
-<script>
-import { LoopType } from "./LoopToolBase";
-export { LoopType };
-</script>
-
 <template>
   <div ref="canvasProxyRef" :style="props.style" />
 </template>

package/utils/JsViewVueWidget/JsvApic/{JsvApic.vue → JsvApic/JsvApic.vue}

@@ -20,19 +20,8 @@
  *          play(): 开始播放
 -->
 <script>
-import ForgeHandles from "../../JsViewVueTools/ForgeHandles";
-
-let LOOP_DEFAULT = 0;
-let LOOP_INFINITE = 1;
-let LOOP_FINITE = 2;
-let LOOP_PART = 3;
-let LoopType = {
-  LOOP_DEFAULT: LOOP_DEFAULT,
-  LOOP_INFINITE: LOOP_INFINITE,
-  LOOP_FINITE: LOOP_FINITE,
-  LOOP_PART: LOOP_PART,
-};
-export { LoopType };
+import ForgeHandles from "../../../JsViewVueTools/ForgeHandles";
+import { LoopType } from "../JsvCommonLoopToolBase";
 
 export default {
   props: {
@@ -44,7 +33,7 @@ export default {
     },
     loopType: {
       type: Number,
-      default: LOOP_DEFAULT,
+      default: LoopType.LOOP_DEFAULT,
     },
     loopInfo: {
       type: Array,

package/utils/JsViewVueWidget/JsvApic/{index.js → JsvApic/index.js}

@@ -5,15 +5,13 @@
  * @LastEditTime: 2021-10-13 17:41:08
  * @Description: file content
  */
-//考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
+//! 考虑到.vue文件除了export default的component外，还有可能export其他对象,因此使用import * as
 import * as JsvApic from "./JsvApic.vue";
 let _JsvApic;
 if (window.JsView) {
   _JsvApic = JsvApic.default;
 } else {
-  const BrowserApic = await import("./BrowserApic/BrowserApic.vue");
+  const BrowserApic = await import("./BrowserApic.vue");
   _JsvApic = BrowserApic.default;
 }
-let LoopType = JsvApic.LoopType;
 export default _JsvApic;
-export { LoopType };