ParticleEngine.java

net.minecraft.client.particle.ParticleEngine

信息

• 全限定名：net.minecraft.client.particle.ParticleEngine
• 类型：public class
• 包：net.minecraft.client.particle
• 源码路径：src/main/java/net/minecraft/client/particle/ParticleEngine.java
• 起始行号：L26
• 职责：

  TODO

字段/常量

• RENDER_ORDER

  • 类型: List<ParticleRenderType>
  • 修饰符: private static final
  • 源码定位: L27
  • 说明:

    TODO

• level

  • 类型: ClientLevel
  • 修饰符: protected
  • 源码定位: L30
  • 说明:

    TODO

• particles

  • 类型: Map<ParticleRenderType,ParticleGroup<?>>
  • 修饰符: private final
  • 源码定位: L31
  • 说明:

    TODO

• trackingEmitters

  • 类型: Queue<TrackingEmitter>
  • 修饰符: private final
  • 源码定位: L32
  • 说明:

    TODO

• particlesToAdd

  • 类型: Queue<Particle>
  • 修饰符: private final
  • 源码定位: L33
  • 说明:

    TODO

• trackedParticleCounts

  • 类型: Object2IntOpenHashMap<ParticleLimit>
  • 修饰符: private final
  • 源码定位: L34
  • 说明:

    TODO

• resourceManager

  • 类型: ParticleResources
  • 修饰符: private final
  • 源码定位: L35
  • 说明:

    TODO

• random

  • 类型: RandomSource
  • 修饰符: private final
  • 源码定位: L36
  • 说明:

    TODO

内部类/嵌套类型

• 无

构造器

public ParticleEngine(ClientLevel level, ParticleResources resourceManager) @ L38

• 构造器名：ParticleEngine
• 源码定位：L38
• 修饰符：public

参数:

• level: ClientLevel
• resourceManager: ParticleResources

说明:

TODO

方法

下面的方法块按源码顺序生成。

public void createTrackingEmitter(Entity entity, ParticleOptions particle) @ L43

• 方法名：createTrackingEmitter
• 源码定位：L43
• 返回类型：void
• 修饰符：public

参数:

• entity: Entity
• particle: ParticleOptions

说明:

TODO

public void createTrackingEmitter(Entity entity, ParticleOptions particle, int lifeTime) @ L47

• 方法名：createTrackingEmitter
• 源码定位：L47
• 返回类型：void
• 修饰符：public

参数:

• entity: Entity
• particle: ParticleOptions
• lifeTime: int

说明:

TODO

public Particle createParticle(ParticleOptions options, double x, double y, double z, double xa, double ya, double za) @ L51

• 方法名：createParticle
• 源码定位：L51
• 返回类型：Particle
• 修饰符：public

参数:

• options: ParticleOptions
• x: double
• y: double
• z: double
• xa: double
• ya: double
• za: double

说明:

TODO

private <T extends ParticleOptions> Particle makeParticle(T options, double x, double y, double z, double xa, double ya, double za) @ L61

• 方法名：makeParticle
• 源码定位：L61
• 返回类型： Particle
• 修饰符：private

参数:

• options: T
• x: double
• y: double
• z: double
• xa: double
• ya: double
• za: double

说明:

TODO

public void add(Particle p) @ L66

• 方法名：add
• 源码定位：L66
• 返回类型：void
• 修饰符：public

参数:

• p: Particle

说明:

TODO

public void tick() @ L78

• 方法名：tick
• 源码定位：L78
• 返回类型：void
• 修饰符：public

参数:

• 无

说明:

TODO

private ParticleGroup<?> createParticleGroup(ParticleRenderType type) @ L105

• 方法名：createParticleGroup
• 源码定位：L105
• 返回类型：ParticleGroup<?>
• 修饰符：private

参数:

• type: ParticleRenderType

说明:

TODO

protected void updateCount(ParticleLimit limit, int change) @ L115

• 方法名：updateCount
• 源码定位：L115
• 返回类型：void
• 修饰符：protected

参数:

• limit: ParticleLimit
• change: int

说明:

TODO

public void extract(ParticlesRenderState particlesRenderState, Frustum frustum, Camera camera, float partialTickTime) @ L119

• 方法名：extract
• 源码定位：L119
• 返回类型：void
• 修饰符：public

参数:

• particlesRenderState: ParticlesRenderState
• frustum: Frustum
• camera: Camera
• partialTickTime: float

说明:

TODO

public void setLevel(ClientLevel level) @ L128

• 方法名：setLevel
• 源码定位：L128
• 返回类型：void
• 修饰符：public

参数:

• level: ClientLevel

说明:

TODO

public String countParticles() @ L134

• 方法名：countParticles
• 源码定位：L134
• 返回类型：String
• 修饰符：public

参数:

• 无

说明:

TODO

private boolean hasSpaceInParticleLimit(ParticleLimit limit) @ L138

• 方法名：hasSpaceInParticleLimit
• 源码定位：L138
• 返回类型：boolean
• 修饰符：private

参数:

• limit: ParticleLimit

说明:

TODO

public void clearParticles() @ L142

• 方法名：clearParticles
• 源码定位：L142
• 返回类型：void
• 修饰符：public

参数:

• 无

说明:

TODO

代码

@OnlyIn(Dist.CLIENT)
public class ParticleEngine {
    private static final List<ParticleRenderType> RENDER_ORDER = List.of(
        ParticleRenderType.SINGLE_QUADS, ParticleRenderType.ITEM_PICKUP, ParticleRenderType.ELDER_GUARDIANS
    );
    protected ClientLevel level;
    private final Map<ParticleRenderType, ParticleGroup<?>> particles = Maps.newIdentityHashMap();
    private final Queue<TrackingEmitter> trackingEmitters = Queues.newArrayDeque();
    private final Queue<Particle> particlesToAdd = Queues.newArrayDeque();
    private final Object2IntOpenHashMap<ParticleLimit> trackedParticleCounts = new Object2IntOpenHashMap<>();
    private final ParticleResources resourceManager;
    private final RandomSource random = RandomSource.create();
 
    public ParticleEngine(ClientLevel level, ParticleResources resourceManager) {
        this.level = level;
        this.resourceManager = resourceManager;
    }
 
    public void createTrackingEmitter(Entity entity, ParticleOptions particle) {
        this.trackingEmitters.add(new TrackingEmitter(this.level, entity, particle));
    }
 
    public void createTrackingEmitter(Entity entity, ParticleOptions particle, int lifeTime) {
        this.trackingEmitters.add(new TrackingEmitter(this.level, entity, particle, lifeTime));
    }
 
    public @Nullable Particle createParticle(ParticleOptions options, double x, double y, double z, double xa, double ya, double za) {
        Particle particle = this.makeParticle(options, x, y, z, xa, ya, za);
        if (particle != null) {
            this.add(particle);
            return particle;
        } else {
            return null;
        }
    }
 
    private <T extends ParticleOptions> @Nullable Particle makeParticle(T options, double x, double y, double z, double xa, double ya, double za) {
        ParticleProvider<T> provider = (ParticleProvider<T>)this.resourceManager.getProviders().get(BuiltInRegistries.PARTICLE_TYPE.getId(options.getType()));
        return provider == null ? null : provider.createParticle(options, this.level, x, y, z, xa, ya, za, this.random);
    }
 
    public void add(Particle p) {
        Optional<ParticleLimit> limit = p.getParticleLimit();
        if (limit.isPresent()) {
            if (this.hasSpaceInParticleLimit(limit.get())) {
                this.particlesToAdd.add(p);
                this.updateCount(limit.get(), 1);
            }
        } else {
            this.particlesToAdd.add(p);
        }
    }
 
    public void tick() {
        this.particles.forEach((type, group) -> {
            Profiler.get().push(type.name());
            group.tickParticles();
            Profiler.get().pop();
        });
        if (!this.trackingEmitters.isEmpty()) {
            List<TrackingEmitter> removed = Lists.newArrayList();
 
            for (TrackingEmitter emitter : this.trackingEmitters) {
                emitter.tick();
                if (!emitter.isAlive()) {
                    removed.add(emitter);
                }
            }
 
            this.trackingEmitters.removeAll(removed);
        }
 
        Particle particle;
        if (!this.particlesToAdd.isEmpty()) {
            while ((particle = this.particlesToAdd.poll()) != null) {
                this.particles.computeIfAbsent(particle.getGroup(), this::createParticleGroup).add(particle);
            }
        }
    }
 
    private ParticleGroup<?> createParticleGroup(ParticleRenderType type) {
        if (type == ParticleRenderType.ITEM_PICKUP) {
            return new ItemPickupParticleGroup(this);
        } else if (type == ParticleRenderType.ELDER_GUARDIANS) {
            return new ElderGuardianParticleGroup(this);
        } else {
            return (ParticleGroup<?>)(type == ParticleRenderType.NO_RENDER ? new NoRenderParticleGroup(this) : new QuadParticleGroup(this, type));
        }
    }
 
    protected void updateCount(ParticleLimit limit, int change) {
        this.trackedParticleCounts.addTo(limit, change);
    }
 
    public void extract(ParticlesRenderState particlesRenderState, Frustum frustum, Camera camera, float partialTickTime) {
        for (ParticleRenderType particleType : RENDER_ORDER) {
            ParticleGroup<?> particles = this.particles.get(particleType);
            if (particles != null && !particles.isEmpty()) {
                particlesRenderState.add(particles.extractRenderState(frustum, camera, partialTickTime));
            }
        }
    }
 
    public void setLevel(@Nullable ClientLevel level) {
        this.level = level;
        this.clearParticles();
        this.trackingEmitters.clear();
    }
 
    public String countParticles() {
        return String.valueOf(this.particles.values().stream().mapToInt(ParticleGroup::size).sum());
    }
 
    private boolean hasSpaceInParticleLimit(ParticleLimit limit) {
        return this.trackedParticleCounts.getInt(limit) < limit.limit();
    }
 
    public void clearParticles() {
        this.particles.clear();
        this.particlesToAdd.clear();
        this.trackingEmitters.clear();
        this.trackedParticleCounts.clear();
    }
}

引用的其他类

• Camera

  • 引用位置: 参数

• ClientLevel

  • 引用位置: 参数/字段

• ElderGuardianParticleGroup

  • 引用位置: 构造调用
  • 关联成员: ElderGuardianParticleGroup()

• ItemPickupParticleGroup

  • 引用位置: 构造调用
  • 关联成员: ItemPickupParticleGroup()

• NoRenderParticleGroup

  • 引用位置: 构造调用
  • 关联成员: NoRenderParticleGroup()

• Particle

  • 引用位置: 参数/字段/返回值

• ParticleGroup

  • 引用位置: 字段/返回值

• ParticleRenderType

  • 引用位置: 参数/字段

• ParticleResources

  • 引用位置: 参数/字段

• QuadParticleGroup

  • 引用位置: 构造调用
  • 关联成员: QuadParticleGroup()

• TrackingEmitter

  • 引用位置: 字段/构造调用
  • 关联成员: TrackingEmitter()

• Frustum

  • 引用位置: 参数

• ParticlesRenderState

  • 引用位置: 参数

• ParticleLimit

  • 引用位置: 参数/字段

• ParticleOptions

  • 引用位置: 参数/返回值

• RandomSource

  • 引用位置: 字段/方法调用
  • 关联成员: RandomSource.create()

• Profiler

  • 引用位置: 方法调用
  • 关联成员: Profiler.get()

• Entity

  • 引用位置: 参数