@netless/forge-whiteboard 0.1.7 → 0.1.9

package/README.md

@@ -134,7 +134,7 @@ whiteboard.setElementAttribute(pageId, elementId, "strokeColor", "#fff");
 whiteboard.setElementAttribute(pageId, elementId, "fontFamily", "kai");
 ```
 
-### 页面操作
+## 页面操作
 
 **基础页面操作**
 
@@ -195,9 +195,9 @@ whiteboard.clonePage("1", "2");
 whiteboard.clearPage();
 ```
 
-### 白板权限
+## 白板权限
 
-`forge-whiteboard` 设计了细致的白板权限控制机制, 通过不同权限配置可以实现很多有趣的场景.
+`forge-whiteboard` 设计了细致的白板权限控制机制, 通过不同权限配置可以实现很多有趣的场景. 默认没有给任何权限.
 
 | 权限类型 | 描述 |
 |---|---|
@@ -211,6 +211,66 @@ whiteboard.clearPage();
 |WhiteboardPermissionFlag.setOthersView|可以修改他人的视角模式, 指定他人的页码|
 |WhiteboardPermissionFlag.all|拥有所有权限|
 
+### 权限相关 api
+
 ```javascript
+// 给当前客户端用户设置权限
+whiteboard.permissions.addPermission(WhiteboardPermissionFlag.all);
+
+// 给指定用户设置权限
+whiteboard.permissions.addPermission(WhiteboardPermissionFlag.all, "userId");
+
+// 获取当前权限列表
+whiteboard.permissions.getPermissionFlags();
+
+// 获取当前权限值, 可以用来判断是否有某个权限
+const permissionValue = whiteboard.permissions.getPermissionValue();
+// 是否有绘制权限
+permissionValue & WhiteboardPermissionFlag.draw;
+```
+
+## 相机
+
+`forge-whiteboard` 通过相机的概念来控制试图的拖动和缩放, 以及配置白板画布的范围.
+
+### 相机相关配置
+
+**WhiteboardOption.maxScaleRatio** 设置画布最大区域在默认高宽上的放大比例. 默认值为 -1, 表示无边界. 只能设置 -1 或者 >= 1 的值.  
+例如: `WhiteboardOption.width` 设置为 1920, `WhiteboardOption.height` 设置为 1080, `WhiteboardOption.maxScaleRatio` 设置为 2, 则画布最大区域为 3840 x 2160. 拖动和缩放操作都会受最大区域限制.
+
+**Whiteboard.enableCameraBoundaryHighlight** 控制相机超出边界时是否显示向内的高亮阴影以做警示. 默认值为 true.
+
+**Whiteboard.cameraBoundaryColor** 设置警示颜色. 默认值为 "#F44336".
+
+**Whiteboard.enableCameraByMouse** 控制是否允许通过鼠标/触摸板控制相机的缩放和拖动. 默认值为 true.
 
+**Whiteboard.enableCameraByTouch** 控制是否允许通过触摸屏上的触摸手势控制相机的缩放和拖动. 默认值为 true.
+
+```typescript
+// 设置最高 2 倍放大
+const whiteboard = await room.applicationManager.launchApplication(WhiteboardApplication, {
+    width: 1920,
+    height: 1080,
+    maxScaleRatio: 2,
+    defaultToolbarStyle: {
+        tool: "curve"
+    }
+}, "MainWhiteboard");
+
+// 取消相机超出边界时的高亮显示
+whiteboard.enableCameraBoundaryHighlight = false;
+// 禁止通过触摸手势控制相机
+whiteboard.enableCameraByMouse = false;
 ```
+
+### 通过代码控制相机
+
+**Whiteboard.translateCamera** 拖动相机
+**Whiteboard.scaleCamera** 以画布中心为不动点缩放相机
+**Whiteboard.resetCamera** 重置相机位置和缩放
+
+```typescript
+whiteboard.scaleCamera(1.2);
+whiteboard.translateCamera(10, 10);
+whiteboard.resetCamera();
+```

package/changelog.md

@@ -0,0 +1,28 @@
+## changelog
+
+### 0.1.2
+- 修复因为复用 element uuid 导致的不同步现象
+
+### 0.1.2
+- 修复 `@netless/forge-room` 依赖版本号
+
+### 0.1.4
+- 修复 root view 宽度或高度为 0 时的报错
+
+### 0.1.6
+- 修复调用 `rasterize` 后 dom 树上会多出一个 canvas 元素的问题
+
+### 0.1.7
+
+- 修复对应工具不支持时不能加载白板的问题
+
+### 0.1.8
+
+- `Whiteboard.translateView`相机拖动 api
+- `Whiteboard.scaleView`相机缩放 api
+- `Whiteboard.resetView`相机缩放 api
+- `Whiteboard.enableCameraByTouch` 控制是否允许通过触摸手势控制相机
+- `Whiteboard.enableCameraByMouse` 控制是否允许通过鼠标/触摸板控制相机
+- `Whiteboard.enableCameraBoundaryHighlight` 控制是否允许相机超出边界时高亮显示
+- `Whiteboard.cameraBoundaryColor` 设置边界高亮颜色
+- `WhiteboardOption.maxScaleRatio` 控制相机最大放大比例

package/dist/Camera.d.ts

@@ -21,9 +21,18 @@ export declare class Camera extends EventEmitter<CameraEvents> {
     private hasPermission;
     private gesture;
     private inherentScale;
+    private maxScale;
+    private initSize;
+    private bound;
+    private boundTiemoutId;
+    enableByMouse: boolean;
+    enableByTouch: boolean;
+    boundaryColor: string;
+    enableBoundaryHighlight: boolean;
     private get inherentMatrix();
     private get translateScale();
-    constructor(dom: HTMLDivElement, userManager: UserManager, scope: paper.PaperScope, whiteboardAttrsMap: Y.Map<any>, hasPermission: (flag: WhiteboardPermissionFlag) => boolean, requestUserMap: (userId: string) => Y.Map<any>, paperSize: () => [number, number], domSize: () => [number, number]);
+    constructor(initSize: paper.Size, maxScale: number, dom: HTMLDivElement, userManager: UserManager, scope: paper.PaperScope, whiteboardAttrsMap: Y.Map<any>, hasPermission: (flag: WhiteboardPermissionFlag) => boolean, requestUserMap: (userId: string) => Y.Map<any>, paperSize: () => [number, number], domSize: () => [number, number]);
+    private highlightBound;
     updateInherentScale(scale: number): void;
     private getActiveMatrix;
     triggerZoom(): void;
@@ -34,9 +43,12 @@ export declare class Camera extends EventEmitter<CameraEvents> {
     private handleUserJoin;
     private createModel;
     private handleViewMatrixUpdate;
-    private appendViewMatrix;
+    private validNextMatrix;
+    private updateViewMatrix;
     private handleWheel;
+    scale(value: number): void;
     translate(offsetX: number, offsetY: number): void;
+    reset(): void;
 }
 export {};
 //# sourceMappingURL=Camera.d.ts.map

package/dist/Camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../src/Camera.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAgB,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAC,wBAAwB,EAAC,MAAM,oBAAoB,CAAC;AAI5D,UAAU,YAAY;IAClB,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;IACrC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED,qBAAa,MAAO,SAAQ,YAAY,CAAC,YAAY,CAAC;IAElD,SAAgB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC;IAExC,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,aAAa,CAAa;IAElC,OAAO,KAAK,cAAc,GAIzB;IAED,OAAO,KAAK,cAAc,GAGzB;gBAGG,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,CAAC,UAAU,EACvB,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAC9B,aAAa,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,EAC1D,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAE9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAEjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA8C5B,mBAAmB,CAAC,KAAK,EAAE,MAAM;IAIxC,OAAO,CAAC,eAAe;IAahB,WAAW;IAIX,qBAAqB,CAAC,MAAM,EAAE,MAAM;IAMpC,qBAAqB;IAM5B,OAAO,CAAC,sBAAsB,CAgB5B;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,sBAAsB,CA2B5B;IAEF,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,WAAW,CAuCjB;IAEK,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKpD"}
+{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../src/Camera.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAgB,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAC,wBAAwB,EAAC,MAAM,oBAAoB,CAAC;AAI5D,UAAU,YAAY;IAClB,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC;IACrC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED,qBAAa,MAAO,SAAQ,YAAY,CAAC,YAAY,CAAC;IAElD,SAAgB,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC;IAExC,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,cAAc,CAAM;IAErB,aAAa,EAAE,OAAO,CAAQ;IAC9B,aAAa,EAAE,OAAO,CAAQ;IAC9B,aAAa,EAAE,MAAM,CAAa;IAClC,uBAAuB,EAAE,OAAO,CAAQ;IAE/C,OAAO,KAAK,cAAc,GAIzB;IAED,OAAO,KAAK,cAAc,GAGzB;gBAGG,QAAQ,EAAE,KAAK,CAAC,IAAI,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,KAAK,CAAC,UAAU,EACvB,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAC9B,aAAa,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,EAC1D,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAE9C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAEjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAyDnC,OAAO,CAAC,cAAc;IAUf,mBAAmB,CAAC,KAAK,EAAE,MAAM;IAIxC,OAAO,CAAC,eAAe;IAahB,WAAW;IAOX,qBAAqB,CAAC,MAAM,EAAE,MAAM;IAMpC,qBAAqB;IAM5B,OAAO,CAAC,sBAAsB,CAgB5B;IAEF,OAAO,CAAC,eAAe,CAKrB;IAEF,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,sBAAsB,CA2B5B;IAEF,OAAO,CAAC,eAAe;IAwDvB,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,WAAW,CA4CjB;IAEK,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjD,KAAK,IAAI,IAAI;CAIvB"}

package/dist/Whiteboard.d.ts

@@ -108,6 +108,22 @@ export declare class Whiteboard extends EventEmitter<WhiteboardEvents> implement
      * 描边宽度
      */
     strokeWidth: number;
+    /**
+     * 是否允许用鼠标/触控板进行缩放和拖动画布
+     */
+    enableCameraByMouse: boolean;
+    /**
+     * 是否允许触摸屏上触摸事件进行缩放和拖动画布
+     */
+    enableCameraByTouch: boolean;
+    /**
+     * 相机超出边界时, 警示阴影的颜色, 默认 "#F44336"
+     */
+    cameraBoundaryColor: string;
+    /**
+     * 是否允许相机超出边界时, 警示高亮阴影, 默认 true
+     */
+    enableCameraBoundaryHighlight: boolean;
     getElementAttribute: <K extends ElementAttributeKey>(sceneId: string, elementId: string, attribute: K) => ElementAttributes[K];
     setElementAttribute: <K extends keyof ElementAttributes>(sceneId: string, elementId: string, attribute: K, value: ElementAttributes[K]) => any;
     getCurrentTool: () => WhiteboardToolType;
@@ -149,6 +165,21 @@ export declare class Whiteboard extends EventEmitter<WhiteboardEvents> implement
      * 清空当前页面
      */
     clearPage: () => void;
+    /**
+     * 平移画布
+     * @param {number} offsetX - x 轴偏移量
+     * @param {number} offsetY - y 轴偏移量
+     */
+    translateCamera: (offsetX: number, offsetY: number) => void;
+    /**
+     * 以画布中心为固定点缩放画布
+     * @param {number} scale - 缩放比例
+     */
+    scaleCamera: (scale: number) => void;
+    /**
+     * 重置画布, 将画布缩放比例重置为 1, 平移量重置为 [0, 0]
+     */
+    resetCamera: () => void;
     /**
      * 为 userId 指定的用户设置页面, 调用需要有 `WhiteboardPermissionFlag.setOthersView` 权限,
      * userId 指定的用户的视角模式应为 `free`, 否则调用无效

package/dist/Whiteboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Whiteboard.d.ts","sourceRoot":"","sources":["../src/Whiteboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Whiteboard.d.ts","sourceRoot":"","sources":["../src/Whiteboard.ts"],"names":[],"mappings":"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"}

package/dist/WhiteboardApplication.d.ts

@@ -13,6 +13,12 @@ export interface WhiteboardOption {
      * 白板可视区域高度, 如果各客户端配置不一致则会导致可视区域不同步
      */
     height: number;
+    /**
+     * 白板区域最大缩放比例, 如果各客户端配置不一致则会导致可视区域不同步
+     * 参数必须大于等于 1, 或者 -1, -1 表示无边界.
+     * @default -1
+     */
+    maxScaleRatio?: number;
     /**
      * 默认工具栏样式, 如果各客户端配置不一致则随机应用其中一个值
      */

package/dist/WhiteboardApplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WhiteboardApplication.d.ts","sourceRoot":"","sources":["../src/WhiteboardApplication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAM,MAAM,qBAAqB,CAAC;AAS7D,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAUhE,OAAO,EAAyC,UAAU,EAAC,MAAM,cAAc,CAAC;AAchF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACL,WAAW,GACX,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEb,qBAAa,qBAAsB,SAAQ,mBAAmB,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAExF,MAAM,CAAC,eAAe,SAAuB;IAE7C,SAAgB,IAAI,EAAE,MAAM,CAAuB;IAC5C,OAAO,EAAE,UAAU,CAAC;IAEpB,YAAY,EAAG,YAAY,CAAC;IACnC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,oBAAoB,CAAwB;IACpD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,YAAY,CAAyC;IAE7D,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,aAAa,CAAuD;IAC5E,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,qBAAqB,CAAuD;IACpF,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,mBAAmB,CAAuD;IAClF,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAwB;IAE3C,OAAO,KAAK,WAAW,GAMtB;;IAsND,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,eAAe,CAErB;IAEW,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuOhE,OAAO,CAAC,gBAAgB,CA6CtB;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,oBAAoB,CAI1B;IAEF,OAAO,CAAC,qBAAqB,CAG3B;IAEF,OAAO,CAAC,kBAAkB,CAmCxB;IAEF,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,yBAAyB,CAQhC;IAED,OAAO,CAAC,kBAAkB,CAExB;IAEF,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,mBAAmB,CAazB;IAEF,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,mBAAmB,CAUzB;IAEF,OAAO,CAAC,iCAAiC,CAGvC;IAEF,OAAO,CAAC,mBAAmB,CAczB;IAEF,OAAO,CAAC,oBAAoB,CAqD1B;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4C9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAexC"}
+{"version":3,"file":"WhiteboardApplication.d.ts","sourceRoot":"","sources":["../src/WhiteboardApplication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAM,MAAM,qBAAqB,CAAC;AAS7D,OAAO,EAAC,YAAY,EAAE,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAUhE,OAAO,EAAyC,UAAU,EAAC,MAAM,cAAc,CAAC;AAchF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACL,WAAW,GACX,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,GACT,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEb,qBAAa,qBAAsB,SAAQ,mBAAmB,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAExF,MAAM,CAAC,eAAe,SAAuB;IAE7C,SAAgB,IAAI,EAAE,MAAM,CAAuB;IAC5C,OAAO,EAAE,UAAU,CAAC;IAEpB,YAAY,EAAG,YAAY,CAAC;IACnC,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,oBAAoB,CAAwB;IACpD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,YAAY,CAAyC;IAE7D,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,UAAU,CAA4C;IAC9D,OAAO,CAAC,aAAa,CAAuD;IAC5E,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,qBAAqB,CAAuD;IACpF,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,mBAAmB,CAAuD;IAClF,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,WAAW,CAAwB;IAE3C,OAAO,KAAK,WAAW,GAMtB;;IAgQD,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,eAAe,CAErB;IAEW,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6OhE,OAAO,CAAC,gBAAgB,CA6CtB;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,oBAAoB,CAI1B;IAEF,OAAO,CAAC,qBAAqB,CAG3B;IAEF,OAAO,CAAC,kBAAkB,CAmCxB;IAEF,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,yBAAyB,CAQhC;IAED,OAAO,CAAC,kBAAkB,CAExB;IAEF,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,mBAAmB,CAazB;IAEF,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,mBAAmB,CAUzB;IAEF,OAAO,CAAC,iCAAiC,CAGvC;IAEF,OAAO,CAAC,mBAAmB,CAczB;IAEF,OAAO,CAAC,oBAAoB,CAqD1B;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4C9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAexC"}

package/dist/whiteboard.esm.js

@@ -28828,6 +28828,14 @@ var Camera = class extends EventEmitter8 {
   hasPermission;
   gesture;
   inherentScale = 1;
+  maxScale;
+  initSize;
+  bound;
+  boundTiemoutId;
+  enableByMouse = true;
+  enableByTouch = true;
+  boundaryColor = "#F44336";
+  enableBoundaryHighlight = true;
   get inherentMatrix() {
     const inherentMatrix = new this.scope.Matrix();
     inherentMatrix.scale(this.inherentScale, [0, 0]);
@@ -28837,8 +28845,12 @@ var Camera = class extends EventEmitter8 {
     const view = this.scope.project.view;
     return 1 / view.matrix.scaling.x;
   }
-  constructor(dom, userManager, scope, whiteboardAttrsMap, hasPermission, requestUserMap, paperSize, domSize) {
+  constructor(initSize, maxScale, dom, userManager, scope, whiteboardAttrsMap, hasPermission, requestUserMap, paperSize, domSize) {
     super();
+    this.maxScale = maxScale;
+    this.bound = window.document.createElement("div");
+    this.bound.style.cssText = `transition: box-shadow 100ms;pointer-events:none;z-index:99;position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);`;
+    this.initSize = initSize;
     this.hasPermission = hasPermission;
     this.paperSize = paperSize;
     this.domSize = domSize;
@@ -28847,6 +28859,7 @@ var Camera = class extends EventEmitter8 {
     this.requestUserMap = requestUserMap;
     this.userManager = userManager;
     this.dom = dom;
+    this.dom.appendChild(this.bound);
     this.dom.addEventListener("wheel", this.handleWheel, { passive: false, capture: true });
     this.dom.addEventListener("touchstart", (e) => {
       e.preventDefault();
@@ -28867,17 +28880,32 @@ var Camera = class extends EventEmitter8 {
     this.whiteboardAttrsMap.observe(this.handleMainCameraChange);
     this.gesture = new Gesture(this.dom, this.scope);
     this.gesture.on("offset", (x, y) => {
+      if (!this.enableByTouch) {
+        return;
+      }
       const matrix = new this.scope.Matrix();
       matrix.translate({ x: x * this.translateScale, y: y * this.translateScale });
-      this.appendViewMatrix(matrix);
+      this.updateViewMatrix(matrix);
     });
     this.gesture.on("scale", (scale, center) => {
+      if (!this.enableByTouch) {
+        return;
+      }
       const matrix = new this.scope.Matrix();
       const paperPoint = this.scope.project.view.viewToProject(center);
       matrix.scale(scale, paperPoint);
-      this.appendViewMatrix(matrix);
+      this.updateViewMatrix(matrix);
     });
   }
+  highlightBound() {
+    if (this.enableBoundaryHighlight) {
+      this.bound.style.boxShadow = `inset 0px 0px 6px 2px ${this.boundaryColor}`;
+      window.clearTimeout(this.boundTiemoutId);
+      this.boundTiemoutId = window.setTimeout(() => {
+        this.bound.style.boxShadow = `none`;
+      }, 100);
+    }
+  }
   updateInherentScale(scale) {
     this.inherentScale = scale;
   }
@@ -28894,6 +28922,9 @@ var Camera = class extends EventEmitter8 {
     return new this.scope.Matrix(matrixValue);
   }
   triggerZoom() {
+    const [width, height] = this.domSize();
+    this.bound.style.width = `${width}px`;
+    this.bound.style.height = `${height}px`;
     this.emit("zoom", this.inherentMatrix.appended(this.getActiveMatrix()));
   }
   resetViewMatrixToFlow(userId) {
@@ -28972,29 +29003,89 @@ var Camera = class extends EventEmitter8 {
       }
     }
   };
-  appendViewMatrix(matrix) {
+  validNextMatrix(next) {
+    let shouldHighlightBound = false;
+    const maxTranslate = (this.maxScale - 1) / 2;
+    const maxScale = maxTranslate * 2 + 1;
+    const minScale = 1 / maxScale;
+    if (next.a > maxScale) {
+      const tx = next.tx / next.a;
+      next.a = maxScale;
+      next.tx = tx * maxScale;
+      shouldHighlightBound = true;
+    }
+    if (next.a < minScale) {
+      const tx = next.tx / next.a;
+      next.a = minScale;
+      next.tx = tx * minScale;
+      shouldHighlightBound = true;
+    }
+    if (next.d > maxScale) {
+      const ty = next.ty / next.d;
+      next.d = maxScale;
+      next.ty = ty * maxScale;
+      shouldHighlightBound = true;
+    }
+    if (next.d < minScale) {
+      const ty = next.ty / next.d;
+      next.d = minScale;
+      next.ty = ty * minScale;
+      shouldHighlightBound = true;
+    }
+    const maxTranslateX = this.initSize.width * maxTranslate;
+    if (next.tx / next.a > maxTranslateX) {
+      next.tx = maxTranslateX * next.a;
+      shouldHighlightBound = true;
+    }
+    const minTx = (this.initSize.width * (maxTranslate + 1) - this.scope.project.view.bounds.width) * -next.a;
+    if (next.tx < minTx) {
+      next.tx = minTx;
+      shouldHighlightBound = true;
+    }
+    const maxTranslateY = this.initSize.height * maxTranslate;
+    if (next.ty / next.d > maxTranslateY) {
+      next.ty = maxTranslateY * next.d;
+      shouldHighlightBound = true;
+    }
+    const minTy = (this.initSize.height * (maxTranslate + 1) - this.scope.project.view.bounds.height) * -next.d;
+    if (next.ty < minTy) {
+      next.ty = minTy;
+      shouldHighlightBound = true;
+    }
+    if (shouldHighlightBound) {
+      this.highlightBound();
+    }
+    return next;
+  }
+  updateViewMatrix(matrix, append = true) {
     const userMap = this.requestUserMap(this.userManager.selfId);
     const cameraMode = userMap.get(WhiteboardKeys.cameraMode);
-    if (cameraMode === "free" || cameraMode === "main") {
+    let next = matrix;
+    if (append) {
       const currentMatrixValue = userMap.get(WhiteboardKeys.viewMatrix);
       const current = new this.scope.Matrix(currentMatrixValue);
-      const next = current.appended(matrix);
-      if (next.scaling.x <= 3 && next.scaling.x >= 0.3) {
-        userMap.set(WhiteboardKeys.viewMatrix, [next.a, next.b, next.c, next.d, next.tx, next.ty]);
+      next = current.appended(matrix);
+    }
+    if (this.maxScale >= 1) {
+      next = this.validNextMatrix(next);
+    } else {
+      if (!(next.scaling.x <= 3 && next.scaling.x >= 0.2) && append) {
+        return;
       }
     }
+    if (cameraMode === "free" || cameraMode === "main") {
+      userMap.set(WhiteboardKeys.viewMatrix, [next.a, next.b, next.c, next.d, next.tx, next.ty]);
+    }
     if (cameraMode === "main") {
       if (this.hasPermission(32 /* mainView */)) {
-        const currentMatrixValue = this.whiteboardAttrsMap.get(WhiteboardKeys.viewMatrix);
-        const current = new this.scope.Matrix(currentMatrixValue);
-        const next = current.appended(matrix);
-        if (next.scaling.x <= 3 && next.scaling.x >= 0.3) {
-          this.whiteboardAttrsMap.set(WhiteboardKeys.viewMatrix, [next.a, next.b, next.c, next.d, next.tx, next.ty]);
-        }
+        this.whiteboardAttrsMap.set(WhiteboardKeys.viewMatrix, [next.a, next.b, next.c, next.d, next.tx, next.ty]);
       }
     }
   }
   handleWheel = (evt) => {
+    if (!this.enableByMouse) {
+      return;
+    }
     evt.preventDefault();
     evt.stopImmediatePropagation();
     evt.stopPropagation();
@@ -29018,22 +29109,33 @@ var Camera = class extends EventEmitter8 {
       } else {
         scale = 1 + Math.abs(deltaY / wheelDelta);
       }
+      scale = Math.max(0.9, scale);
+      scale = Math.min(1.1, scale);
       matrix.scale(scale, paperPoint);
-      this.appendViewMatrix(matrix);
+      this.updateViewMatrix(matrix);
     } else {
       const deltaX = this.lastDelta.x + evt.deltaX;
       const deltaY = this.lastDelta.y + evt.deltaY;
       const matrix = new this.scope.Matrix();
       matrix.translate({ x: -deltaX * window.devicePixelRatio, y: -deltaY * window.devicePixelRatio });
-      this.appendViewMatrix(matrix);
+      this.updateViewMatrix(matrix);
     }
     this.lastTriggerTime = Date.now();
     this.lastDelta = { x: 0, y: 0 };
   };
+  scale(value) {
+    const matrix = new this.scope.Matrix();
+    matrix.scale(value, this.scope.project.view.bounds.center);
+    this.updateViewMatrix(matrix);
+  }
   translate(offsetX, offsetY) {
     const matrix = new this.scope.Matrix();
     matrix.translate({ x: offsetX, y: offsetY });
-    this.appendViewMatrix(matrix);
+    this.updateViewMatrix(matrix);
+  }
+  reset() {
+    this.updateViewMatrix(new this.scope.Matrix(), false);
+    this.lastDelta = { x: 0, y: 0 };
   }
 };
 
@@ -29142,6 +29244,22 @@ var Whiteboard = class extends EventEmitter9 {
    * 描边宽度
    */
   strokeWidth;
+  /**
+   * 是否允许用鼠标/触控板进行缩放和拖动画布
+   */
+  enableCameraByMouse;
+  /**
+   * 是否允许触摸屏上触摸事件进行缩放和拖动画布
+   */
+  enableCameraByTouch;
+  /**
+   * 相机超出边界时, 警示阴影的颜色, 默认 "#F44336"
+   */
+  cameraBoundaryColor;
+  /**
+   * 是否允许相机超出边界时, 警示高亮阴影, 默认 true
+   */
+  enableCameraBoundaryHighlight;
   getElementAttribute;
   setElementAttribute;
   getCurrentTool;
@@ -29183,6 +29301,21 @@ var Whiteboard = class extends EventEmitter9 {
    * 清空当前页面
    */
   clearPage;
+  /**
+   * 平移画布
+   * @param {number} offsetX - x 轴偏移量
+   * @param {number} offsetY - y 轴偏移量
+   */
+  translateCamera;
+  /**
+   * 以画布中心为固定点缩放画布
+   * @param {number} scale - 缩放比例
+   */
+  scaleCamera;
+  /**
+   * 重置画布, 将画布缩放比例重置为 1, 平移量重置为 [0, 0]
+   */
+  resetCamera;
   /**
    * 为 userId 指定的用户设置页面, 调用需要有 `WhiteboardPermissionFlag.setOthersView` 权限,
    * userId 指定的用户的视角模式应为 `free`, 否则调用无效
@@ -30139,6 +30272,15 @@ var WhiteboardApplication = class extends AbstractApplication {
       this.inputType = type;
       this.emitter.emit("inputTypeChange", this.inputType);
     };
+    this.emitter.translateCamera = (offsetX, offsetY) => {
+      this.camera.translate(offsetX, offsetY);
+    };
+    this.emitter.scaleCamera = (scale) => {
+      this.camera.scale(scale);
+    };
+    this.emitter.resetCamera = () => {
+      this.camera.reset();
+    };
     this.emitter.on("error", (errorCode, errorMessage) => {
       log3("WhiteboardApplicationError", {
         errorCode,
@@ -30202,6 +30344,38 @@ var WhiteboardApplication = class extends AbstractApplication {
         that.toolbarModel.dashArray = v;
       }
     });
+    Object.defineProperty(this.emitter, "enableCameraByMouse", {
+      get() {
+        return that.camera.enableByMouse;
+      },
+      set(value) {
+        that.camera.enableByMouse = value;
+      }
+    });
+    Object.defineProperty(this.emitter, "enableCameraByTouch", {
+      get() {
+        return that.camera.enableByTouch;
+      },
+      set(value) {
+        that.camera.enableByTouch = value;
+      }
+    });
+    Object.defineProperty(this.emitter, "cameraBoundaryColor", {
+      get() {
+        return that.camera.boundaryColor;
+      },
+      set(value) {
+        that.camera.boundaryColor = value;
+      }
+    });
+    Object.defineProperty(this.emitter, "enableCameraBoundaryHighlight", {
+      get() {
+        return that.camera.enableBoundaryHighlight;
+      },
+      set(value) {
+        that.camera.enableBoundaryHighlight = value;
+      }
+    });
   }
   userMap(userId) {
     return this.getMap(`user/${userId}`);
@@ -30229,7 +30403,12 @@ var WhiteboardApplication = class extends AbstractApplication {
     );
     this.pageModel.on("pagesChange", this.handleLayersChange);
     this.pageModel.on("switchPage", this.handlePageSwitch);
+    if (option.maxScaleRatio && option.maxScaleRatio < 1 && option.maxScaleRatio !== -1) {
+      throw new Error(`[@netless/forge-whiteboard] invalid maxScaleRatio ${option.maxScaleRatio}`);
+    }
     this.camera = new Camera(
+      new this.paperScope.Size(option.width, option.height),
+      option.maxScaleRatio ?? -1,
       this.rootElement,
       this.userManager,
       this.paperScope,