Optimize resource usage in waveform generation and image cache

- Replace sleep-based polling in waveform generation with channel-based
  synchronization to reduce CPU usage and improve responsiveness
- Add sync.Pool for audio buffers in waveform analysis to reduce memory
  allocations
- Fix critical bug in ImageCache where struct field updates were not
  being persisted to the map, causing LRU tracking to fail
- Optimize ImageCache evictOne() to use single pass instead of two
  separate iterations through all cache items
- Upgrade read locks to write locks in ImageCache Get methods to ensure
  struct updates are properly saved
This commit is contained in:
Gianluca Boiano
2026-02-01 22:29:28 +01:00
parent 53b91f5d43
commit 43e8d0a453
2 changed files with 72 additions and 26 deletions
+33 -18
View File
@@ -51,11 +51,13 @@ func (i *ImageCache) SetWithTTL(key string, val image.Image, ttl time.Duration)
i.mu.Lock()
defer i.mu.Unlock()
now := time.Now().Unix()
if v, ok := i.cache[key]; ok {
v.val = val
v.ttl = ttl
v.expiresAt = time.Now().Add(v.ttl).Unix()
v.lastAccessed = time.Now().Unix()
v.lastAccessed = now
i.cache[key] = v // Update the map with modified struct
return
}
if len(i.cache) == i.MaxSize {
@@ -65,7 +67,7 @@ func (i *ImageCache) SetWithTTL(key string, val image.Image, ttl time.Duration)
val: val,
ttl: ttl,
expiresAt: time.Now().Add(ttl).Unix(),
lastAccessed: time.Now().Unix(),
lastAccessed: now,
}
}
@@ -86,14 +88,15 @@ func (i *ImageCache) Get(key string) (image.Image, error) {
}
func (i *ImageCache) GetResetTTL(key string, resetTTL bool) (image.Image, error) {
i.mu.RLock()
defer i.mu.RUnlock()
i.mu.Lock()
defer i.mu.Unlock()
if v, ok := i.cache[key]; ok {
v.lastAccessed = time.Now().Unix()
if resetTTL {
v.expiresAt = time.Now().Add(v.ttl).Unix()
}
i.cache[key] = v // Update the map with modified struct
return v.val, nil
}
return nil, ErrNotFound
@@ -101,26 +104,29 @@ func (i *ImageCache) GetResetTTL(key string, resetTTL bool) (image.Image, error)
// Gets the image if it exists and extends TTL to time.Now + ttl iff the image would expire before then
func (i *ImageCache) GetExtendTTL(key string, ttl time.Duration) (image.Image, error) {
i.mu.RLock()
defer i.mu.RUnlock()
i.mu.Lock()
defer i.mu.Unlock()
if v, ok := i.cache[key]; ok {
v.lastAccessed = time.Now().Unix()
if v.expiresAt < time.Now().Add(ttl).Unix() {
v.expiresAt = time.Now().Add(ttl).Unix()
newExpiry := time.Now().Add(ttl).Unix()
if v.expiresAt < newExpiry {
v.expiresAt = newExpiry
}
i.cache[key] = v // Update the map with modified struct
return v.val, nil
}
return nil, ErrNotFound
}
func (i *ImageCache) GetWithNewTTL(key string, newTtl time.Duration) (image.Image, error) {
i.mu.RLock()
defer i.mu.RUnlock()
i.mu.Lock()
defer i.mu.Unlock()
if v, ok := i.cache[key]; ok {
v.lastAccessed = time.Now().Unix()
v.expiresAt = time.Now().Add(newTtl).Unix()
v.ttl = newTtl
i.cache[key] = v // Update the map with modified struct
return v.val, nil
}
return nil, ErrNotFound
@@ -137,24 +143,33 @@ func (i *ImageCache) Clear() {
func (i *ImageCache) evictOne() {
now := time.Now().Unix()
var lruKey string
lruTime := now
lruTime := now + 1 // Initialize to future time so any item will be less
var lruExpiredKey string
lruExpiredTime := now
lruExpiredTime := now + 1 // Initialize to future time
hasExpired := false
// Single pass through the cache to find both LRU expired and LRU items
for k, v := range i.cache {
if v.expiresAt < now && v.lastAccessed < lruExpiredTime {
lruExpiredTime = v.lastAccessed
lruExpiredKey = k
if v.expiresAt < now {
// This item is expired
if v.lastAccessed < lruExpiredTime {
lruExpiredTime = v.lastAccessed
lruExpiredKey = k
hasExpired = true
}
}
// Track LRU regardless of expiration
if v.lastAccessed < lruTime {
lruTime = v.lastAccessed
lruKey = k
}
}
if lruExpiredTime < now {
// deleting LRU expired item
if hasExpired {
// Prefer deleting LRU expired item
delete(i.cache, lruExpiredKey)
} else {
// no expired items, delete LRU non-expired item
// No expired items, delete LRU non-expired item
delete(i.cache, lruKey)
}
}
+39 -8
View File
@@ -25,6 +25,13 @@ type WaveformImageGenerator struct {
audioCache *AudioCache
}
// Buffer pool for waveform analysis to reduce allocations
var audioBufferPool = sync.Pool{
New: func() any {
return &audio.IntBuffer{Data: make([]int, 4096)}
},
}
type WaveformImage = image.NRGBA
func NewWaveformImage() *WaveformImage {
@@ -192,13 +199,19 @@ func (w *WaveformImageGenerator) StartWaveformGeneration(item *mediaprovider.Tra
}
// Start analyzing the converted wav file
data := &waveformData{}
data := &waveformData{notify: make(chan struct{}, 1)}
go func() {
err := analyzeWavFile(ctx, transcodeFile, data, item.Duration.Milliseconds(), func() bool { return wavConvertDone })
if err != nil {
job.setError(err)
}
data.done = true
// Final notification that processing is complete
select {
case data.notify <- struct{}{}:
default:
}
close(data.notify)
}()
// Start generating the waveform image
@@ -216,6 +229,7 @@ type waveformData struct {
progress int // first invalid index for Peak/RMS data
done bool
notify chan struct{} // signals when new data is available
}
func generateWaveformImage(ctx context.Context, data *waveformData, job *WaveformImageJob) {
@@ -227,14 +241,18 @@ func generateWaveformImage(ctx context.Context, data *waveformData, job *Wavefor
translucentColor := color.NRGBA{R: 255, G: 255, B: 255, A: 128}
for x := range 1024 {
for data.progress <= x {
if data.done {
return
}
if ctx.Err() != nil {
// Wait for data to be available instead of polling
for data.progress <= x && !data.done {
select {
case <-ctx.Done():
return // expired
case <-data.notify:
// New data available or processing complete
}
time.Sleep(50 * time.Millisecond)
}
if data.progress <= x {
return // done but data not available for this x
}
rmsPixels := int(data.RMS[x]) * centerY / 255
@@ -282,7 +300,10 @@ func analyzeWavFile(ctx context.Context, transcodeFile string, data *waveformDat
return err
}
buf := &audio.IntBuffer{Data: make([]int, 4096)}
// Get buffer from pool to reduce allocations
buf := audioBufferPool.Get().(*audio.IntBuffer)
defer audioBufferPool.Put(buf)
curChunk := 0
chunkSamples := make([]float64, 0, samplesPerChunk)
bytesPerSample := int64(2 * format.NumChannels) // 16-bit = 2 bytes per channel
@@ -353,6 +374,11 @@ func analyzeWavFile(ctx context.Context, transcodeFile string, data *waveformDat
}
curChunk++
data.progress = curChunk
// Notify that new data is available (non-blocking)
select {
case data.notify <- struct{}{}:
default:
}
chunkSamples = chunkSamples[:0]
if curChunk >= 1024 {
break
@@ -367,6 +393,11 @@ func analyzeWavFile(ctx context.Context, transcodeFile string, data *waveformDat
data.Peak[curChunk] = float64ToByte(peak)
data.RMS[curChunk] = float64ToByte(rms)
data.progress = curChunk + 1
// Notify that final data is available (non-blocking)
select {
case data.notify <- struct{}{}:
default:
}
}
return nil