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;
}
}