@fps-games/vfx 0.3.2 → 0.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +16 -0
- package/README.md +5 -5
- package/dist/effects/treasure-attention/index.d.ts +1 -1
- package/package.json +6 -5
- package/tooling/vfx-cli.mjs +31 -22
- package/tooling/vfx-package-resolution.mjs +8 -8
- package/docs/AUTHORING_EFFECTS.md +0 -297
- package/docs/INTEGRATION.md +0 -194
- package/docs/VFX_LIBRARY_ARCHITECTURE_chatgpt.md +0 -1580
- package/docs/VFX_LIBRARY_EXECUTION_PLAN.md +0 -229
- package/docs/VFX_LIBRARY_PLAN.md +0 -546
- package/docs/hit-flash-red-method.md +0 -155
- package/docs/treasure_attention_fx_babylonjs_guide.md +0 -901
- package/docs/vfx-ab/RESULTS.md +0 -35
- package/docs/vfx-ab/lumber-order/vehicle-exhaust-smoke/after.png +0 -0
- package/docs/vfx-ab/lumber-order/vehicle-exhaust-smoke/before.png +0 -0
- package/docs/vfx-ab/lumber-truck/vehicle-exhaust-smoke/after.png +0 -0
- package/docs/vfx-ab/lumber-truck/vehicle-exhaust-smoke/before.png +0 -0
- package/docs/vfx-integration_chatgpt.md +0 -462
- package/docs/vfx-placement-design.md +0 -164
- package/docs/weapon-trail-visualization.html +0 -241
- package/packages/EffectPackageService.ts +0 -346
- package/packages/SceneVfxService.ts +0 -96
- package/packages/build.mesh.yellow_build_upgrade_indicator/assets/runtime/simpleMeshEffect.v1.js +0 -333
- package/packages/build.mesh.yellow_build_upgrade_indicator/assets/shaders/mesh-effect-preview.frag.glsl +0 -25
- package/packages/build.mesh.yellow_build_upgrade_indicator/assets/shaders/mesh-effect-preview.vert.glsl +0 -11
- package/packages/build.mesh.yellow_build_upgrade_indicator/assets/textures/effect_jianbian.png +0 -0
- package/packages/build.mesh.yellow_build_upgrade_indicator/effect.json +0 -927
- package/packages/build.mesh.yellow_build_upgrade_indicator/media/contact-sheet.png +0 -0
- package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.gif +0 -0
- package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.mp4 +0 -0
- package/packages/build.mesh.yellow_build_upgrade_indicator/media/preview.webm +0 -0
- package/packages/build.mesh.yellow_build_upgrade_indicator/media/thumbnail.png +0 -0
- package/packages/build.mesh.yellow_build_upgrade_indicator/metadata/description.json +0 -197
- package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/03-effect.original.json +0 -895
- package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/03-normalized-vfx-to-babylon-report.json +0 -241
- package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/04-preview-overrides.json +0 -542
- package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/04-preview-tuning-report.json +0 -69
- package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/asset-map.json +0 -125
- package/packages/build.mesh.yellow_build_upgrade_indicator/provenance/lineage.json +0 -44
- package/packages/build.particle.golden_upgrade_starburst/assets/runtime/particleEmitter.v1.js +0 -210
- package/packages/build.particle.golden_upgrade_starburst/assets/textures/effect_guangdian.png +0 -0
- package/packages/build.particle.golden_upgrade_starburst/effect.json +0 -880
- package/packages/build.particle.golden_upgrade_starburst/media/contact-sheet.png +0 -0
- package/packages/build.particle.golden_upgrade_starburst/media/preview.gif +0 -0
- package/packages/build.particle.golden_upgrade_starburst/media/preview.mp4 +0 -0
- package/packages/build.particle.golden_upgrade_starburst/media/preview.webm +0 -0
- package/packages/build.particle.golden_upgrade_starburst/media/thumbnail.png +0 -0
- package/packages/build.particle.golden_upgrade_starburst/metadata/description.json +0 -161
- package/packages/build.particle.golden_upgrade_starburst/provenance/03-effect.original.json +0 -762
- package/packages/build.particle.golden_upgrade_starburst/provenance/03-normalized-vfx-to-babylon-report.json +0 -260
- package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-overrides.json +0 -436
- package/packages/build.particle.golden_upgrade_starburst/provenance/04-preview-tuning-report.json +0 -40
- package/packages/build.particle.golden_upgrade_starburst/provenance/asset-map.json +0 -115
- package/packages/build.particle.golden_upgrade_starburst/provenance/lineage.json +0 -40
- package/packages/build.particle.orange_upgrade_transform_sparks/assets/runtime/particleEmitter.v1.js +0 -210
- package/packages/build.particle.orange_upgrade_transform_sparks/assets/textures/b5b27ab1-e740-4398-b407-848fc2b2c897.png +0 -0
- package/packages/build.particle.orange_upgrade_transform_sparks/effect.json +0 -887
- package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.gif +0 -0
- package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.mp4 +0 -0
- package/packages/build.particle.orange_upgrade_transform_sparks/media/preview.webm +0 -0
- package/packages/build.particle.orange_upgrade_transform_sparks/media/thumbnail.png +0 -0
- package/packages/build.particle.orange_upgrade_transform_sparks/metadata/description.json +0 -179
- package/packages/build.particle.orange_upgrade_transform_sparks/provenance/03-effect.original.json +0 -859
- package/packages/build.particle.orange_upgrade_transform_sparks/provenance/03-normalized-vfx-to-babylon-report.json +0 -260
- package/packages/build.particle.orange_upgrade_transform_sparks/provenance/04-preview-overrides.json +0 -478
- package/packages/build.particle.orange_upgrade_transform_sparks/provenance/04-preview-tuning-report.json +0 -40
- package/packages/build.particle.orange_upgrade_transform_sparks/provenance/asset-map.json +0 -114
- package/packages/build.particle.orange_upgrade_transform_sparks/provenance/lineage.json +0 -41
- package/packages/build.particle.wood_chip_dust_burst/assets/runtime/particleEmitter.v1.js +0 -210
- package/packages/build.particle.wood_chip_dust_burst/assets/textures/effect_yanwu4.png +0 -0
- package/packages/build.particle.wood_chip_dust_burst/assets/textures/suipian3.png +0 -0
- package/packages/build.particle.wood_chip_dust_burst/effect.json +0 -1400
- package/packages/build.particle.wood_chip_dust_burst/media/contact-sheet.png +0 -0
- package/packages/build.particle.wood_chip_dust_burst/media/preview.gif +0 -0
- package/packages/build.particle.wood_chip_dust_burst/media/preview.mp4 +0 -0
- package/packages/build.particle.wood_chip_dust_burst/media/preview.webm +0 -0
- package/packages/build.particle.wood_chip_dust_burst/media/thumbnail.png +0 -0
- package/packages/build.particle.wood_chip_dust_burst/metadata/description.json +0 -173
- package/packages/build.particle.wood_chip_dust_burst/provenance/03-effect.original.json +0 -1277
- package/packages/build.particle.wood_chip_dust_burst/provenance/03-normalized-vfx-to-babylon-report.json +0 -329
- package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-overrides.json +0 -749
- package/packages/build.particle.wood_chip_dust_burst/provenance/04-preview-tuning-report.json +0 -60
- package/packages/build.particle.wood_chip_dust_burst/provenance/asset-map.json +0 -146
- package/packages/build.particle.wood_chip_dust_burst/provenance/lineage.json +0 -69
- package/packages/effects/building-upgrade/effect.json +0 -6
- package/packages/effects/building-upgrade/index.ts +0 -387
- package/packages/effects/character-entrance/effect.json +0 -6
- package/packages/effects/character-entrance/index.ts +0 -308
- package/packages/effects/coin-burst/index.ts +0 -48
- package/packages/effects/comet-trail-flame/assets/textures/trail_5x4.webp +0 -0
- package/packages/effects/comet-trail-flame/index.ts +0 -107
- package/packages/effects/conveyor-upgrade/effect.json +0 -6
- package/packages/effects/conveyor-upgrade/index.ts +0 -401
- package/packages/effects/debris-smoke/assets/models/rock_debris.glb +0 -0
- package/packages/effects/debris-smoke/assets/textures/smoke22.webp +0 -0
- package/packages/effects/debris-smoke/index.ts +0 -102
- package/packages/effects/door_open_gold_flakes/assets/runtime/goldFlakes.v1.js +0 -397
- package/packages/effects/door_open_gold_flakes/door_open_gold_flakes.json +0 -498
- package/packages/effects/door_open_gold_flakes/index.ts +0 -11
- package/packages/effects/electric-arc/assets/textures/spark_4x4.webp +0 -0
- package/packages/effects/electric-arc/index.ts +0 -63
- package/packages/effects/energy-shield/effect.json +0 -7
- package/packages/effects/energy-shield/index.ts +0 -432
- package/packages/effects/explosion/assets/textures/baozha29.webp +0 -0
- package/packages/effects/explosion/assets/textures/glow01.webp +0 -0
- package/packages/effects/explosion/assets/textures/lizi01.webp +0 -0
- package/packages/effects/explosion/assets/textures/xulie_lizibaozha02_5x5.webp +0 -0
- package/packages/effects/explosion/index.ts +0 -115
- package/packages/effects/ground-tile-upgrade/effect.json +0 -6
- package/packages/effects/ground-tile-upgrade/index.ts +0 -410
- package/packages/effects/hit-flash/index.ts +0 -77
- package/packages/effects/laser-beam/assets/textures/laser_glow.webp +0 -0
- package/packages/effects/laser-beam/assets/textures/laser_noise.webp +0 -0
- package/packages/effects/laser-beam/index.ts +0 -6
- package/packages/effects/laser-beam-factory.ts +0 -146
- package/packages/effects/lumber-cart-suction/effect.json +0 -6
- package/packages/effects/lumber-cart-suction/index.ts +0 -399
- package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb +0 -0
- package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb.versions/.active +0 -1
- package/packages/effects/lumber-debris-scatter/assets/models/lumber_prop_model.glb.versions/1781589063890_upload.glb +0 -0
- package/packages/effects/lumber-debris-scatter/assets/runtime/solidParticleScatter.v1.js +0 -236
- package/packages/effects/lumber-debris-scatter/effect.json +0 -228
- package/packages/effects/lumber-debris-scatter/index.ts +0 -780
- package/packages/effects/lumber_vehicle_gear_spin/assets/runtime/gearSpin.v1.js +0 -202
- package/packages/effects/lumber_vehicle_gear_spin/index.ts +0 -11
- package/packages/effects/lumber_vehicle_gear_spin/lumber_vehicle_gear_spin.json +0 -338
- package/packages/effects/lumber_vehicle_upgrade_aura/assets/runtime/upgradeAura.v1.js +0 -353
- package/packages/effects/lumber_vehicle_upgrade_aura/index.ts +0 -13
- package/packages/effects/lumber_vehicle_upgrade_aura/lumber_vehicle_upgrade_aura.json +0 -365
- package/packages/effects/lumber_vehicle_wood_chips/assets/runtime/solidParticleScatter.v1.js +0 -310
- package/packages/effects/lumber_vehicle_wood_chips/index.ts +0 -11
- package/packages/effects/lumber_vehicle_wood_chips/lumber_vehicle_wood_chips.json +0 -335
- package/packages/effects/monster-hit/index.ts +0 -129
- package/packages/effects/player-upgrade/effect.json +0 -6
- package/packages/effects/player-upgrade/index.ts +0 -640
- package/packages/effects/pulse-laser-volley/assets/textures/bolt_guangshu.webp +0 -0
- package/packages/effects/pulse-laser-volley/index.ts +0 -215
- package/packages/effects/resource-collect-sparkles/effect.json +0 -6
- package/packages/effects/resource-collect-sparkles/index.ts +0 -254
- package/packages/effects/run-footstep-dust/assets/runtime/runFootstepDust.v1.js +0 -215
- package/packages/effects/run-footstep-dust/effect.json +0 -183
- package/packages/effects/run-footstep-dust/index.ts +0 -377
- package/packages/effects/space-shared.ts +0 -120
- package/packages/effects/thruster-flame/index.ts +0 -306
- package/packages/effects/treasure-attention/effect.json +0 -7
- package/packages/effects/treasure-attention/index.ts +0 -630
- package/packages/effects/tree-chop-dust/assets/textures/tree_chop_dust_atlas.png +0 -0
- package/packages/effects/tree-chop-dust/effect.json +0 -8
- package/packages/effects/tree-chop-dust/index.ts +0 -202
- package/packages/effects/tree-leaf-chop-burst/assets/runtime/particleEmitter.v1.js +0 -303
- package/packages/effects/tree-leaf-chop-burst/assets/textures/tree_leaf_chop_burst_leaf_atlas.png +0 -0
- package/packages/effects/tree-leaf-chop-burst/effect.json +0 -498
- package/packages/effects/tree-leaf-chop-burst/index.ts +0 -294
- package/packages/effects/tree_chop_dust_burst/assets/runtime/particleEmitter.v1.js +0 -318
- package/packages/effects/tree_chop_dust_burst/assets/textures/tree_chop_dust_burst_dust.png +0 -0
- package/packages/effects/tree_chop_dust_burst/index.ts +0 -13
- package/packages/effects/tree_chop_dust_burst/tree_chop_dust_burst.json +0 -412
- package/packages/effects/ufo-thread-flame/assets/textures/flame_flow.webp +0 -0
- package/packages/effects/ufo-thread-flame/assets/textures/flame_spike.webp +0 -0
- package/packages/effects/ufo-thread-flame/index.ts +0 -153
- package/packages/effects/vehicle-exhaust-smoke/assets/textures/vehicle_exhaust_smoke_atlas.png +0 -0
- package/packages/effects/vehicle-exhaust-smoke/effect.json +0 -8
- package/packages/effects/vehicle-exhaust-smoke/index.ts +0 -298
- package/packages/effects/vehicle-upgrade/effect.json +0 -6
- package/packages/effects/vehicle-upgrade/index.ts +0 -404
- package/packages/effects/weapon-trail/assets/textures/trail_wedge.png +0 -0
- package/packages/effects/weapon-trail/index.ts +0 -317
- package/packages/effects/wood-crusher-sawdust/assets/runtime/particleEmitter.v1.js +0 -312
- package/packages/effects/wood-crusher-sawdust/assets/textures/wood_crusher_sawdust_dust.png +0 -0
- package/packages/effects/wood-crusher-sawdust/assets/textures/wood_crusher_sawdust_fiber.png +0 -0
- package/packages/effects/wood-crusher-sawdust/index.ts +0 -43
- package/packages/effects/wood-crusher-sawdust/wood_crusher_sawdust.json +0 -592
- package/packages/effects/wood-cutter-sawdust/assets/runtime/particleEmitter.v1.js +0 -312
- package/packages/effects/wood-cutter-sawdust/assets/textures/wood_cutter_sawdust_chip.png +0 -0
- package/packages/effects/wood-cutter-sawdust/assets/textures/wood_cutter_sawdust_dust.png +0 -0
- package/packages/effects/wood-cutter-sawdust/index.ts +0 -43
- package/packages/effects/wood-cutter-sawdust/wood_cutter_sawdust.json +0 -592
- package/packages/effects/wood-sawdust-effect-factory.ts +0 -194
- package/packages/effects/wood_crusher_sawdust/assets/runtime/particleEmitter.v1.js +0 -318
- package/packages/effects/wood_crusher_sawdust/assets/textures/wood_crusher_sawdust_dust.png +0 -0
- package/packages/effects/wood_crusher_sawdust/assets/textures/wood_crusher_sawdust_fiber.png +0 -0
- package/packages/effects/wood_crusher_sawdust/index.ts +0 -29
- package/packages/effects/wood_crusher_sawdust/wood_crusher_sawdust.json +0 -592
- package/packages/effects/wood_cutter_sawdust/assets/runtime/particleEmitter.v1.js +0 -318
- package/packages/effects/wood_cutter_sawdust/assets/textures/wood_cutter_sawdust_chip.png +0 -0
- package/packages/effects/wood_cutter_sawdust/assets/textures/wood_cutter_sawdust_dust.png +0 -0
- package/packages/effects/wood_cutter_sawdust/index.ts +0 -29
- package/packages/effects/wood_cutter_sawdust/wood_cutter_sawdust.json +0 -592
- package/packages/effects/wood_peel_material_test/assets/runtime/woodPeelMaterialTest.v1.js +0 -196
- package/packages/effects/wood_peel_material_test/index.ts +0 -11
- package/packages/effects/wood_peel_material_test/wood_peel_material_test.json +0 -136
- package/packages/env.particle.forest_edge_fog/assets/runtime/particleEmitter.v1.js +0 -210
- package/packages/env.particle.forest_edge_fog/assets/textures/f12a23c4-b924-4322-a260-3d982428f1e8.png +0 -0
- package/packages/env.particle.forest_edge_fog/assets/textures/yuan.png +0 -0
- package/packages/env.particle.forest_edge_fog/effect.json +0 -854
- package/packages/env.particle.forest_edge_fog/media/preview.gif +0 -0
- package/packages/env.particle.forest_edge_fog/media/preview.mp4 +0 -0
- package/packages/env.particle.forest_edge_fog/media/preview.webm +0 -0
- package/packages/env.particle.forest_edge_fog/media/thumbnail.png +0 -0
- package/packages/env.particle.forest_edge_fog/metadata/description.json +0 -148
- package/packages/env.particle.forest_edge_fog/provenance/03-effect.original.json +0 -827
- package/packages/env.particle.forest_edge_fog/provenance/03-normalized-vfx-to-babylon-report.json +0 -196
- package/packages/env.particle.forest_edge_fog/provenance/04-preview-overrides.json +0 -432
- package/packages/env.particle.forest_edge_fog/provenance/04-preview-tuning-report.json +0 -28
- package/packages/env.particle.forest_edge_fog/provenance/asset-map.json +0 -124
- package/packages/env.particle.forest_edge_fog/provenance/lineage.json +0 -41
- package/packages/generation.ts +0 -14
- package/packages/index.ts +0 -14
- package/packages/legacy-particle-runtime.ts +0 -113
- package/packages/manifestRuntimePackage.ts +0 -519
- package/packages/registry.ts +0 -85
- package/packages/rendering.ts +0 -13
- package/packages/resource.particle.viscous_oil_suction/assets/runtime/top_disk_suction/particleEmitter.v1.js +0 -424
- package/packages/resource.particle.viscous_oil_suction/assets/textures/Glow ad.png +0 -0
- package/packages/resource.particle.viscous_oil_suction/effect.json +0 -1254
- package/packages/resource.particle.viscous_oil_suction/media/preview.gif +0 -0
- package/packages/resource.particle.viscous_oil_suction/media/preview.mp4 +0 -0
- package/packages/resource.particle.viscous_oil_suction/media/preview.webm +0 -0
- package/packages/resource.particle.viscous_oil_suction/media/thumbnail.png +0 -0
- package/packages/resource.particle.viscous_oil_suction/metadata/description.json +0 -122
- package/packages/resource.particle.viscous_oil_suction/provenance/03-effect.original.json +0 -1051
- package/packages/resource.particle.viscous_oil_suction/provenance/03-normalized-vfx-to-babylon-report.json +0 -200
- package/packages/resource.particle.viscous_oil_suction/provenance/04-preview-overrides.json +0 -581
- package/packages/resource.particle.viscous_oil_suction/provenance/04-preview-tuning-report.json +0 -28
- package/packages/resource.particle.viscous_oil_suction/provenance/asset-map.json +0 -111
- package/packages/resource.particle.viscous_oil_suction/provenance/lineage.json +0 -45
- package/packages/types.ts +0 -195
- package/tooling/check-dist-runtime.mjs +0 -166
- package/tooling/generate-index.mjs +0 -55
- package/tooling/test-guardrails.mjs +0 -157
- package/tooling/validate-boundary.mjs +0 -92
- package/tooling/validate-effects.mjs +0 -304
- package/tooling/validate.mjs +0 -53
|
@@ -1,298 +0,0 @@
|
|
|
1
|
-
import { Color4 } from '@babylonjs/core/Maths/math.color';
|
|
2
|
-
import { Vector3 } from '@babylonjs/core/Maths/math.vector';
|
|
3
|
-
import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
|
|
4
|
-
import { Sprite } from '@babylonjs/core/Sprites/sprite';
|
|
5
|
-
import { SpriteManager } from '@babylonjs/core/Sprites/spriteManager';
|
|
6
|
-
import type { Scene } from '@babylonjs/core/scene';
|
|
7
|
-
import type { VfxColorValue, VfxEffectPackage, VfxParamValues } from '../../types';
|
|
8
|
-
import { configureVfxSpriteManager, VFX_RENDERING_GROUP_ID } from '../../rendering';
|
|
9
|
-
import manifest from './effect.json';
|
|
10
|
-
|
|
11
|
-
interface VehicleExhaustSmokeParams extends VfxParamValues {
|
|
12
|
-
lifetimeMode: string;
|
|
13
|
-
lifetime: number;
|
|
14
|
-
scale: number;
|
|
15
|
-
initialHeight: number;
|
|
16
|
-
color: VfxColorValue;
|
|
17
|
-
opacity: number;
|
|
18
|
-
particleCount: number;
|
|
19
|
-
particleMaxLifetime: number;
|
|
20
|
-
emitRange: number;
|
|
21
|
-
riseHeight: number;
|
|
22
|
-
smokeSize: number;
|
|
23
|
-
driftSpeed: number;
|
|
24
|
-
directionX: number;
|
|
25
|
-
directionZ: number;
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
interface SmokeSpriteState {
|
|
29
|
-
sprite: Sprite;
|
|
30
|
-
velocity: Vector3;
|
|
31
|
-
spin: number;
|
|
32
|
-
width: number;
|
|
33
|
-
height: number;
|
|
34
|
-
lifetime: number;
|
|
35
|
-
alphaScale: number;
|
|
36
|
-
age: number;
|
|
37
|
-
active: boolean;
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
import SMOKE_TEXTURE_URL from './assets/textures/vehicle_exhaust_smoke_atlas.png?url';
|
|
41
|
-
|
|
42
|
-
const DEFAULT_PARAMS: VehicleExhaustSmokeParams = {
|
|
43
|
-
lifetimeMode: 'infinite',
|
|
44
|
-
lifetime: 2.2,
|
|
45
|
-
scale: 1.35,
|
|
46
|
-
initialHeight: 0.55,
|
|
47
|
-
color: { r: 0.34, g: 0.34, b: 0.32 },
|
|
48
|
-
opacity: 0.78,
|
|
49
|
-
particleCount: 82,
|
|
50
|
-
particleMaxLifetime: 1.61,
|
|
51
|
-
emitRange: 0.3,
|
|
52
|
-
riseHeight: 0.72,
|
|
53
|
-
smokeSize: 0.82,
|
|
54
|
-
driftSpeed: 1.4,
|
|
55
|
-
directionX: -1,
|
|
56
|
-
directionZ: 0,
|
|
57
|
-
};
|
|
58
|
-
|
|
59
|
-
export const vehicleExhaustSmokeEffectPackage: VfxEffectPackage<VehicleExhaustSmokeParams> = {
|
|
60
|
-
id: 'vehicle-exhaust-smoke',
|
|
61
|
-
nameZh: '小车尾气',
|
|
62
|
-
manifest,
|
|
63
|
-
defaultParams: DEFAULT_PARAMS,
|
|
64
|
-
debugAnchor: 'player',
|
|
65
|
-
debugParams: [
|
|
66
|
-
{
|
|
67
|
-
key: 'lifetimeMode',
|
|
68
|
-
label: '生命周期模式',
|
|
69
|
-
kind: 'enum',
|
|
70
|
-
options: [
|
|
71
|
-
{ value: 'infinite', label: '无限' },
|
|
72
|
-
{ value: 'duration', label: '自定义时间' },
|
|
73
|
-
],
|
|
74
|
-
},
|
|
75
|
-
{ key: 'lifetime', label: '自定义时长', kind: 'lifetime', min: 0.1, max: 30, step: 0.01 },
|
|
76
|
-
{ key: 'scale', label: '整体缩放', kind: 'scale', min: 0.05, max: 8, step: 0.01 },
|
|
77
|
-
{ key: 'initialHeight', label: '初始高度', kind: 'number', min: -1, max: 3, step: 0.01 },
|
|
78
|
-
{ key: 'color', label: '尾气颜色', kind: 'color' },
|
|
79
|
-
{ key: 'opacity', label: '透明度', kind: 'opacity', min: 0, max: 1, step: 0.01 },
|
|
80
|
-
{ key: 'particleCount', label: '粒子数量', kind: 'number', min: 1, max: 180, step: 1 },
|
|
81
|
-
{ key: 'particleMaxLifetime', label: '单粒最大生命周期', kind: 'lifetime', min: 0.08, max: 5, step: 0.01 },
|
|
82
|
-
{ key: 'emitRange', label: '排气口宽度', kind: 'number', min: 0, max: 2, step: 0.01 },
|
|
83
|
-
{ key: 'riseHeight', label: '上浮高度', kind: 'number', min: -1, max: 4, step: 0.01 },
|
|
84
|
-
{ key: 'smokeSize', label: '烟团大小', kind: 'number', min: 0.02, max: 3, step: 0.01 },
|
|
85
|
-
{ key: 'driftSpeed', label: '飘散速度', kind: 'number', min: 0.05, max: 8, step: 0.01 },
|
|
86
|
-
{ key: 'directionX', label: '方向 X', kind: 'number', min: -1, max: 1, step: 0.01 },
|
|
87
|
-
{ key: 'directionZ', label: '方向 Z', kind: 'number', min: -1, max: 1, step: 0.01 },
|
|
88
|
-
],
|
|
89
|
-
create({ scene, root, position, renderingGroupId, params }) {
|
|
90
|
-
const effectScale = Math.max(0.05, params.scale);
|
|
91
|
-
root.position.copyFrom(position).addInPlace(new Vector3(0, params.initialHeight * effectScale, 0));
|
|
92
|
-
const smokeTrail = createExhaustSpriteTrail(scene, root, params, renderingGroupId);
|
|
93
|
-
let disposed = false;
|
|
94
|
-
const durationSeconds = readDurationSeconds(params);
|
|
95
|
-
const disposeTimer = durationSeconds == null
|
|
96
|
-
? 0
|
|
97
|
-
: window.setTimeout(() => disposeAll(), getDisposeDelaySeconds(params) * 1000);
|
|
98
|
-
|
|
99
|
-
return {
|
|
100
|
-
root,
|
|
101
|
-
dispose() {
|
|
102
|
-
disposeAll();
|
|
103
|
-
},
|
|
104
|
-
};
|
|
105
|
-
|
|
106
|
-
function disposeAll(): void {
|
|
107
|
-
if (disposed) return;
|
|
108
|
-
disposed = true;
|
|
109
|
-
if (disposeTimer) window.clearTimeout(disposeTimer);
|
|
110
|
-
smokeTrail.dispose();
|
|
111
|
-
root.dispose();
|
|
112
|
-
}
|
|
113
|
-
},
|
|
114
|
-
};
|
|
115
|
-
|
|
116
|
-
function createExhaustSpriteTrail(
|
|
117
|
-
scene: Scene,
|
|
118
|
-
root: TransformNode,
|
|
119
|
-
params: VehicleExhaustSmokeParams,
|
|
120
|
-
renderingGroupId?: number,
|
|
121
|
-
): { dispose(): void } {
|
|
122
|
-
const count = Math.max(1, Math.round(params.particleCount));
|
|
123
|
-
const manager = new SpriteManager('vehicle-exhaust-smoke.puffs', SMOKE_TEXTURE_URL, count, { width: 128, height: 128 }, scene);
|
|
124
|
-
configureVfxSpriteManager(manager);
|
|
125
|
-
manager.renderingGroupId = renderingGroupId ?? VFX_RENDERING_GROUP_ID;
|
|
126
|
-
manager.texture.hasAlpha = true;
|
|
127
|
-
manager.fogEnabled = false;
|
|
128
|
-
|
|
129
|
-
const effectScale = Math.max(0.05, params.scale);
|
|
130
|
-
const emitRange = Math.max(0, params.emitRange) * effectScale;
|
|
131
|
-
const smokeSize = Math.max(0.01, params.smokeSize) * effectScale;
|
|
132
|
-
const driftSpeed = Math.max(0.01, params.driftSpeed) * effectScale;
|
|
133
|
-
const particleMaxLifetime = Math.max(0.08, params.particleMaxLifetime);
|
|
134
|
-
const durationSeconds = readDurationSeconds(params);
|
|
135
|
-
const puffLifetime = particleMaxLifetime / 1.18;
|
|
136
|
-
const emitInterval = Math.max(0.018, 2.2 / Math.max(1, count));
|
|
137
|
-
const states: SmokeSpriteState[] = [];
|
|
138
|
-
|
|
139
|
-
for (let index = 0; index < count; index += 1) {
|
|
140
|
-
const sprite = new Sprite(`vehicle-exhaust-smoke.puff.${index}`, manager);
|
|
141
|
-
sprite.isVisible = false;
|
|
142
|
-
sprite.color = toColor4(params.color, 0);
|
|
143
|
-
states.push({
|
|
144
|
-
sprite,
|
|
145
|
-
velocity: Vector3.Zero(),
|
|
146
|
-
spin: 0,
|
|
147
|
-
width: 0,
|
|
148
|
-
height: 0,
|
|
149
|
-
lifetime: puffLifetime,
|
|
150
|
-
alphaScale: 1,
|
|
151
|
-
age: 0,
|
|
152
|
-
active: false,
|
|
153
|
-
});
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
let age = 0;
|
|
157
|
-
let emissionIndex = 0;
|
|
158
|
-
let emitAccumulator = 0;
|
|
159
|
-
let disposed = false;
|
|
160
|
-
|
|
161
|
-
const warmStartCount = Math.min(count, Math.max(3, Math.ceil(count * 0.08)));
|
|
162
|
-
for (let index = 0; index < warmStartCount; index += 1) {
|
|
163
|
-
const state = states[index];
|
|
164
|
-
spawnPuff(state, emissionIndex);
|
|
165
|
-
state.age = (index / warmStartCount) * state.lifetime * 0.52;
|
|
166
|
-
emissionIndex += 1;
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
const observer = scene.onBeforeRenderObservable.add(() => {
|
|
170
|
-
if (disposed) return;
|
|
171
|
-
const deltaSeconds = Math.min(0.05, scene.getEngine().getDeltaTime() / 1000);
|
|
172
|
-
age += deltaSeconds;
|
|
173
|
-
if (durationSeconds == null || age <= durationSeconds) {
|
|
174
|
-
emitAccumulator += deltaSeconds;
|
|
175
|
-
while (emitAccumulator >= emitInterval) {
|
|
176
|
-
emitAccumulator -= emitInterval;
|
|
177
|
-
const state = findAvailableState(states);
|
|
178
|
-
if (!state) break;
|
|
179
|
-
spawnPuff(state, emissionIndex);
|
|
180
|
-
emissionIndex += 1;
|
|
181
|
-
}
|
|
182
|
-
}
|
|
183
|
-
for (const state of states) {
|
|
184
|
-
if (!state.active) continue;
|
|
185
|
-
state.age += deltaSeconds;
|
|
186
|
-
const t = Math.min(1, state.age / state.lifetime);
|
|
187
|
-
const fadeIn = Math.min(1, t / 0.12);
|
|
188
|
-
const fadeOut = Math.max(0, 1 - Math.max(0, t - 0.34) / 0.66);
|
|
189
|
-
const alpha = clamp01(params.opacity) * state.alphaScale * fadeIn * fadeOut;
|
|
190
|
-
state.sprite.position.addInPlace(state.velocity.scale(deltaSeconds));
|
|
191
|
-
state.sprite.angle += state.spin * deltaSeconds;
|
|
192
|
-
const grow = 1 + t * 1.45;
|
|
193
|
-
state.sprite.width = state.width * grow;
|
|
194
|
-
state.sprite.height = state.height * grow;
|
|
195
|
-
state.sprite.color = toColor4(params.color, alpha);
|
|
196
|
-
state.sprite.isVisible = alpha > 0.01 && t < 1;
|
|
197
|
-
if (t >= 1) {
|
|
198
|
-
state.active = false;
|
|
199
|
-
state.sprite.isVisible = false;
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
if (durationSeconds != null && age >= durationSeconds + particleMaxLifetime + 0.35) dispose();
|
|
203
|
-
});
|
|
204
|
-
|
|
205
|
-
function dispose(): void {
|
|
206
|
-
if (disposed) return;
|
|
207
|
-
disposed = true;
|
|
208
|
-
scene.onBeforeRenderObservable.remove(observer);
|
|
209
|
-
for (const state of states) state.sprite.dispose();
|
|
210
|
-
manager.dispose();
|
|
211
|
-
}
|
|
212
|
-
|
|
213
|
-
return { dispose };
|
|
214
|
-
|
|
215
|
-
function spawnPuff(state: SmokeSpriteState, seed: number): void {
|
|
216
|
-
const spawnOrigin = root.getAbsolutePosition();
|
|
217
|
-
const direction = readWorldDirection(root, params);
|
|
218
|
-
const side = makeSideVector(direction);
|
|
219
|
-
const jitterSide = (sequence01(seed, 0) - 0.5) * emitRange;
|
|
220
|
-
const jitterForward = (sequence01(seed, 1) - 0.5) * emitRange * 0.45;
|
|
221
|
-
const startHeight = (sequence01(seed, 2) - 0.5) * emitRange * 0.3;
|
|
222
|
-
const baseSize = smokeSize * lerp(0.56, 1.12, sequence01(seed, 3));
|
|
223
|
-
state.sprite.position = spawnOrigin
|
|
224
|
-
.add(direction.scale(jitterForward))
|
|
225
|
-
.add(side.scale(jitterSide))
|
|
226
|
-
.add(new Vector3(0, startHeight, 0));
|
|
227
|
-
state.sprite.width = baseSize;
|
|
228
|
-
state.sprite.height = baseSize * lerp(0.82, 1.18, sequence01(seed, 4));
|
|
229
|
-
state.sprite.angle = sequence01(seed, 5) * Math.PI * 2;
|
|
230
|
-
state.sprite.cellIndex = Math.floor(sequence01(seed, 6) * 4) % 4;
|
|
231
|
-
state.sprite.color = toColor4(params.color, 0);
|
|
232
|
-
state.sprite.isVisible = true;
|
|
233
|
-
state.velocity = direction
|
|
234
|
-
.scale(driftSpeed * lerp(0.68, 1.18, sequence01(seed, 7)))
|
|
235
|
-
.add(side.scale((sequence01(seed, 8) - 0.5) * driftSpeed * 0.2))
|
|
236
|
-
.add(new Vector3(0, params.riseHeight * effectScale * lerp(0.16, 0.36, sequence01(seed, 9)), 0));
|
|
237
|
-
state.spin = lerp(-0.9, 0.9, sequence01(seed, 10));
|
|
238
|
-
state.width = state.sprite.width;
|
|
239
|
-
state.height = state.sprite.height;
|
|
240
|
-
state.lifetime = Math.min(particleMaxLifetime, puffLifetime * lerp(0.82, 1.18, sequence01(seed, 11)));
|
|
241
|
-
state.alphaScale = lerp(0.72, 1, sequence01(seed, 12));
|
|
242
|
-
state.age = 0;
|
|
243
|
-
state.active = true;
|
|
244
|
-
}
|
|
245
|
-
}
|
|
246
|
-
|
|
247
|
-
function findAvailableState(states: SmokeSpriteState[]): SmokeSpriteState | null {
|
|
248
|
-
return states.find(state => !state.active) ?? null;
|
|
249
|
-
}
|
|
250
|
-
|
|
251
|
-
function readDirection(params: VehicleExhaustSmokeParams): Vector3 {
|
|
252
|
-
const direction = new Vector3(params.directionX, 0, params.directionZ);
|
|
253
|
-
if (direction.lengthSquared() <= 0.0001) return new Vector3(-1, 0, 0);
|
|
254
|
-
return direction.normalize();
|
|
255
|
-
}
|
|
256
|
-
|
|
257
|
-
function readWorldDirection(root: TransformNode, params: VehicleExhaustSmokeParams): Vector3 {
|
|
258
|
-
const direction = Vector3.TransformNormal(readDirection(params), root.getWorldMatrix());
|
|
259
|
-
direction.y = 0;
|
|
260
|
-
if (direction.lengthSquared() <= 0.0001) return readDirection(params);
|
|
261
|
-
return direction.normalize();
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
function readDurationSeconds(params: VehicleExhaustSmokeParams): number | null {
|
|
265
|
-
return params.lifetimeMode === 'infinite' ? null : Math.max(0.05, params.lifetime);
|
|
266
|
-
}
|
|
267
|
-
|
|
268
|
-
function makeSideVector(direction: Vector3): Vector3 {
|
|
269
|
-
const side = new Vector3(-direction.z, 0, direction.x);
|
|
270
|
-
return side.lengthSquared() > 0.0001 ? side.normalize() : new Vector3(0, 0, 1);
|
|
271
|
-
}
|
|
272
|
-
|
|
273
|
-
function getDisposeDelaySeconds(params: VehicleExhaustSmokeParams): number {
|
|
274
|
-
const lifetime = Math.max(0.05, params.lifetime);
|
|
275
|
-
return lifetime + Math.max(0.08, params.particleMaxLifetime) + 0.45;
|
|
276
|
-
}
|
|
277
|
-
|
|
278
|
-
function toColor4(color: VfxColorValue, alpha: number): Color4 {
|
|
279
|
-
return new Color4(clamp01(color.r), clamp01(color.g), clamp01(color.b), clamp01(alpha));
|
|
280
|
-
}
|
|
281
|
-
|
|
282
|
-
function lerp(min: number, max: number, t: number): number {
|
|
283
|
-
return min + (max - min) * t;
|
|
284
|
-
}
|
|
285
|
-
|
|
286
|
-
function clamp01(value: number): number {
|
|
287
|
-
return Math.min(1, Math.max(0, value));
|
|
288
|
-
}
|
|
289
|
-
|
|
290
|
-
function fract(value: number): number {
|
|
291
|
-
return value - Math.floor(value);
|
|
292
|
-
}
|
|
293
|
-
|
|
294
|
-
function sequence01(index: number, axis: number): number {
|
|
295
|
-
if (index === 0) return 0.5;
|
|
296
|
-
const strides = [0.618033988749895, 0.414213562373095, 0.732050807568877, 0.324717957244746, 0.754877666246693, 0.569840290998053];
|
|
297
|
-
return fract(0.5 + index * strides[axis % strides.length] + axis * 0.173205080756888);
|
|
298
|
-
}
|