@vvfx/sdk 0.0.0-alpha.68 → 0.0.0-alpha.69

package/dist/index.d.cts

@@ -901,10 +901,20 @@ type PictureExpandGizmoConfig = {
      */
     directionScaleInteractionDistance: number;
 };
+/**
+ * @description 文本交互控制器旋转交互模式
+ * 'corner': 角点旋转
+ * 'top-center': 顶部中心旋转
+ */
+type TextGizmoRotateInteractMode = 'corner' | 'top-center';
 /**
  * @description 文本交互控制器参数
  */
 type TextGizmoConfig = {
+    /**
+     * @description 旋转交互模式
+     */
+    rotateInteractMode: TextGizmoRotateInteractMode;
     /**
      * @description 包围盒线宽
      */
@@ -914,17 +924,41 @@ type TextGizmoConfig = {
      */
     boxLineColor: number;
     /**
-     * @description 缩放交互点半径
-     */
-    scaleCornerRadius: number;
-    /**
-     * @description 旋转交互点边长
+     * @description 旋转交互点边长 - 用于 top-center 交互模式
      */
     rotationCornerWidth: number;
     /**
      * @description 旋转交互贴图地址
      */
     rotationCornerTexture: string;
+    /**
+     * @description 旋转交互点半径
+     */
+    rotationCornerRadius: number;
+    /**
+     * @description top-center 模式旋转交互距离
+     */
+    rotationTopCenterInteractionDistance: number;
+    /**
+     * @description 旋转交互点填充色
+     */
+    rotationCornerFillColor: number;
+    /**
+     * @description 旋转交互点描边宽度
+     */
+    rotationCornerStrokeWidth: number;
+    /**
+     * @description 旋转交互点描边颜色
+     */
+    rotationCornerStrokeColor: number;
+    /**
+     * @description Corner 模式旋转交互距离
+     */
+    rotationCornerInteractionDistance: number;
+    /**
+     * @description 缩放交互点半径
+     */
+    scaleCornerRadius: number;
     /**
      * @description 缩放交互点填充色
      */
@@ -937,6 +971,10 @@ type TextGizmoConfig = {
      * @description 缩放交互点描边颜色
      */
     scaleCornerStrokeColor: number;
+    /**
+     * @description 出发缩放交互的距离
+     */
+    scaleInteractionDistance: number;
 };
 /**
  * @description 蒙版参数
@@ -1119,8 +1157,14 @@ declare class SDK {
     /**
      * @description 设置视图缩放
      * @param zoom 缩放值
+     * @param center 缩放中心
+     * @param ignoreClamp 是否忽视约束
      */
     setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
+    /**
+     * @description 设置元素移动
+     * @param targetTranslation 目标移动值
+     */
     setPageMove(targetTranslation: Vector2): void;
     /**
      * @description 设置静态预览功能开关
@@ -1255,11 +1299,35 @@ declare class SDK {
     getViewProperty(id: number): ViewProperty | undefined;
     pageMove(shift: [number, number]): void;
     pageZoom(shift: number, center?: [number, number]): void;
+    /**
+     * @description 设置视图缩放工具锁定缩放比例开关
+     * @param state 缩放比例开关
+     */
     setPictureCutGizmoLockScale(state: boolean): void;
+    /**
+     * @description 设置视图扩展工具锁定缩放比例开关
+     * @param state 缩放比例开关
+     */
     setPictureExpandGizmoLockScale(state: boolean): void;
+    /**
+     * @description 视图缩放函数
+     * @param shiftParam 视图偏移值
+     */
     viewportFit(shiftParam?: ViewportFitShiftParam): void;
+    /**
+     * @description 获取元素包围盒
+     * @param idInfo 元素Id
+     * @returns 元素包围盒
+     */
     getItemBoxById(idInfo: string): Box2;
+    /**
+     * @description 设置元素字体
+     * @param id 元素Id
+     * @param fontFamilyName 字体名称
+     * @param url 字体地址
+     */
     setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
+    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneInfo: SceneCreaetInfo): spec.JSONScene;
 }
 
 type SizeAdaptDirection = 'x' | 'y';
@@ -1736,6 +1804,19 @@ type TextCreateInfo = {
     url?: string;
 };
 type ItemCreateInfo = NullCreateInfo | SpriteCreateInfo | TextCreateInfo;
+/**
+ * @description 场景创建信息
+ */
+type SceneCreaetInfo = {
+    /**
+     * @description 场景名称
+     */
+    name: string;
+    /**
+     * @description 场景大小
+     */
+    size: spec.vec2;
+};
 declare enum ItemOrderAction {
     BringToFront = 0,
     SendToBack = 1,

package/dist/index.d.ts

@@ -901,10 +901,20 @@ type PictureExpandGizmoConfig = {
      */
     directionScaleInteractionDistance: number;
 };
+/**
+ * @description 文本交互控制器旋转交互模式
+ * 'corner': 角点旋转
+ * 'top-center': 顶部中心旋转
+ */
+type TextGizmoRotateInteractMode = 'corner' | 'top-center';
 /**
  * @description 文本交互控制器参数
  */
 type TextGizmoConfig = {
+    /**
+     * @description 旋转交互模式
+     */
+    rotateInteractMode: TextGizmoRotateInteractMode;
     /**
      * @description 包围盒线宽
      */
@@ -914,17 +924,41 @@ type TextGizmoConfig = {
      */
     boxLineColor: number;
     /**
-     * @description 缩放交互点半径
-     */
-    scaleCornerRadius: number;
-    /**
-     * @description 旋转交互点边长
+     * @description 旋转交互点边长 - 用于 top-center 交互模式
      */
     rotationCornerWidth: number;
     /**
      * @description 旋转交互贴图地址
      */
     rotationCornerTexture: string;
+    /**
+     * @description 旋转交互点半径
+     */
+    rotationCornerRadius: number;
+    /**
+     * @description top-center 模式旋转交互距离
+     */
+    rotationTopCenterInteractionDistance: number;
+    /**
+     * @description 旋转交互点填充色
+     */
+    rotationCornerFillColor: number;
+    /**
+     * @description 旋转交互点描边宽度
+     */
+    rotationCornerStrokeWidth: number;
+    /**
+     * @description 旋转交互点描边颜色
+     */
+    rotationCornerStrokeColor: number;
+    /**
+     * @description Corner 模式旋转交互距离
+     */
+    rotationCornerInteractionDistance: number;
+    /**
+     * @description 缩放交互点半径
+     */
+    scaleCornerRadius: number;
     /**
      * @description 缩放交互点填充色
      */
@@ -937,6 +971,10 @@ type TextGizmoConfig = {
      * @description 缩放交互点描边颜色
      */
     scaleCornerStrokeColor: number;
+    /**
+     * @description 出发缩放交互的距离
+     */
+    scaleInteractionDistance: number;
 };
 /**
  * @description 蒙版参数
@@ -1119,8 +1157,14 @@ declare class SDK {
     /**
      * @description 设置视图缩放
      * @param zoom 缩放值
+     * @param center 缩放中心
+     * @param ignoreClamp 是否忽视约束
      */
     setPageZoom(zoom: number, center?: Vector2, ignoreClamp?: boolean): void;
+    /**
+     * @description 设置元素移动
+     * @param targetTranslation 目标移动值
+     */
     setPageMove(targetTranslation: Vector2): void;
     /**
      * @description 设置静态预览功能开关
@@ -1255,11 +1299,35 @@ declare class SDK {
     getViewProperty(id: number): ViewProperty | undefined;
     pageMove(shift: [number, number]): void;
     pageZoom(shift: number, center?: [number, number]): void;
+    /**
+     * @description 设置视图缩放工具锁定缩放比例开关
+     * @param state 缩放比例开关
+     */
     setPictureCutGizmoLockScale(state: boolean): void;
+    /**
+     * @description 设置视图扩展工具锁定缩放比例开关
+     * @param state 缩放比例开关
+     */
     setPictureExpandGizmoLockScale(state: boolean): void;
+    /**
+     * @description 视图缩放函数
+     * @param shiftParam 视图偏移值
+     */
     viewportFit(shiftParam?: ViewportFitShiftParam): void;
+    /**
+     * @description 获取元素包围盒
+     * @param idInfo 元素Id
+     * @returns 元素包围盒
+     */
     getItemBoxById(idInfo: string): Box2;
+    /**
+     * @description 设置元素字体
+     * @param id 元素Id
+     * @param fontFamilyName 字体名称
+     * @param url 字体地址
+     */
     setItemFontFamily(id: string, fontFamilyName: string, url: string): Promise<void>;
+    createSceneByCreateInfos(createInfos: ItemCreateInfo[], sceneInfo: SceneCreaetInfo): spec.JSONScene;
 }
 
 type SizeAdaptDirection = 'x' | 'y';
@@ -1736,6 +1804,19 @@ type TextCreateInfo = {
     url?: string;
 };
 type ItemCreateInfo = NullCreateInfo | SpriteCreateInfo | TextCreateInfo;
+/**
+ * @description 场景创建信息
+ */
+type SceneCreaetInfo = {
+    /**
+     * @description 场景名称
+     */
+    name: string;
+    /**
+     * @description 场景大小
+     */
+    size: spec.vec2;
+};
 declare enum ItemOrderAction {
     BringToFront = 0,
     SendToBack = 1,