Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

fix(assets): the 9-slice border actually reaches the renderer

yhh52bd0728ce43
diff --git a/desktop/src/project/ProjectStore.ts b/desktop/src/project/ProjectStore.ts
index af6dd5a7b..186fa4ad8 100644
--- a/desktop/src/project/ProjectStore.ts
+++ b/desktop/src/project/ProjectStore.ts
@@ -1,8 +1,8 @@
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
import { createStore } from 'zustand/vanilla';
-import { getComponent, getEditorType, Assets, migratePrefabData, extractPrefab, flattenPrefab, collectExternalEntityRefs, collapseInstance, applyDeltaToSource, buildVariant, validateOverrides, setTextureParams, TextureFilter, TextureWrap, Renderer, RETIRED_COMPONENT_TYPES, parseThemeOverrides, resolveAssetGroup, folderGroupMode, withFolderGroup, folderAlwaysInclude, withFolderAlwaysInclude, withActiveRemoteRoot } from 'esengine';
-import { readTextureImportSettings, importerDefaults, applyImporterEdit } from './assetImporter';
+import { getComponent, getEditorType, Assets, migratePrefabData, extractPrefab, flattenPrefab, collectExternalEntityRefs, collapseInstance, applyDeltaToSource, buildVariant, validateOverrides, setTextureParams, setTextureSliceBorder, textureImportSettingsFrom, TextureFilter, TextureWrap, Renderer, RETIRED_COMPONENT_TYPES, parseThemeOverrides, resolveAssetGroup, folderGroupMode, withFolderGroup, folderAlwaysInclude, withFolderAlwaysInclude, withActiveRemoteRoot } from 'esengine';
+import { importerDefaults, applyImporterEdit } from './assetImporter';
import type { SceneData, PrefabData, ExtractEntity, ProcessedEntity, PhysicsPluginConfig, AudioProjectConfig, AssetsData, ThemeOverrides, StaleOverride, PrefabOverride, AddressableManifest, AssetGroupsConfig, AssetGroupMode } from 'esengine';
import { EngineHost } from '@/engine/EngineHost';
import { applyWidgetTheme } from '@/engine/widgetTheme';
@@ -752,9 +752,9 @@ class ProjectStoreImpl {
/** The texture filter/wrap for a ref (`@uuid:` or path), from its `.meta`
* importer — the shape `Assets`'s TextureLoader consumes. Undefined ⇒ defaults. */
- private textureImportFor(ref: string): ReturnType<typeof readTextureImportSettings> {
+ private textureImportFor(ref: string): ReturnType<typeof textureImportSettingsFrom> {
const uuid = refUuid(ref) ?? this.pathToUuid.get(ref);
- return readTextureImportSettings(uuid ? this.uuidToImporter.get(uuid) : undefined);
+ return textureImportSettingsFrom(uuid ? this.uuidToImporter.get(uuid) : undefined);
}
/** Push a texture's just-saved import settings to its LIVE gl handle so the edit
@@ -763,13 +763,19 @@ class ProjectStoreImpl {
* after the asset inspector writes the `.meta` + refreshAssets. */
applyLiveTextureSettings(path: string): void {
const uuid = this.pathToUuid.get(path);
- const s = readTextureImportSettings(uuid ? this.uuidToImporter.get(uuid) : undefined);
+ const s = textureImportSettingsFrom(uuid ? this.uuidToImporter.get(uuid) : undefined);
const handle = uuid ? EngineHost.getResource(Assets)?.getTexture(UUID_PREFIX + uuid)?.handle : undefined;
if (!s || !handle) return;
const filter = s.filter === 'nearest' ? TextureFilter.Nearest : TextureFilter.Linear;
const wrap =
s.wrap === 'clamp' ? TextureWrap.ClampToEdge : s.wrap === 'mirror' ? TextureWrap.MirroredRepeat : TextureWrap.Repeat;
setTextureParams(handle, filter, filter, wrap, wrap);
+ // The 9-slice border is applied at load; re-stamp it so dragging a border in
+ // the asset inspector re-slices the live viewport without a scene reload.
+ if (s.sliceBorder) {
+ const b = s.sliceBorder;
+ setTextureSliceBorder(handle, b.left, b.right, b.top, b.bottom);
+ }
}
/**
diff --git a/desktop/src/project/assetImporter.ts b/desktop/src/project/assetImporter.ts
index adb5386eb..c5f666678 100644
--- a/desktop/src/project/assetImporter.ts
+++ b/desktop/src/project/assetImporter.ts
@@ -234,18 +234,12 @@ export function readTextureCookSettings(importer: Record<string, unknown> | unde
return resolved;
}
-/** A texture's sampler settings, in the string shape the engine's TextureLoader
- * and the runtime importer-resolver consume (filterMode/wrapMode → filter/wrap).
- * Undefined when the `.meta` carries neither ⇒ loader defaults. */
-export function readTextureImportSettings(
- importer: Record<string, unknown> | undefined,
-): { filter?: 'linear' | 'nearest'; wrap?: 'repeat' | 'clamp' | 'mirror'; srgb?: boolean } | undefined {
- if (!importer) return undefined;
- const filter = importer.filterMode as 'linear' | 'nearest' | undefined;
- const wrap = importer.wrapMode as 'repeat' | 'clamp' | 'mirror' | undefined;
- const srgb = typeof importer.sRGB === 'boolean' ? importer.sRGB : undefined;
- return filter || wrap || srgb !== undefined ? { filter, wrap, srgb } : undefined;
-}
+// A texture's LOAD-time settings (sampler + 9-slice border) are parsed by the
+// SDK's `textureImportSettingsFrom`, not here: the editor and a shipped build
+// read the same `.meta` importer block, and a second reader is how "works in
+// the editor, not in the build" gets born. This module stays engine-free (the
+// Electron main process imports it for the cook), which is why the parser lives
+// on the SDK side rather than the other way round.
/** Apply one inspector edit to a copy of the `importer` block (dotted keys →
* nested), returning the new block. Pure — the caller owns dirty/save. */
diff --git a/desktop/tests/asset-importer.test.ts b/desktop/tests/asset-importer.test.ts
index 55ff522de..e03ec24ed 100644
--- a/desktop/tests/asset-importer.test.ts
+++ b/desktop/tests/asset-importer.test.ts
@@ -13,7 +13,6 @@ import {
buildImporterComponent,
applyImporterEdit,
hasImporterSettings,
- readTextureImportSettings,
readTextureCookSettings,
} from '../src/project/assetImporter';
@@ -91,18 +90,6 @@ describe('buildImporterComponent (inspector fields)', () => {
});
});
-describe('readTextureImportSettings (edit-viewport = runtime)', () => {
- it('maps filterMode/wrapMode to the loader filter/wrap shape', () => {
- expect(readTextureImportSettings({ filterMode: 'nearest', wrapMode: 'clamp' })).toEqual({ filter: 'nearest', wrap: 'clamp' });
- expect(readTextureImportSettings({ filterMode: 'linear' })).toEqual({ filter: 'linear', wrap: undefined });
- });
- it('is undefined when neither is present (loader defaults) or no importer', () => {
- expect(readTextureImportSettings({ maxSize: 2048 })).toBeUndefined();
- expect(readTextureImportSettings(undefined)).toBeUndefined();
- expect(readTextureImportSettings({})).toBeUndefined();
- });
-});
-
describe('applyImporterEdit (dotted keys → nested, pure)', () => {
it('sets a nested key without mutating the input', () => {
const before = { filterMode: 'linear', sliceBorder: { left: 0, right: 0 } };
diff --git a/sdk/etc/index.api.md b/sdk/etc/index.api.md
index 11000b454..28cd1ca23 100644
--- a/sdk/etc/index.api.md
+++ b/sdk/etc/index.api.md
@@ -1,7 +1,7 @@
# API surface — esengine/index
<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->
-Symbols: 1366 stable · 17 beta · 1 deprecated
+Symbols: 1369 stable · 17 beta · 1 deprecated
## ABI_LAYOUT_HASH — const
```
@@ -4324,6 +4324,14 @@ BuiltinComponentDef<ParentData>
entity: number
```
+## ParsedTextureImportSettings — interface
+```
+filter: "linear" | "nearest" | undefined
+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
+srgb: boolean | undefined
+wrap: "repeat" | "clamp" | "mirror" | undefined
+```
+
## Particle — const
```
ResourceDef<ParticleAPI>
@@ -10127,6 +10135,11 @@ Plugin
(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void
```
+## setTextureSliceBorder — function
+```
+(textureId: number, left: number, right: number, top: number, bottom: number): void
+```
+
## setTextureWrap — function
```
(textureId: number, wrap: TextureWrap): void
@@ -10252,6 +10265,11 @@ TextInputPlugin
TextPlugin
```
+## textureImportSettingsFrom — function
+```
+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined
+```
+
## themeButtonStates — function
```
(): Record<string, ButtonStateVisual>
diff --git a/sdk/etc/index.native.api.md b/sdk/etc/index.native.api.md
index 4a8afb2ea..c1beaf04b 100644
--- a/sdk/etc/index.native.api.md
+++ b/sdk/etc/index.native.api.md
@@ -1,7 +1,7 @@
# API surface — esengine/index.native
<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->
-Symbols: 1385 stable · 22 beta · 1 deprecated
+Symbols: 1388 stable · 22 beta · 1 deprecated
## ABI_LAYOUT_HASH — const
```
@@ -4478,6 +4478,14 @@ BuiltinComponentDef<ParentData>
entity: number
```
+## ParsedTextureImportSettings — interface
+```
+filter: "linear" | "nearest" | undefined
+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
+srgb: boolean | undefined
+wrap: "repeat" | "clamp" | "mirror" | undefined
+```
+
## Particle — const
```
ResourceDef<ParticleAPI>
@@ -10341,6 +10349,11 @@ Plugin
(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void
```
+## setTextureSliceBorder — function
+```
+(textureId: number, left: number, right: number, top: number, bottom: number): void
+```
+
## setTextureWrap — function
```
(textureId: number, wrap: TextureWrap): void
@@ -10466,6 +10479,11 @@ TextInputPlugin
TextPlugin
```
+## textureImportSettingsFrom — function
+```
+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined
+```
+
## themeButtonStates — function
```
(): Record<string, ButtonStateVisual>
diff --git a/sdk/etc/index.node.api.md b/sdk/etc/index.node.api.md
index bb34e28b3..ed5f07567 100644
--- a/sdk/etc/index.node.api.md
+++ b/sdk/etc/index.node.api.md
@@ -1,7 +1,7 @@
# API surface — esengine/index.node
<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->
-Symbols: 1365 stable · 19 beta · 1 deprecated
+Symbols: 1368 stable · 19 beta · 1 deprecated
## ANCHOR_AXES — const
```
@@ -4319,6 +4319,14 @@ BuiltinComponentDef<ParentData>
entity: number
```
+## ParsedTextureImportSettings — interface
+```
+filter: "linear" | "nearest" | undefined
+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
+srgb: boolean | undefined
+wrap: "repeat" | "clamp" | "mirror" | undefined
+```
+
## Particle — const
```
ResourceDef<ParticleAPI>
@@ -10132,6 +10140,11 @@ Plugin
(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void
```
+## setTextureSliceBorder — function
+```
+(textureId: number, left: number, right: number, top: number, bottom: number): void
+```
+
## setTextureWrap — function
```
(textureId: number, wrap: TextureWrap): void
@@ -10257,6 +10270,11 @@ TextInputPlugin
TextPlugin
```
+## textureImportSettingsFrom — function
+```
+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined
+```
+
## themeButtonStates — function
```
(): Record<string, ButtonStateVisual>
diff --git a/sdk/etc/minigame.api.md b/sdk/etc/minigame.api.md
index 5bd35132c..e524ef8e8 100644
--- a/sdk/etc/minigame.api.md
+++ b/sdk/etc/minigame.api.md
@@ -1,7 +1,7 @@
# API surface — esengine/minigame
<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->
-Symbols: 1386 stable · 17 beta · 1 deprecated
+Symbols: 1389 stable · 17 beta · 1 deprecated
## ANCHOR_AXES — const
```
@@ -4534,6 +4534,14 @@ BuiltinComponentDef<ParentData>
entity: number
```
+## ParsedTextureImportSettings — interface
+```
+filter: "linear" | "nearest" | undefined
+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
+srgb: boolean | undefined
+wrap: "repeat" | "clamp" | "mirror" | undefined
+```
+
## Particle — const
```
ResourceDef<ParticleAPI>
@@ -10352,6 +10360,11 @@ Plugin
(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void
```
+## setTextureSliceBorder — function
+```
+(textureId: number, left: number, right: number, top: number, bottom: number): void
+```
+
## setTextureWrap — function
```
(textureId: number, wrap: TextureWrap): void
@@ -10477,6 +10490,11 @@ TextInputPlugin
TextPlugin
```
+## textureImportSettingsFrom — function
+```
+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined
+```
+
## themeButtonStates — function
```
(): Record<string, ButtonStateVisual>
diff --git a/sdk/etc/wechat.api.md b/sdk/etc/wechat.api.md
index a49203dc7..833cccbd4 100644
--- a/sdk/etc/wechat.api.md
+++ b/sdk/etc/wechat.api.md
@@ -1,7 +1,7 @@
# API surface — esengine/wechat
<!-- Generated by tools/api-surface.mjs — do not edit. Run --update to accept changes. -->
-Symbols: 1376 stable · 17 beta · 1 deprecated
+Symbols: 1379 stable · 17 beta · 1 deprecated
## ANCHOR_AXES — const
```
@@ -4326,6 +4326,14 @@ BuiltinComponentDef<ParentData>
entity: number
```
+## ParsedTextureImportSettings — interface
+```
+filter: "linear" | "nearest" | undefined
+sliceBorder: { left: number; right: number; top: number; bottom: number; } | undefined
+srgb: boolean | undefined
+wrap: "repeat" | "clamp" | "mirror" | undefined
+```
+
## Particle — const
```
ResourceDef<ParticleAPI>
@@ -10151,6 +10159,11 @@ Plugin
(textureId: number, minFilter: TextureFilter, magFilter: TextureFilter, wrapS: TextureWrap, wrapT: TextureWrap): void
```
+## setTextureSliceBorder — function
+```
+(textureId: number, left: number, right: number, top: number, bottom: number): void
+```
+
## setTextureWrap — function
```
(textureId: number, wrap: TextureWrap): void
@@ -10276,6 +10289,11 @@ TextInputPlugin
TextPlugin
```
+## textureImportSettingsFrom — function
+```
+(importer: Record<string, unknown> | undefined | null): ParsedTextureImportSettings | undefined
+```
+
## themeButtonStates — function
```
(): Record<string, ButtonStateVisual>
diff --git a/sdk/src/asset/Assets.ts b/sdk/src/asset/Assets.ts
index 774e5641d..8b2b5361a 100644
--- a/sdk/src/asset/Assets.ts
+++ b/sdk/src/asset/Assets.ts
@@ -40,6 +40,7 @@ import type { SceneData } from '../scene';
import { SceneHandle, type ReleaseCallback } from './SceneHandle';
import type { AssetRegistry } from './AssetRegistry';
import { UUID_REF_PREFIX } from './AssetRegistry';
+import { textureImportSettingsFrom } from './textureImportSettings';
import type { AssetRefCounter } from './AssetRefCounter';
import { log } from '../logger';
@@ -295,6 +296,15 @@ export class Assets {
});
this.textureRefCounts_.set(cacheKey, (this.textureRefCounts_.get(cacheKey) ?? 0) + 1);
this.recordHandlePath_('texture', result.handle, path);
+ // The 9-slice border belongs to the IMAGE, so it rides its import
+ // settings and is stamped onto the handle here — the one place every
+ // creation path (decode, revive, external, cooked) funnels through, and
+ // where the settings are already resolved. Without this a UIVisual set
+ // to NineSlice finds no texture metadata and stretches its corners.
+ if (settings?.sliceBorder) {
+ const b = settings.sliceBorder;
+ requireResourceManager().setTextureMetadata(result.handle, b.left, b.right, b.top, b.bottom);
+ }
return result;
}
@@ -1335,6 +1345,18 @@ export class Assets {
setAssetRegistry(registry: AssetRegistry): void {
this.assetRegistry_ = registry;
this.assetRefResolver_ = (ref) => registry.resolveRef(ref);
+ // The registry carries each asset's importer block (the cook copies it
+ // into the ship manifest verbatim), so a shipped game has the same
+ // import settings the editor does — it just never read them. Default the
+ // texture resolver to it, so filter/wrap/sRGB and the 9-slice border
+ // survive the build. A host that installed its own resolver keeps it.
+ if (!this.textureImportResolver_) {
+ this.textureImportResolver_ = (ref) => {
+ const path = this.resolveLoadPath_(ref);
+ const entry = registry.getEntryByPath(path) ?? registry.getEntryByPath(ref);
+ return textureImportSettingsFrom(entry?.importer);
+ };
+ }
}
getAssetRegistry(): AssetRegistry | null {
diff --git a/sdk/src/asset/index.ts b/sdk/src/asset/index.ts
index b0f0c32bc..99a4db13b 100644
--- a/sdk/src/asset/index.ts
+++ b/sdk/src/asset/index.ts
@@ -30,6 +30,7 @@ export {
} from './assetGroups';
export { xxh64, contentHashHex, contentHashOf } from './contentHash';
export { AsyncCache } from './AsyncCache';
+export { textureImportSettingsFrom, type ParsedTextureImportSettings } from './textureImportSettings';
export { Assets, AssetPlugin, assetPlugin, type AssetsData } from './AssetPlugin';
export { decodeImageBitmap, decodeImagePixels, imageBitmapOptions, type DecodedPixels, fetchDecodePixels } from './imageDecode';
export { AssetRefCounter, type AssetRefInfo } from './AssetRefCounter';
diff --git a/sdk/src/asset/loaders/TextureLoader.ts b/sdk/src/asset/loaders/TextureLoader.ts
index 3b2c6419c..dfb48bc37 100644
--- a/sdk/src/asset/loaders/TextureLoader.ts
+++ b/sdk/src/asset/loaders/TextureLoader.ts
@@ -38,6 +38,13 @@ export interface TextureImportSettings {
* data (normal maps, masks) sets false so the linear pipeline skips the
* hardware EOTF. Ignored in gamma mode. */
readonly srgb?: boolean;
+ /**
+ * 9-slice border in texture pixels. A property of the IMAGE (where its
+ * corners end), not of any one entity — so it is authored once at import
+ * and every `UIVisual` set to NineSlice inherits it. Applied to the texture
+ * handle's metadata at load; a UIVisual may still override per entity.
+ */
+ readonly sliceBorder?: { readonly left: number; readonly right: number; readonly top: number; readonly bottom: number };
}
export type TextureImportSettingsResolver = (ref: string) => TextureImportSettings | undefined;
diff --git a/sdk/src/asset/textureImportSettings.ts b/sdk/src/asset/textureImportSettings.ts
new file mode 100644
index 000000000..bfeb022a8
--- /dev/null
+++ b/sdk/src/asset/textureImportSettings.ts
@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file asset/textureImportSettings.ts
+ * @brief The `.meta` importer block → {@link TextureImportSettings}.
+ *
+ * One parser, because there is one source: the importer block the asset
+ * inspector edits, which the cook copies verbatim into the ship manifest. The
+ * editor reads it from its own asset database and the runtime from the
+ * AssetRegistry, but they must agree on what it MEANS — a second reader is how
+ * "works in the editor, not in the build" gets born.
+ */
+
+/** Import-time texture settings, as the loader consumes them. */
+export interface ParsedTextureImportSettings {
+ filter?: 'linear' | 'nearest';
+ wrap?: 'repeat' | 'clamp' | 'mirror';
+ srgb?: boolean;
+ sliceBorder?: { left: number; right: number; top: number; bottom: number };
+}
+
+/**
+ * A 9-slice border, or undefined when the block slices nothing. All-zero is the
+ * "not 9-sliced" default and must NOT be stamped onto the texture: doing so
+ * would clear a border another consumer authored.
+ */
+function readSliceBorder(raw: unknown): ParsedTextureImportSettings['sliceBorder'] {
+ if (!raw || typeof raw !== 'object') return undefined;
+ const b = raw as Record<string, unknown>;
+ const n = (v: unknown): number => (typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : 0);
+ const border = { left: n(b.left), right: n(b.right), top: n(b.top), bottom: n(b.bottom) };
+ return border.left || border.right || border.top || border.bottom ? border : undefined;
+}
+
+/** Parse an importer block; undefined when it carries nothing the loader needs. */
+export function textureImportSettingsFrom(
+ importer: Record<string, unknown> | undefined | null,
+): ParsedTextureImportSettings | undefined {
+ if (!importer) return undefined;
+ const filter = importer.filterMode === 'nearest' || importer.filterMode === 'linear'
+ ? importer.filterMode
+ : undefined;
+ const wrap = importer.wrapMode === 'repeat' || importer.wrapMode === 'clamp' || importer.wrapMode === 'mirror'
+ ? importer.wrapMode
+ : undefined;
+ const srgb = typeof importer.sRGB === 'boolean' ? importer.sRGB : undefined;
+ const sliceBorder = readSliceBorder(importer.sliceBorder);
+ return filter || wrap || srgb !== undefined || sliceBorder
+ ? { filter, wrap, srgb, sliceBorder }
+ : undefined;
+}
diff --git a/sdk/src/core-content.ts b/sdk/src/core-content.ts
index af4787181..cf729acfc 100644
--- a/sdk/src/core-content.ts
+++ b/sdk/src/core-content.ts
@@ -89,6 +89,8 @@ export {
type SpineLoadResult,
type LocaleResult,
type AssetRefInfo,
+ textureImportSettingsFrom,
+ type ParsedTextureImportSettings,
} from './asset';
// =============================================================================
diff --git a/sdk/src/core-render.ts b/sdk/src/core-render.ts
index ecbbc18ff..b07091a21 100644
--- a/sdk/src/core-render.ts
+++ b/sdk/src/core-render.ts
@@ -33,7 +33,7 @@ export { Graphics } from './graphics';
// Texture
// =============================================================================
-export { TextureFilter, TextureWrap, setTextureFilter, setTextureWrap, setTextureParams } from './textureParams';
+export { TextureFilter, TextureWrap, setTextureFilter, setTextureWrap, setTextureParams, setTextureSliceBorder } from './textureParams';
// =============================================================================
// Camera
diff --git a/sdk/src/textureParams.ts b/sdk/src/textureParams.ts
index d14570e1b..cce17658b 100644
--- a/sdk/src/textureParams.ts
+++ b/sdk/src/textureParams.ts
@@ -1,6 +1,7 @@
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
import { Renderer } from './renderer';
+import { requireResourceManager } from './resourceManager';
export const TextureFilter = {
Nearest: 0,
@@ -34,3 +35,20 @@ export function setTextureParams(
): void {
Renderer.setTextureParams(textureId, minFilter, magFilter, wrapS, wrapT);
}
+
+/**
+ * The texture's 9-slice border, in texture pixels from each edge. A property of
+ * the IMAGE — every `UIVisual` set to NineSlice reads it, so a frame is sliced
+ * once at import rather than re-typed on every entity that uses it. Normally
+ * applied by the asset pipeline at load; call it directly to re-slice a texture
+ * already resident (an authoring tool editing the border live).
+ */
+export function setTextureSliceBorder(
+ textureId: number,
+ left: number,
+ right: number,
+ top: number,
+ bottom: number,
+): void {
+ requireResourceManager().setTextureMetadata(textureId, left, right, top, bottom);
+}
diff --git a/sdk/tests/texture-import-settings.test.ts b/sdk/tests/texture-import-settings.test.ts
new file mode 100644
index 000000000..131b37b35
--- /dev/null
+++ b/sdk/tests/texture-import-settings.test.ts
@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file The `.meta` importer block → texture load settings.
+ *
+ * One parser for the editor viewport and a shipped build, so this is where the
+ * meaning of that block is pinned. The 9-slice rule earns its own cases: an
+ * all-zero border means "not sliced" and must stay ABSENT, because a present
+ * border is stamped onto the texture and would clear one set elsewhere.
+ */
+import { describe, it, expect } from 'vitest';
+import { textureImportSettingsFrom } from '../src/asset/textureImportSettings';
+
+describe('textureImportSettingsFrom', () => {
+ it('maps filterMode/wrapMode to the loader filter/wrap shape', () => {
+ expect(textureImportSettingsFrom({ filterMode: 'nearest', wrapMode: 'clamp' }))
+ .toEqual({ filter: 'nearest', wrap: 'clamp', srgb: undefined, sliceBorder: undefined });
+ expect(textureImportSettingsFrom({ filterMode: 'linear' }))
+ .toEqual({ filter: 'linear', wrap: undefined, srgb: undefined, sliceBorder: undefined });
+ });
+
+ it('carries sRGB only when the block states it', () => {
+ expect(textureImportSettingsFrom({ sRGB: false })?.srgb).toBe(false);
+ expect(textureImportSettingsFrom({ sRGB: true })?.srgb).toBe(true);
+ expect(textureImportSettingsFrom({ filterMode: 'linear' })?.srgb).toBeUndefined();
+ });
+
+ it('is undefined when the block carries nothing the loader needs', () => {
+ expect(textureImportSettingsFrom({ maxSize: 2048 })).toBeUndefined();
+ expect(textureImportSettingsFrom({})).toBeUndefined();
+ expect(textureImportSettingsFrom(undefined)).toBeUndefined();
+ expect(textureImportSettingsFrom(null)).toBeUndefined();
+ });
+
+ it('ignores junk values rather than passing them to the loader', () => {
+ expect(textureImportSettingsFrom({ filterMode: 'wobbly', wrapMode: 7 })).toBeUndefined();
+ expect(textureImportSettingsFrom({ sRGB: 'yes' })).toBeUndefined();
+ });
+
+ describe('9-slice border', () => {
+ it('reads a full border', () => {
+ expect(textureImportSettingsFrom({ sliceBorder: { left: 12, right: 13, top: 14, bottom: 15 } })?.sliceBorder)
+ .toEqual({ left: 12, right: 13, top: 14, bottom: 15 });
+ });
+
+ it('keeps a partial border, zero-filling the edges that do not slice', () => {
+ expect(textureImportSettingsFrom({ sliceBorder: { left: 24, right: 24 } })?.sliceBorder)
+ .toEqual({ left: 24, right: 24, top: 0, bottom: 0 });
+ });
+
+ it('treats an all-zero border as NOT sliced, so it is never stamped', () => {
+ expect(textureImportSettingsFrom({ sliceBorder: { left: 0, right: 0, top: 0, bottom: 0 } }))
+ .toBeUndefined();
+ });
+
+ it('drops negative and non-finite edges', () => {
+ expect(textureImportSettingsFrom({ sliceBorder: { left: -5, right: NaN, top: 8, bottom: 'x' } })?.sliceBorder)
+ .toEqual({ left: 0, right: 0, top: 8, bottom: 0 });
+ });
+
+ it('survives a hand-edited block that is not an object', () => {
+ expect(textureImportSettingsFrom({ sliceBorder: 12 })).toBeUndefined();
+ expect(textureImportSettingsFrom({ sliceBorder: null })).toBeUndefined();
+ });
+
+ it('comes through alongside sampler settings', () => {
+ expect(textureImportSettingsFrom({ filterMode: 'nearest', sliceBorder: { left: 4 } }))
+ .toEqual({
+ filter: 'nearest', wrap: undefined, srgb: undefined,
+ sliceBorder: { left: 4, right: 0, top: 0, bottom: 0 },
+ });
+ });
+ });
+});