WarpControl.java

package sidplay.player;

import java.util.function.Consumer;
import java.util.function.LongSupplier;

import static java.util.concurrent.TimeUnit.SECONDS;

/**
 * Player-thread policy for bounded automatic WARP and explicit manual control. Host time is checked by the player loop,
 * including while paused: neither loader recognition nor the emulated clock can keep automatic WARP enabled forever.
 */
public final class WarpControl {
    private final LongSupplier nanoTime;
    private final Consumer<Boolean> apply;
    private volatile boolean active;
    private boolean automatic;
    private long deadline;

    public WarpControl(LongSupplier nanoTime, Consumer<Boolean> apply) {
        this.nanoTime = nanoTime;
        this.apply = apply;
    }

    public static void validateTimeout(int seconds) {
        if (seconds < 1 || seconds > 3600)
            throw new IllegalArgumentException("Startup WARP timeout must be 1..3600 seconds");
    }

    public boolean isActive() {
        return active;
    }

    public boolean isAutomatic() {
        return automatic;
    }

    public void start(int seconds) {
        validateTimeout(seconds);
        automatic = true;
        deadline = nanoTime.getAsLong() + SECONDS.toNanos(seconds);
        change(true);
    }

    /**
     * A manual request cancels automation, including an earlier startup's deadline.
     */
    public void setManual(boolean enabled) {
        automatic = false;
        change(enabled);
    }

    public void finishStartup() {
        if (automatic) setManual(false);
    }

    public void poll() {
        if (automatic && nanoTime.getAsLong() - deadline >= 0) finishStartup();
    }

    private void change(boolean enabled) {
        if (active == enabled) return;
        active = enabled;
        apply.accept(enabled);
    }
}