Yeomai/SpineParticlesWeb
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

中英双语

Browse Source
This commit is contained in:
tianmo committed 2026-10-22 18:13:43 +08:00
1 parent ea26af26ee
commit b98c0333e6
50 files changed
+4082 -2049
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

src/export/spineJsonValidator.ts
+23 -22
View File
@@ -25,6 +25,7 @@ import {
import { normalizeSpine38JsonFor42 } from '../spine/spine38Compatibility'
import { normalizeSpineVersion, supportedSpineVersionsText, type SupportedSpineVersion } from '../spine/spineVersion'
import type { SpineJsonMap } from './spineJsonTypes'
import { translate } from '../i18n'
class ExportValidationAttachmentLoader42 implements AttachmentLoader42 {
newRegionAttachment(_skin: Skin42, name: string, path: string, _sequence: any) { return new RegionAttachment42(name, path) }
@@ -61,16 +62,16 @@ function validateMesh(mesh: Record<string, any>, attachmentName: string, boneCou
const uvs = mesh.uvs
const vertices = mesh.vertices
const triangles = mesh.triangles
if (!Array.isArray(uvs) || !uvs.length || uvs.length % 2) throw new Error(`拖尾网格“${attachmentName}”的 UV 数据无效`)
if (!Array.isArray(vertices) || !vertices.length) throw new Error(`拖尾网格“${attachmentName}”缺少顶点数据`)
if (!Array.isArray(uvs) || !uvs.length || uvs.length % 2) throw new Error(translate('errors.invalidTrailUV', { name: attachmentName }))
if (!Array.isArray(vertices) || !vertices.length) throw new Error(translate('errors.missingTrailVertices', { name: attachmentName }))
const vertexCount = uvs.length / 2
if (!Array.isArray(triangles) || triangles.some((index) => !Number.isInteger(index) || index < 0 || index >= vertexCount)) {
throw new Error(`拖尾网格“${attachmentName}”的三角形索引越界`)
throw new Error(translate('errors.trailIndexOutOfRange', { name: attachmentName }))
}
const hull = Number(mesh.hull) || 0
if (!Number.isInteger(hull) || hull < 0 || hull > vertexCount) throw new Error(`拖尾网格“${attachmentName}”的外轮廓数量无效`)
if (!Number.isInteger(hull) || hull < 0 || hull > vertexCount) throw new Error(translate('errors.invalidTrailHull', { name: attachmentName }))
if (Array.isArray(mesh.edges) && mesh.edges.some((index) => !Number.isInteger(index) || index < 0 || index >= vertexCount * 2 || index % 2)) {
throw new Error(`拖尾网格“${attachmentName}”的外轮廓边索引越界`)
throw new Error(translate('errors.trailHullIndexOutOfRange', { name: attachmentName }))
}
// 未加权 Mesh 每个顶点只有 x/y；拖尾必须是逐顶点的骨骼权重编码。
if (vertices.length === uvs.length) return
@@ -78,21 +79,21 @@ function validateMesh(mesh: Record<string, any>, attachmentName: string, boneCou
let decodedVertices = 0
while (offset < vertices.length) {
const influences = vertices[offset++]
if (!Number.isInteger(influences) || influences < 1) throw new Error(`拖尾网格“${attachmentName}”包含无效骨骼权重数量`)
if (!Number.isInteger(influences) || influences < 1) throw new Error(translate('errors.invalidInfluenceCount', { name: attachmentName }))
let weightSum = 0
for (let influence = 0; influence < influences; influence++) {
const boneIndex = vertices[offset++]
const x = vertices[offset++]
const y = vertices[offset++]
const weight = vertices[offset++]
if (!Number.isInteger(boneIndex) || boneIndex < 0 || boneIndex >= boneCount) throw new Error(`拖尾网格“${attachmentName}”引用了不存在的骨骼`)
if (![x, y, weight].every(Number.isFinite) || weight < 0) throw new Error(`拖尾网格“${attachmentName}”包含无效权重数据`)
if (!Number.isInteger(boneIndex) || boneIndex < 0 || boneIndex >= boneCount) throw new Error(translate('errors.missingBoneReference', { name: attachmentName }))
if (![x, y, weight].every(Number.isFinite) || weight < 0) throw new Error(translate('errors.invalidWeight', { name: attachmentName }))
weightSum += weight
}
if (Math.abs(weightSum - 1) > 0.001) throw new Error(`拖尾网格“${attachmentName}”的顶点权重之和不为 1`)
if (Math.abs(weightSum - 1) > 0.001) throw new Error(translate('errors.weightSum', { name: attachmentName }))
decodedVertices++
}
if (offset !== vertices.length || decodedVertices !== vertexCount) throw new Error(`拖尾网格“${attachmentName}”的顶点数量与 UV 不一致`)
if (offset !== vertices.length || decodedVertices !== vertexCount) throw new Error(translate('errors.vertexCountMismatch', { name: attachmentName }))
}
function validateEditorImportStructure(root: Record<string, any>, version: SupportedSpineVersion) {
@@ -100,12 +101,12 @@ function validateEditorImportStructure(root: Record<string, any>, version: Suppo
const boneByName = new Map(bones.map((bone) => [String(bone.name || ''), bone]))
const weightedMeshSlots = new Set<string>()
for (const bone of bones) {
if (bone.inherit != null && !VALID_INHERIT.has(bone.inherit)) throw new Error(`骨骼“${bone.name || ''}”的 inherit 值“${bone.inherit}”不符合 Spine ${version} JSON 格式`)
if (bone.inherit != null && !VALID_INHERIT.has(bone.inherit)) throw new Error(translate('errors.invalidInherit', { name: bone.name || '', inherit: bone.inherit, version }))
// 拖尾骨骼命名：系统名_序号_trail_资源id_骨骼序号，必须直接挂在粒子系统骨骼下。
if (/_trail_\d+_\d+$/.test(String(bone.name || ''))) {
const parent = boneByName.get(String(bone.parent || ''))
if (!parent || /_trail_\d+_\d+$/.test(String(parent.name || ''))) {
throw new Error(`拖尾骨骼“${bone.name || ''}”必须直接挂在粒子系统骨骼下，不能组成骨骼链`)
throw new Error(translate('errors.trailBoneParent', { name: bone.name || '' }))
}
}
}
@@ -125,34 +126,34 @@ function validateEditorImportStructure(root: Record<string, any>, version: Suppo
for (const slotName of weightedMeshSlots) {
const attachmentKeys = animation?.slots?.[slotName]?.attachment
if (Array.isArray(attachmentKeys) && attachmentKeys.some((key) => !key?.name)) {
throw new Error(`加权拖尾插槽“${slotName}”不能使用空附件，未出现或死亡阶段应将对应骨骼缩放设为 0`)
throw new Error(translate('errors.trailSlotEmpty', { name: slotName }))
}
}
}
}
function validateSpine38Structure(root: Record<string, any>) {
if (String(root?.skeleton?.spine || '') !== '3.8') throw new Error('Spine 3.8 导出的版本标识必须为 3.8')
if (String(root?.skeleton?.spine || '') !== '3.8') throw new Error(translate('errors.spine38Version'))
for (const bone of root.bones || []) {
if (bone.inherit != null) throw new Error(`Spine 3.8 骨骼“${bone.name || ''}”应使用 transform，不能使用 inherit`)
if (bone.inherit != null) throw new Error(translate('errors.spine38Inherit', { name: bone.name || '' }))
}
for (const animation of Object.values(root.animations || {}) as SpineJsonMap[]) {
for (const slot of Object.values(animation.slots || {}) as SpineJsonMap[]) {
if (slot.rgba || slot.rgba2) throw new Error('Spine 3.8 插槽颜色时间轴必须使用 color / twoColor')
if (slot.rgba || slot.rgba2) throw new Error(translate('errors.spine38SlotColor'))
for (const frame of slot.attachment || []) {
if (!Object.prototype.hasOwnProperty.call(frame, 'name')) throw new Error('Spine 3.8 附件时间轴的隐藏帧必须显式写入 name: null')
if (!Object.prototype.hasOwnProperty.call(frame, 'name')) throw new Error(translate('errors.spine38AttachmentName'))
}
}
for (const bone of Object.values(animation.bones || {}) as SpineJsonMap[]) {
for (const frame of bone.rotate || []) {
if (frame.value != null || frame.angle == null) throw new Error('Spine 3.8 旋转时间轴必须使用 angle')
if (frame.value != null || frame.angle == null) throw new Error(translate('errors.spine38RotationAngle'))
}
}
const stack: unknown[] = [animation]
while (stack.length) {
const value = stack.pop()
if (!value || typeof value !== 'object') continue
if (!Array.isArray(value) && Array.isArray((value as SpineJsonMap).curve)) throw new Error('Spine 3.8 不支持 4.x 数组曲线格式')
if (!Array.isArray(value) && Array.isArray((value as SpineJsonMap).curve)) throw new Error(translate('errors.spine38Curve'))
stack.push(...Object.values(value))
}
}
@@ -165,14 +166,14 @@ function validateSpine38Structure(root: Record<string, any>) {
export function validateSpineJson(text: string, expectedVersion?: SupportedSpineVersion) {
const root = JSON.parse(text)
const version = normalizeSpineVersion(root?.skeleton?.spine)
if (!version) throw new Error(`导出版本不受支持，仅支持 Spine ${supportedSpineVersionsText()}`)
if (expectedVersion && version !== expectedVersion) throw new Error(`导出版本不一致：设置为 Spine ${expectedVersion}，JSON 标记为 Spine ${version}`)
if (!version) throw new Error(translate('errors.unsupportedExportVersion', { versions: supportedSpineVersionsText() }))
if (expectedVersion && version !== expectedVersion) throw new Error(translate('errors.exportVersionMismatch', { expected: expectedVersion, actual: version }))
validateEditorImportStructure(root, version)
if (version === '3.8') validateSpine38Structure(root)
const runtimeRoot = version === '3.8' ? normalizeSpine38JsonFor42(JSON.parse(JSON.stringify(root))) : root
const data = version === '4.3'
? new SkeletonJson43(new ExportValidationAttachmentLoader43()).readSkeletonData(runtimeRoot)
: new SkeletonJson42(new ExportValidationAttachmentLoader42()).readSkeletonData(runtimeRoot)
if (!data.bones.length) throw new Error('导出结果缺少骨骼')
if (!data.bones.length) throw new Error(translate('errors.exportMissingBones'))
return { version, bones: data.bones.length, slots: data.slots.length, animations: data.animations.length }
}