Class ParticleLoader

packages/particle/src/loaders/ParticleLoader.ts:207–243

 * Particle effect loader implementation
 */
export class ParticleLoader implements IAssetLoader<IParticleAsset> {
    readonly supportedType = ParticleAssetType;
    readonly supportedExtensions = ['.particle', '.particle.json'];
    readonly contentType: AssetContentType = 'text';

    /**
     * 从文本内容解析粒子资源
     * Parse particle asset from text content
     */
    async parse(content: IAssetContent, _context: IAssetParseContext): Promise<IParticleAsset> {
        if (!content.text) {
            throw new Error('Particle content is empty');
        }

        const jsonData = JSON.parse(content.text) as IParticleAsset;

        // 验证必要字段 | Validate required fields
        if (jsonData.maxParticles === undefined) {
            throw new Error('Invalid particle format: missing maxParticles');
        }

        // 填充默认值 | Fill default values
        const defaults = createDefaultParticleAsset();
        return { ...defaults, ...jsonData };
    }

    /**
     * 释放已加载的资源
     * Dispose loaded asset
     */
    dispose(asset: IParticleAsset): void {
        // 清理模块引用 | Clean up module references
        if (asset.modules) {
            asset.modules.length = 0;
        }
    }
}