TraceHistory.java

package libsidutils.oscilloscope;

import java.util.Arrays;

/**
 * Emulator-owned ring of minimum/maximum values per display column. Keeping both extrema preserves short peaks when
 * many samples share a column. Renderers read copied snapshots and never advance or reset this history.
 */
public final class TraceHistory {
    public static final TraceHistory EMPTY = new TraceHistory(1);
    private final float[] minimum, maximum;
    private final int mask;
    private int position;

    public TraceHistory(int capacity) {
        if (Integer.bitCount(capacity) != 1) {
            throw new IllegalArgumentException("Capacity must be a power of two");
        }
        minimum = new float[capacity];
        maximum = new float[capacity];
        mask = capacity - 1;
    }

    public void accumulate(float value) {
        if (value < minimum[position]) {
            minimum[position] = value;
        }
        if (value > maximum[position]) {
            maximum[position] = value;
        }
    }

    public void advance() {
        // Invert the previous extrema to seed the next column without clearing
        // the ring or losing continuity when the signal crosses a column boundary.
        float min = minimum[position], max = maximum[position];
        position = position + 1 & mask;
        minimum[position] = max;
        maximum[position] = min;
    }

    public float minimum(int back) {
        return minimum[position - back & mask];
    }

    public float maximum(int back) {
        return maximum[position - back & mask];
    }

    public void reset() {
        Arrays.fill(minimum, 0);
        Arrays.fill(maximum, 0);
        position = 0;
    }
}