@galacean/effects-specification 2.6.0-alpha.2 → 2.7.0-alpha.0

package/es/assets.d.ts

@@ -80,10 +80,7 @@ export interface TemplateImage extends Image {
  */
 export interface CompressedImage extends Image {
     /**
-     * 压缩贴图地址
+     * KTX2 地址
      */
-    compressed: {
-        astc?: string;
-        pvrtc?: string;
-    };
+    ktx2?: string;
 }

package/es/index.d.ts

@@ -41,4 +41,4 @@ export * from './material-data';
 export * from './geometry-data';
 export * from './shader-data';
 export * from './effects-package-data';
-export declare const LATEST_VERSION = JSONSceneVersion['3_5'];
+export declare const LATEST_VERSION = JSONSceneVersion['3_6'];

package/es/item/rich-text-item.d.ts

@@ -2,6 +2,7 @@ import type { BaseItem, EndBehavior, MaskOptions } from './base-item';
 import type { ItemType } from '../type';
 import type { BaseTextContentOptions, TextComponentData, TextContent } from './text-item';
 import type { vec2 } from '../number-expression';
+import type { TextSizeMode } from '../text';
 /**
  * 富文本元素
  */
@@ -24,6 +25,25 @@ export interface RichTextContentOptions extends BaseTextContentOptions {
      * 富文本元素大小
      */
     size?: vec2;
+    /**
+     * 文本框宽度，用来排版和控制文本溢出行为
+     */
+    maxTextWidth?: number;
+    /**
+     * 文本框高度，用来排版和控制文本溢出行为
+     * @default undefined
+     */
+    maxTextHeight?: number;
+    /**
+     * 是否开启自动换行
+     * @default false
+     */
+    wrapEnabled?: boolean;
+    /**
+     * 尺寸模式
+     * @default TextSizeMode.autoWidth
+     */
+    sizeMode?: TextSizeMode;
 }
 /**
  * 富文本元素渲染属性

package/es/item/sprite-item.d.ts

@@ -25,6 +25,7 @@ export interface SpriteContentOptions {
 }
 /**
  * 图层元素渲染属性
+ * @deprecated Please use SpriteComponentData instead
  */
 export interface SpriteContent {
     /**
@@ -78,4 +79,8 @@ export interface SpriteContent {
  * 图层组件属性
  */
 export interface SpriteComponentData extends ComponentData, SpriteContent {
+    /**
+     * 图层帧动画是否循环播放
+     */
+    loop?: boolean;
 }

package/es/item/text-item.d.ts

@@ -1,7 +1,7 @@
 import type { BaseItem, EndBehavior, MaskOptions } from './base-item';
 import type { SizeOverLifetime, RotationOverLifetime, PositionOverLifetime, ColorOverLifetime, ItemType, TextureSheetAnimation, RendererOptions, InteractBehavior } from '../type';
 import type { RGBAColorValue } from '../number-expression';
-import type { FontStyle, TextAlignment, TextBaseline, TextOverflow, TextWeight } from '../text';
+import type { FontStyle, TextAlignment, TextBaseline, TextOverflow, TextWeight, TextVerticalAlign } from '../text';
 import type { ComponentData } from '../components';
 /**
  * 文本元素
@@ -23,11 +23,6 @@ export interface TextContentOptions extends BaseTextContentOptions {
      * @default 31
      */
     textWidth?: number;
-    /**
-     * 文本行高
-     * @default 31
-     */
-    lineHeight?: number;
     /**
      * 文本高度
      * @default 31
@@ -38,6 +33,11 @@ export interface TextContentOptions extends BaseTextContentOptions {
      * @default false
      */
     autoWidth?: boolean;
+    /**
+     * 自适应宽高开关（和文本固定高度冲突）
+     * @default false
+     */
+    autoHeight?: boolean;
 }
 export interface BaseTextContentOptions {
     /**
@@ -50,6 +50,11 @@ export interface BaseTextContentOptions {
      * @default 0.571
      */
     lineGap?: number;
+    /**
+     * 文本行高
+     * @default 31
+     */
+    lineHeight?: number;
     /**
      * 文本内容
      */
@@ -74,6 +79,11 @@ export interface BaseTextContentOptions {
      * @default TextBaseline.middle
      */
     textBaseline?: TextBaseline;
+    /**
+     * 垂直对齐方式
+     * @default TextVerticalAlign.middle
+     */
+    textVerticalAlign?: TextVerticalAlign;
     /**
      * 左右对齐方式
      * @default TextAlignment.left

package/es/scene.d.ts

@@ -34,7 +34,8 @@ export declare enum JSONSceneVersion {
     '3_3' = "3.3",// 指向型蒙版、图片/文字蒙版
     '3_4' = "3.4",// 动画状态机
     '3_5' = "3.5",// 网格形状变化动画、矢量图形填充/描边渐变色
-    'LATEST' = "3.5"
+    '3_6' = "3.6",// KTX2 纹理支持、文本增强
+    'LATEST' = "3.6"
 }
 /**
  * runtime 2.0 之前的场景信息

package/es/scene.js

@@ -20,5 +20,6 @@ export var JSONSceneVersion;
     JSONSceneVersion["3_3"] = "3.3";
     JSONSceneVersion["3_4"] = "3.4";
     JSONSceneVersion["3_5"] = "3.5";
-    JSONSceneVersion["LATEST"] = "3.5";
+    JSONSceneVersion["3_6"] = "3.6";
+    JSONSceneVersion["LATEST"] = "3.6";
 })(JSONSceneVersion || (JSONSceneVersion = {}));

package/es/shape/shape-component-data.d.ts

@@ -1,4 +1,4 @@
-import type { RenderMode, SideMode, BlendingMode } from '../type';
+import type { SideMode, BlendingMode } from '../type';
 import type { ComponentData, DataPath } from '../components/component-data';
 import type { MaskOptions } from '../item/base-item';
 import type { ShapePrimitiveType } from './shape-primitive-type';
@@ -35,7 +35,6 @@ export interface ShapeComponentData extends ComponentData {
     renderer?: ShapeRendererOptions;
 }
 export interface ShapeRendererOptions {
-    renderMode?: RenderMode;
     side?: SideMode;
     occlusion?: boolean;
     transparentOcclusion?: boolean;
@@ -77,8 +76,14 @@ export interface TexturePaintData {
     texture: DataPath;
     scaleMode: TexturePaintScaleMode;
     scalingFactor?: number;
+    textureTransform?: TextureTransformData;
     opacity?: number;
 }
+export interface TextureTransformData {
+    offset?: Vector2Data;
+    rotation?: number;
+    scale?: Vector2Data;
+}
 export declare enum TexturePaintScaleMode {
     Fill = 0,
     Fit = 1,

package/es/text.d.ts

@@ -52,17 +52,35 @@ export interface FontBase {
 }
 export declare enum TextOverflow {
     /**
-     * display 模式下，会显示所有文本，文本大小会根据边界框调整。
+     * visible 模式下，文本内容超出边界框时，会继续显示内容，不进行裁剪或缩放。
      */
-    display = 0,
+    visible = 0,
+    /**
+     * display 模式下，会显示所有文本，文本字号大小会根据边界框调整。
+     */
+    display = 1,
     /**
      * clip 模式下，当文本内容超出边界框时，多余的会被截断。
      */
-    clip = 1,
+    clip = 2,
     /**
      * ellipsis 模式下，会使用（...）来代替超出边界框的内容。
      */
-    ellipsis = 2
+    ellipsis = 3
+}
+export declare enum TextSizeMode {
+    /**
+     * 自适应宽度
+     */
+    autoWidth = 0,
+    /**
+     * 自适应高度
+     */
+    autoHeight = 1,
+    /**
+     * 固定宽高
+     */
+    fixed = 2
 }
 export declare enum TextBaseline {
     /**
@@ -95,6 +113,20 @@ export declare enum TextAlignment {
      */
     right = 2
 }
+export declare enum TextVerticalAlign {
+    /**
+     * 文本顶对齐。
+     */
+    top = 0,
+    /**
+     * 文本垂直居中对齐。
+     */
+    middle = 1,
+    /**
+     * 文本底对齐。
+     */
+    bottom = 2
+}
 /**
  * 文本字重
  */

package/es/text.js

@@ -1,18 +1,37 @@
 export var TextOverflow;
 (function (TextOverflow) {
     /**
-     * display 模式下，会显示所有文本，文本大小会根据边界框调整。
+     * visible 模式下，文本内容超出边界框时，会继续显示内容，不进行裁剪或缩放。
      */
-    TextOverflow[TextOverflow["display"] = 0] = "display";
+    TextOverflow[TextOverflow["visible"] = 0] = "visible";
+    /**
+     * display 模式下，会显示所有文本，文本字号大小会根据边界框调整。
+     */
+    TextOverflow[TextOverflow["display"] = 1] = "display";
     /**
      * clip 模式下，当文本内容超出边界框时，多余的会被截断。
      */
-    TextOverflow[TextOverflow["clip"] = 1] = "clip";
+    TextOverflow[TextOverflow["clip"] = 2] = "clip";
     /**
      * ellipsis 模式下，会使用（...）来代替超出边界框的内容。
      */
-    TextOverflow[TextOverflow["ellipsis"] = 2] = "ellipsis";
+    TextOverflow[TextOverflow["ellipsis"] = 3] = "ellipsis";
 })(TextOverflow || (TextOverflow = {}));
+export var TextSizeMode;
+(function (TextSizeMode) {
+    /**
+     * 自适应宽度
+     */
+    TextSizeMode[TextSizeMode["autoWidth"] = 0] = "autoWidth";
+    /**
+     * 自适应高度
+     */
+    TextSizeMode[TextSizeMode["autoHeight"] = 1] = "autoHeight";
+    /**
+     * 固定宽高
+     */
+    TextSizeMode[TextSizeMode["fixed"] = 2] = "fixed";
+})(TextSizeMode || (TextSizeMode = {}));
 export var TextBaseline;
 (function (TextBaseline) {
     /**
@@ -46,6 +65,21 @@ export var TextAlignment;
      */
     TextAlignment[TextAlignment["right"] = 2] = "right";
 })(TextAlignment || (TextAlignment = {}));
+export var TextVerticalAlign;
+(function (TextVerticalAlign) {
+    /**
+     * 文本顶对齐。
+     */
+    TextVerticalAlign[TextVerticalAlign["top"] = 0] = "top";
+    /**
+     * 文本垂直居中对齐。
+     */
+    TextVerticalAlign[TextVerticalAlign["middle"] = 1] = "middle";
+    /**
+     * 文本底对齐。
+     */
+    TextVerticalAlign[TextVerticalAlign["bottom"] = 2] = "bottom";
+})(TextVerticalAlign || (TextVerticalAlign = {}));
 /**
  * 文本字重
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/effects-specification",
-  "version": "2.6.0-alpha.2",
+  "version": "2.7.0-alpha.0",
   "description": "Galacean Effects JSON Specification",
   "module": "./es/index.js",
   "main": "./es/index.js",