sclass AudioAdder extends AbstractAudioSample {
  new Cl<IAudioSample> sources;

  // for now same value in all channels
  new TreeMap<Double> additions;
  
  void addSource(IAudioSample source) {
    addUnlessNull(sources, source);
  }
  
  void grabSpecsFromSource(IAudioSample source) {
    if (source == null) ret;
    setSampleRate(source.sampleRate());
    setChannels(source.channels());
  }
  
  void addPlateau(double start, double end, double intensity) {
    if (start >= end) ret;
    
    _changeSumAt(start, intensity);
    _changeSumAt(end, -intensity);
  }
  
  void subtractPlateau(double start, double end, double intensity) {
    addPlateau(start, end, -intensity);
  }

  // We will probably add plateaus rather randomly throughout an area,
  // so could optimize this doing something akin to LogNArray.
  void _changeSumAt(double time, double intensity) {    
    double value = unnull(floorValue(additions, time)) + intensity;
    
    // create, overwrite or delete
    mapPutOrRemove(additions, time, nullIfZero(value));
    
    Double next = additions.higherKey(time);
    while (next != null) {
      additions.put(next, additions.get(next) + intensity);
      next = additions.higherKey(next);
    }
  }
  
  public double readSumTable(int channel, double t) {
    double diff = unnull(floorValue(additions, t));
    for (source : sources) diff += source.readSumTable(channel, t);
    ret diff;
  }
}