sapdon 3.1.0 → 3.2.0

package/dist/core/ui/properties/scrollView.js

@@ -1,145 +0,0 @@
-/**
- * ScrollView 类
- *
- * 该类表示一个滚动视图控件，用于管理滚动行为及其相关属性。
- *
- * 属性：
- * - scrollbar_track_button: string - 滚动条轨道按钮的 ID
- * - scrollbar_touch_button: string - 滚动条触摸按钮的 ID
- * - scroll_speed: number - 滚动速度
- * - gesture_control_enabled: boolean - 是否启用手势控制
- * - always_handle_scrolling: boolean - 是否始终处理滚动
- * - touch_mode: boolean - 是否启用触摸模式
- * - scrollbar_box: string - 滚动条滑块子元素的名称
- * - scrollbar_track: string - 滚动条轨道子元素的名称
- * - scroll_view_port: string - 视口子元素的名称
- * - scroll_content: string - 内容根父元素的名称
- * - scroll_box_and_track_panel: string - 包含滚动条滑块和轨道的子元素名称
- * - jump_to_bottom_on_update: boolean - 是否在更新时跳转到底部
- */
-export class ScrollView {
-    constructor() {
-        /*
-        this.scrollbar_track_button = '';
-        this.scrollbar_touch_button = '';
-        this.scroll_speed = null;
-        this.gesture_control_enabled = false;
-        this.always_handle_scrolling = false;
-        this.touch_mode = false;
-        this.scrollbar_box = '';
-        this.scrollbar_track = '';
-        this.scroll_view_port = '';
-        this.scroll_content = '';
-        this.scroll_box_and_track_panel = '';
-        this.jump_to_bottom_on_update = false;
-        */
-    }
-    /**
-     * 设置滚动条轨道按钮的 ID。
-     * @param {string} buttonId - 滚动条轨道按钮的 ID
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollbarTrackButton(buttonId) {
-        this.scrollbar_track_button = buttonId;
-        return this;
-    }
-    /**
-     * 设置滚动条触摸按钮的 ID。
-     * @param {string} buttonId - 滚动条触摸按钮的 ID
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollbarTouchButton(buttonId) {
-        this.scrollbar_touch_button = buttonId;
-        return this;
-    }
-    /**
-     * 设置滚动速度。
-     * @param {number} speed - 滚动速度
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollSpeed(speed) {
-        this.scroll_speed = speed;
-        return this;
-    }
-    /**
-     * 设置是否启用手势控制。
-     * @param {boolean} enabled - 是否启用手势控制（默认值：false）
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setGestureControlEnabled(enabled = false) {
-        this.gesture_control_enabled = enabled;
-        return this;
-    }
-    /**
-     * 设置是否始终处理滚动。
-     * @param {boolean} alwaysHandle - 是否始终处理滚动（默认值：false）
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setAlwaysHandleScrolling(alwaysHandle = false) {
-        this.always_handle_scrolling = alwaysHandle;
-        return this;
-    }
-    /**
-     * 设置是否启用触摸模式。
-     * @param {boolean} touchMode - 是否启用触摸模式（默认值：false）
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setTouchMode(touchMode = false) {
-        this.touch_mode = touchMode;
-        return this;
-    }
-    /**
-     * 设置滚动条滑块子元素的名称。
-     * @param {string} boxName - 滚动条滑块子元素的名称
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollbarBox(boxName) {
-        this.scrollbar_box = boxName;
-        return this;
-    }
-    /**
-     * 设置滚动条轨道子元素的名称。
-     * @param {string} trackName - 滚动条轨道子元素的名称
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollbarTrack(trackName) {
-        this.scrollbar_track = trackName;
-        return this;
-    }
-    /**
-     * 设置视口子元素的名称。
-     * @param {string} viewPortName - 视口子元素的名称
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollViewPort(viewPortName) {
-        this.scroll_view_port = viewPortName;
-        return this;
-    }
-    /**
-     * 设置内容根父元素的名称。
-     * @param {string} contentName - 内容根父元素的名称
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollContent(contentName) {
-        this.scroll_content = contentName;
-        return this;
-    }
-    /**
-     * 设置包含滚动条滑块和轨道的子元素名称。
-     * @param {string} panelName - 包含滚动条滑块和轨道的子元素名称
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setScrollBoxAndTrackPanel(panelName) {
-        this.scroll_box_and_track_panel = panelName;
-        return this;
-    }
-    /**
-     * 设置是否在更新时跳转到底部。
-     * @param {boolean} jump - 是否在更新时跳转到底部（默认值：false）
-     * @returns {ScrollView} 返回当前实例以支持链式调用
-     */
-    setJumpToBottomOnUpdate(jump = false) {
-        this.jump_to_bottom_on_update = jump;
-        return this;
-    }
-}

package/dist/core/ui/properties/sound.d.ts

@@ -1,47 +0,0 @@
-/**
- * Sound 类
- *
- * 该类表示一个声音控件，用于管理声音播放及其相关属性。
- *
- * 属性：
- * - sound_name: string - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
- * - sound_volume: float - 声音音量（默认值：1.0）
- * - sound_pitch: float - 声音音调（默认值：1.0）
- * - sounds: Array of sound objects - 触发事件时播放的声音数组
- */
-export class Sound {
-    /**
-     * 设置声音名称。
-     * @param {string} name - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSoundName(name: string): Sound;
-    sound_name: string | undefined;
-    /**
-     * 设置声音音量。
-     * @param {number} volume - 音量（范围：0.0 到 1.0，默认值：1.0）
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSoundVolume(volume?: number): Sound;
-    sound_volume: number | undefined;
-    /**
-     * 设置声音音调。
-     * @param {number} pitch - 音调（默认值：1.0）
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSoundPitch(pitch?: number): Sound;
-    sound_pitch: number | undefined;
-    /**
-     * 设置触发事件时播放的声音数组。
-     * @param {object[]} sounds - 声音对象数组
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSounds(sounds: object[]): Sound;
-    sounds: object[] | undefined;
-    /**
-     * 添加一个声音对象到声音数组。
-     * @param {object} sound - 声音对象
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    addSound(sound: object): Sound;
-}

package/dist/core/ui/properties/sound.js

@@ -1,66 +0,0 @@
-/**
- * Sound 类
- *
- * 该类表示一个声音控件，用于管理声音播放及其相关属性。
- *
- * 属性：
- * - sound_name: string - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
- * - sound_volume: float - 声音音量（默认值：1.0）
- * - sound_pitch: float - 声音音调（默认值：1.0）
- * - sounds: Array of sound objects - 触发事件时播放的声音数组
- */
-export class Sound {
-    constructor() {
-        /*
-        this.sound_name = '';
-        this.sound_volume = 1.0;
-        this.sound_pitch = 1.0;
-        this.sounds = [];
-        */
-    }
-    /**
-     * 设置声音名称。
-     * @param {string} name - 声音名称（定义在 RP/sounds/sound_definitions.json 文件中）
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSoundName(name) {
-        this.sound_name = name;
-        return this;
-    }
-    /**
-     * 设置声音音量。
-     * @param {number} volume - 音量（范围：0.0 到 1.0，默认值：1.0）
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSoundVolume(volume = 1.0) {
-        this.sound_volume = volume;
-        return this;
-    }
-    /**
-     * 设置声音音调。
-     * @param {number} pitch - 音调（默认值：1.0）
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSoundPitch(pitch = 1.0) {
-        this.sound_pitch = pitch;
-        return this;
-    }
-    /**
-     * 设置触发事件时播放的声音数组。
-     * @param {object[]} sounds - 声音对象数组
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    setSounds(sounds) {
-        this.sounds = sounds;
-        return this;
-    }
-    /**
-     * 添加一个声音对象到声音数组。
-     * @param {object} sound - 声音对象
-     * @returns {Sound} 返回当前实例以支持链式调用
-     */
-    addSound(sound) {
-        this.sounds.push(sound);
-        return this;
-    }
-}

package/dist/core/ui/properties/sprite.d.ts

@@ -1,161 +0,0 @@
-/**
- * Sprite 类
- *
- * 该类表示一个 Sprite 控件，用于管理图像纹理及其相关属性。
- *
- * 属性：
- * - texture: string - 图像路径（从包根目录开始，例如："textures/ui/White"）
- * - allow_debug_missing_texture: boolean - 是否在纹理未找到时显示缺失纹理（默认值：true）
- * - uv: Vector [u, v] - 纹理映射的起始位置
- * - uv_size: Vector [width, height] - 纹理映射的大小
- * - texture_file_system: string - 纹理来源（默认值：InUserPackage）
- * - nineslice_size: int or Vector [x0, y0, x1, y1] - 9-slice 分割大小
- * - tiled: boolean or enum - 是否平铺纹理（可能值：true/false, x, y）
- * - tiled_scale: Vector [sX, sY] - 平铺纹理的缩放比例（默认值：false）
- * - clip_direction: enum - 裁剪方向的起始点（可能值：left, right, up, down, center）
- * - clip_ratio: float - 裁剪比例（范围：0.0 到 1.0）
- * - clip_pixelperfect: boolean - 是否尽可能保持像素精确裁剪
- * - keep_ratio: boolean - 是否在调整大小时保持比例（默认值：true）
- * - bilinear: boolean - 是否在调整大小时使用双线性函数（默认值：false）
- * - fill: boolean - 是否拉伸图像以适应大小（默认值：false）
- * - $fit_to_width: boolean - 是否适应宽度
- * - zip_folder: string - 压缩文件夹路径
- * - grayscale: boolean - 是否以黑白渲染图像（默认值：false）
- * - force_texture_reload: boolean - 是否在纹理路径更改时强制重新加载图像
- * - base_size: Vector [width, height] - 基础大小
- */
-export class Sprite {
-    /**
-     * 设置图像纹理路径。
-     * @param {string} texture - 图像路径（例如："textures/ui/White"）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTexture(texture: string): Sprite;
-    texture: string | undefined;
-    /**
-     * 设置是否在纹理未找到时显示缺失纹理。
-     * @param {boolean} allow - 是否显示缺失纹理（默认值：true）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setAllowDebugMissingTexture(allow?: boolean): Sprite;
-    allow_debug_missing_texture: boolean | undefined;
-    /**
-     * 设置纹理映射的起始位置。
-     * @param {number[]} uv - 起始位置，格式为 [u, v]
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setUV(uv: number[]): Sprite;
-    uv: number[] | undefined;
-    /**
-     * 设置纹理映射的大小。
-     * @param {number[]} uvSize - 大小，格式为 [width, height]
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setUVSize(uvSize: number[]): Sprite;
-    uv_size: number[] | undefined;
-    /**
-     * 设置纹理来源。
-     * @param {string} source - 纹理来源（可能值：InUserPackage, InAppPackage, RawPath, RawPersistent, InSettingsDir, InExternalDir, InServerPackage, InDataDir, InUserDir, InWorldDir, StoreCache, Usage is Unknown）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTextureFileSystem(source?: string): Sprite;
-    texture_file_system: string | undefined;
-    /**
-     * 设置 9-slice 分割大小。
-     * @param {number|number[]} size - 9-slice 分割大小（可以是单个数字或 [x0, y0, x1, y1] 数组）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setNineSliceSize(size: number | number[]): Sprite;
-    nineslice_size: number | number[] | undefined;
-    /**
-     * 设置是否平铺纹理。
-     * @param {boolean|string} tiled - 是否平铺纹理（可能值：true/false, x, y）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTiled(tiled: boolean | string): Sprite;
-    tiled: string | boolean | undefined;
-    /**
-     * 设置平铺纹理的缩放比例。
-     * @param {number[]} scale - 缩放比例，格式为 [sX, sY]（默认值：[1, 1]）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTiledScale(scale?: number[]): Sprite;
-    tiled_scale: number[] | undefined;
-    /**
-     * 设置裁剪方向的起始点。
-     * @param {string} direction - 裁剪方向（可能值：left, right, up, down, center）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setClipDirection(direction: string): Sprite;
-    clip_direction: string | undefined;
-    /**
-     * 设置裁剪比例。
-     * @param {number} ratio - 裁剪比例（范围：0.0 到 1.0）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setClipRatio(ratio: number): Sprite;
-    clip_ratio: number | undefined;
-    /**
-     * 设置是否尽可能保持像素精确裁剪。
-     * @param {boolean} pixelPerfect - 是否保持像素精确裁剪
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setClipPixelPerfect(pixelPerfect?: boolean): Sprite;
-    clip_pixelperfect: boolean | undefined;
-    /**
-     * 设置是否在调整大小时保持比例。
-     * @param {boolean} keep - 是否保持比例（默认值：true）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setKeepRatio(keep?: boolean): Sprite;
-    keep_ratio: boolean | undefined;
-    /**
-     * 设置是否在调整大小时使用双线性函数。
-     * @param {boolean} bilinear - 是否使用双线性函数（默认值：false）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setBilinear(bilinear?: boolean): Sprite;
-    bilinear: boolean | undefined;
-    /**
-     * 设置是否拉伸图像以适应大小。
-     * @param {boolean} fill - 是否拉伸图像（默认值：false）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setFill(fill?: boolean): Sprite;
-    fill: boolean | undefined;
-    /**
-     * 设置是否适应宽度。
-     * @param {boolean} fit - 是否适应宽度
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setFitToWidth(fit?: boolean): Sprite;
-    $fit_to_width: boolean | undefined;
-    /**
-     * 设置压缩文件夹路径。
-     * @param {string} folder - 压缩文件夹路径
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setZipFolder(folder: string): Sprite;
-    zip_folder: string | undefined;
-    /**
-     * 设置是否以黑白渲染图像。
-     * @param {boolean} grayscale - 是否以黑白渲染图像（默认值：false）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setGrayscale(grayscale?: boolean): Sprite;
-    grayscale: boolean | undefined;
-    /**
-     * 设置是否在纹理路径更改时强制重新加载图像。
-     * @param {boolean} force - 是否强制重新加载图像
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setForceTextureReload(force?: boolean): Sprite;
-    force_texture_reload: boolean | undefined;
-    /**
-     * 设置基础大小。
-     * @param {number[]} size - 基础大小，格式为 [width, height]
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setBaseSize(size: number[]): Sprite;
-    base_size: number[] | undefined;
-}

package/dist/core/ui/properties/sprite.js

@@ -1,222 +0,0 @@
-/**
- * Sprite 类
- *
- * 该类表示一个 Sprite 控件，用于管理图像纹理及其相关属性。
- *
- * 属性：
- * - texture: string - 图像路径（从包根目录开始，例如："textures/ui/White"）
- * - allow_debug_missing_texture: boolean - 是否在纹理未找到时显示缺失纹理（默认值：true）
- * - uv: Vector [u, v] - 纹理映射的起始位置
- * - uv_size: Vector [width, height] - 纹理映射的大小
- * - texture_file_system: string - 纹理来源（默认值：InUserPackage）
- * - nineslice_size: int or Vector [x0, y0, x1, y1] - 9-slice 分割大小
- * - tiled: boolean or enum - 是否平铺纹理（可能值：true/false, x, y）
- * - tiled_scale: Vector [sX, sY] - 平铺纹理的缩放比例（默认值：false）
- * - clip_direction: enum - 裁剪方向的起始点（可能值：left, right, up, down, center）
- * - clip_ratio: float - 裁剪比例（范围：0.0 到 1.0）
- * - clip_pixelperfect: boolean - 是否尽可能保持像素精确裁剪
- * - keep_ratio: boolean - 是否在调整大小时保持比例（默认值：true）
- * - bilinear: boolean - 是否在调整大小时使用双线性函数（默认值：false）
- * - fill: boolean - 是否拉伸图像以适应大小（默认值：false）
- * - $fit_to_width: boolean - 是否适应宽度
- * - zip_folder: string - 压缩文件夹路径
- * - grayscale: boolean - 是否以黑白渲染图像（默认值：false）
- * - force_texture_reload: boolean - 是否在纹理路径更改时强制重新加载图像
- * - base_size: Vector [width, height] - 基础大小
- */
-export class Sprite {
-    constructor() {
-        /*
-        this.texture = '';
-        this.allow_debug_missing_texture = true;
-        this.uv = null;
-        this.uv_size = null;
-        this.texture_file_system = 'InUserPackage';
-        this.nineslice_size = null;
-        this.tiled = false;
-        this.tiled_scale = [1, 1];
-        this.clip_direction = null;
-        this.clip_ratio = null;
-        this.clip_pixelperfect = false;
-        this.keep_ratio = true;
-        this.bilinear = false;
-        this.fill = false;
-        this.$fit_to_width = false;
-        this.zip_folder = '';
-        this.grayscale = false;
-        this.force_texture_reload = false;
-        this.base_size = null;
-        */
-    }
-    /**
-     * 设置图像纹理路径。
-     * @param {string} texture - 图像路径（例如："textures/ui/White"）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTexture(texture) {
-        this.texture = texture;
-        return this;
-    }
-    /**
-     * 设置是否在纹理未找到时显示缺失纹理。
-     * @param {boolean} allow - 是否显示缺失纹理（默认值：true）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setAllowDebugMissingTexture(allow = true) {
-        this.allow_debug_missing_texture = allow;
-        return this;
-    }
-    /**
-     * 设置纹理映射的起始位置。
-     * @param {number[]} uv - 起始位置，格式为 [u, v]
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setUV(uv) {
-        this.uv = uv;
-        return this;
-    }
-    /**
-     * 设置纹理映射的大小。
-     * @param {number[]} uvSize - 大小，格式为 [width, height]
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setUVSize(uvSize) {
-        this.uv_size = uvSize;
-        return this;
-    }
-    /**
-     * 设置纹理来源。
-     * @param {string} source - 纹理来源（可能值：InUserPackage, InAppPackage, RawPath, RawPersistent, InSettingsDir, InExternalDir, InServerPackage, InDataDir, InUserDir, InWorldDir, StoreCache, Usage is Unknown）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTextureFileSystem(source = 'InUserPackage') {
-        this.texture_file_system = source;
-        return this;
-    }
-    /**
-     * 设置 9-slice 分割大小。
-     * @param {number|number[]} size - 9-slice 分割大小（可以是单个数字或 [x0, y0, x1, y1] 数组）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setNineSliceSize(size) {
-        this.nineslice_size = size;
-        return this;
-    }
-    /**
-     * 设置是否平铺纹理。
-     * @param {boolean|string} tiled - 是否平铺纹理（可能值：true/false, x, y）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTiled(tiled) {
-        this.tiled = tiled;
-        return this;
-    }
-    /**
-     * 设置平铺纹理的缩放比例。
-     * @param {number[]} scale - 缩放比例，格式为 [sX, sY]（默认值：[1, 1]）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setTiledScale(scale = [1, 1]) {
-        this.tiled_scale = scale;
-        return this;
-    }
-    /**
-     * 设置裁剪方向的起始点。
-     * @param {string} direction - 裁剪方向（可能值：left, right, up, down, center）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setClipDirection(direction) {
-        this.clip_direction = direction;
-        return this;
-    }
-    /**
-     * 设置裁剪比例。
-     * @param {number} ratio - 裁剪比例（范围：0.0 到 1.0）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setClipRatio(ratio) {
-        this.clip_ratio = ratio;
-        return this;
-    }
-    /**
-     * 设置是否尽可能保持像素精确裁剪。
-     * @param {boolean} pixelPerfect - 是否保持像素精确裁剪
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setClipPixelPerfect(pixelPerfect = false) {
-        this.clip_pixelperfect = pixelPerfect;
-        return this;
-    }
-    /**
-     * 设置是否在调整大小时保持比例。
-     * @param {boolean} keep - 是否保持比例（默认值：true）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setKeepRatio(keep = true) {
-        this.keep_ratio = keep;
-        return this;
-    }
-    /**
-     * 设置是否在调整大小时使用双线性函数。
-     * @param {boolean} bilinear - 是否使用双线性函数（默认值：false）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setBilinear(bilinear = false) {
-        this.bilinear = bilinear;
-        return this;
-    }
-    /**
-     * 设置是否拉伸图像以适应大小。
-     * @param {boolean} fill - 是否拉伸图像（默认值：false）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setFill(fill = false) {
-        this.fill = fill;
-        return this;
-    }
-    /**
-     * 设置是否适应宽度。
-     * @param {boolean} fit - 是否适应宽度
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setFitToWidth(fit = false) {
-        this.$fit_to_width = fit;
-        return this;
-    }
-    /**
-     * 设置压缩文件夹路径。
-     * @param {string} folder - 压缩文件夹路径
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setZipFolder(folder) {
-        this.zip_folder = folder;
-        return this;
-    }
-    /**
-     * 设置是否以黑白渲染图像。
-     * @param {boolean} grayscale - 是否以黑白渲染图像（默认值：false）
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setGrayscale(grayscale = false) {
-        this.grayscale = grayscale;
-        return this;
-    }
-    /**
-     * 设置是否在纹理路径更改时强制重新加载图像。
-     * @param {boolean} force - 是否强制重新加载图像
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setForceTextureReload(force = false) {
-        this.force_texture_reload = force;
-        return this;
-    }
-    /**
-     * 设置基础大小。
-     * @param {number[]} size - 基础大小，格式为 [width, height]
-     * @returns {Sprite} 返回当前实例以支持链式调用
-     */
-    setBaseSize(size) {
-        this.base_size = size;
-        return this;
-    }
-}