v0.4.0: Gain param, release tail, ping pong all modes, UI polish, relink fix

- Volume replaced with Gain parameter (-100 to +24 dB)
- Release tail (TAIL toggle): audio continues past slice end during release phase
- Ping pong now works in Stretch and Bungee modes (was Repitch only)
- BPM displays up to 2 decimal places with finer drag precision
- M button moved from slicer bar to action panel
- All action/header buttons styled consistently with theme colors
- LOAD/UI buttons taller (28px) to match action row
- Slice info styled like SAMPLE/filename (12pt label + 14pt value)
- AlertWindow for AUTO split themed dark and centered in plugin
- Popup menus centered within plugin window
- Relink (CmdRelinkFile) preserves slices when relinking missing sample
- Serialization v10 with v9 backward compat (linear volume migrated to dB)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: tucktuckg00se

README.md

@@ -20,8 +20,7 @@ A nondestructive, time-stretching, and intersecting sample slicer plugin with in
 - **Duplicate slice** — clone a slice with all its locked parameters
 - **Hi-DPI scaling** — adjustable UI scale factor (0.5x to 3x)
 - **Full state recall** — all parameters, slices, and audio data saved/restored with the DAW session
-- **Dark industrial theme** — styled popup menus and controls
-
+- **Theming** — Dark and light themes
 ## Usage
 
 ### Getting Started
@@ -53,10 +52,11 @@ These are the defaults inherited by all slices:
 - **PITCH** — pitch shift in semitones (-24 to +24)
 - **ALGO** — Repitch (speed=pitch), Stretch (independent pitch/time), or Bungee (granular)
 - **ATK / DEC / SUS / REL** — ADSR amplitude envelope
-- **PP** — ping-pong (reverse) playback
+- **PP** — ping-pong (bounce) playback — works in all algorithm modes (Repitch, Stretch, Bungee)
 - **MUTE** — mute group (voices in the same group cut each other off)
 - **STRETCH** — enable time-stretching (syncs playback to DAW tempo)
-- **VOL** — master volume
+- **GAIN** — master gain in dB (-100 to +24 dB)
+- **TAIL** — release tail — when enabled, audio continues reading past the slice boundary during the release phase
 
 ### Slice Controls (second bar)
 

project/src/PluginProcessor.cpp

@@ -22,6 +22,7 @@ IntersectProcessor::IntersectProcessor()
     formantParam   = apvts.getRawParameterValue (ParamIds::defaultFormant);
     formantCompParam = apvts.getRawParameterValue (ParamIds::defaultFormantComp);
     grainModeParam   = apvts.getRawParameterValue (ParamIds::defaultGrainMode);
+    releaseTailParam = apvts.getRawParameterValue (ParamIds::defaultReleaseTail);
 }
 
 void IntersectProcessor::prepareToPlay (double sampleRate, int /*samplesPerBlock*/)
@@ -151,6 +152,7 @@ void IntersectProcessor::handleCommand (const Command& cmd)
                     case FieldFormantComp: s.formantComp = val > 0.5f; s.lockMask |= kLockFormantComp; break;
                     case FieldGrainMode:  s.grainMode = (int) val;   s.lockMask |= kLockGrainMode;  break;
                     case FieldVolume:     s.volume = val;            s.lockMask |= kLockVolume;    break;
+                    case FieldReleaseTail: s.releaseTail = val > 0.5f; s.lockMask |= kLockReleaseTail; break;
                     case FieldMidiNote:
                         s.midiNote = juce::jlimit (0, 127, (int) val);
                         sliceManager.rebuildMidiMap();
@@ -185,6 +187,7 @@ void IntersectProcessor::handleCommand (const Command& cmd)
                     dst.formantComp     = src.formantComp;
                     dst.grainMode       = src.grainMode;
                     dst.volume          = src.volume;
+                    dst.releaseTail     = src.releaseTail;
                     dst.lockMask        = src.lockMask;
                     dst.colour          = src.colour;
                     // midiNote is already assigned by createSlice
@@ -223,6 +226,15 @@ void IntersectProcessor::handleCommand (const Command& cmd)
             break;
         }
 
+        case CmdRelinkFile:
+            if (sampleData.loadFromFile (cmd.fileParam, currentSampleRate))
+            {
+                sampleMissing.store (false);
+                missingFilePath.clear();
+                sliceManager.rebuildMidiMap();
+            }
+            break;
+
         case CmdNone:
             break;
     }
@@ -279,6 +291,7 @@ void IntersectProcessor::processMidi (juce::MidiBuffer& midi)
                                           formantCompParam->load() > 0.5f,
                                           (int) grainModeParam->load(),
                                           masterVolParam->load(),
+                                          releaseTailParam->load() > 0.5f,
                                           sampleData);
                 }
             }
@@ -339,7 +352,7 @@ void IntersectProcessor::getStateInformation (juce::MemoryBlock& destData)
     juce::MemoryOutputStream stream (destData, false);
 
     // Version
-    stream.writeInt (9);
+    stream.writeInt (10);
 
     // APVTS state
     auto state = apvts.copyState();
@@ -384,6 +397,8 @@ void IntersectProcessor::getStateInformation (juce::MemoryBlock& destData)
         stream.writeInt (s.grainMode);
         // v7 fields
         stream.writeFloat (s.volume);
+        // v10 fields
+        stream.writeBool (s.releaseTail);
     }
 
     // v9: store file path only (no PCM)
@@ -396,14 +411,26 @@ void IntersectProcessor::setStateInformation (const void* data, int sizeInBytes)
     juce::MemoryInputStream stream (data, (size_t) sizeInBytes, false);
 
     int version = stream.readInt();
-    if (version < 9)
+    if (version < 9 || version > 10)
         return;
 
     // APVTS state
     auto xmlString = stream.readString();
     if (auto xml = juce::parseXML (xmlString))
         apvts.replaceState (juce::ValueTree::fromXml (*xml));
 
+    // v9 -> v10 migration: convert APVTS masterVolume from linear (0-1) to dB
+    if (version == 9)
+    {
+        float oldLinVol = masterVolParam->load();
+        // Old range was 0-1, but APVTS loaded it as-is into new -100..+24 range
+        // So the stored value will be the raw 0-1 value. Convert to dB.
+        float dbVal = (oldLinVol <= 0.0f) ? -100.0f : 20.0f * std::log10 (oldLinVol);
+        dbVal = juce::jlimit (-100.0f, 24.0f, dbVal);
+        if (auto* p = apvts.getParameter (ParamIds::masterVolume))
+            p->setValueNotifyingHost (p->convertTo0to1 (dbVal));
+    }
+
     // UI state
     zoom.store (stream.readFloat());
     scroll.store (stream.readFloat());
@@ -439,6 +466,21 @@ void IntersectProcessor::setStateInformation (const void* data, int sizeInBytes)
         s.formantComp     = stream.readBool();
         s.grainMode = stream.readInt();
         s.volume = stream.readFloat();
+
+        if (version >= 10)
+        {
+            s.releaseTail = stream.readBool();
+        }
+
+        // v9 -> v10 migration: convert linear volume (0-1) to dB
+        if (version == 9)
+        {
+            float linVol = s.volume;
+            if (linVol <= 0.0f)
+                s.volume = -100.0f;
+            else
+                s.volume = 20.0f * std::log10 (linVol);
+        }
     }
 
     // Path-based sample restore

project/src/PluginProcessor.h

@@ -48,6 +48,7 @@ class IntersectProcessor : public juce::AudioProcessor
         CmdSetSliceParam,
         CmdDuplicateSlice,
         CmdSplitSlice,
+        CmdRelinkFile,
     };
 
     // Param field identifiers for CmdSetSliceParam
@@ -69,6 +70,7 @@ class IntersectProcessor : public juce::AudioProcessor
         FieldFormantComp,
         FieldGrainMode,
         FieldVolume,
+        FieldReleaseTail,
     };
 
     struct Command
@@ -132,6 +134,7 @@ class IntersectProcessor : public juce::AudioProcessor
     std::atomic<float>* formantParam    = nullptr;
     std::atomic<float>* formantCompParam = nullptr;
     std::atomic<float>* grainModeParam   = nullptr;
+    std::atomic<float>* releaseTailParam = nullptr;
 
     JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (IntersectProcessor)
 };

project/src/audio/Slice.h

@@ -18,7 +18,8 @@ enum LockBit : uint32_t
     kLockFormant       = 2048,
     kLockFormantComp   = 4096,
     kLockGrainMode     = 8192,
-    kLockVolume        = 16384
+    kLockVolume        = 16384,
+    kLockReleaseTail   = 32768
 };
 
 struct Slice
@@ -41,7 +42,8 @@ struct Slice
     float    formantSemitones = 0.0f;
     bool     formantComp   = false;
     int      grainMode     = 0;       // Bungee: -1=Fast, 0=Normal, +1=Smooth
-    float    volume        = 1.0f;
+    float    volume        = 0.0f;
+    bool     releaseTail   = false;
     uint32_t lockMask      = 0;
     juce::Colour colour    { 0.4f, 0.7f, 0.95f, 1.0f };
 };

project/src/audio/Voice.h

@@ -30,6 +30,8 @@ struct Voice
     int          age          = 0;
     bool         looping      = false;
     float        volume       = 1.0f;
+    bool         releaseTail  = false;
+    int          sampleEnd    = 0;       // actual end of sample buffer (for release tail)
 
     // WSOLA fields (legacy, still used for basic WSOLA fallback)
     bool         wsolaActive  = false;

project/src/audio/VoicePool.cpp

@@ -11,6 +11,12 @@
 
 static constexpr int kStretchBlockSize = 128;
 
+static inline float dbToLinear (float dB)
+{
+    if (dB <= -100.0f) return 0.0f;
+    return std::pow (10.0f, dB / 20.0f);
+}
+
 VoicePool::VoicePool()
 {
     for (auto& p : voicePositions)
@@ -112,6 +118,7 @@ void VoicePool::startVoice (int voiceIdx, int sliceIdx, float velocity, int note
                             bool globalStretchEnabled, float dawBpmVal,
                             float globalTonality, float globalFormant, bool globalFormantComp,
                             int globalGrainMode, float globalVolume,
+                            bool globalReleaseTail,
                             const SampleData& sample)
 {
     auto& v = voices[voiceIdx];
@@ -161,7 +168,12 @@ void VoicePool::startVoice (int voiceIdx, int sliceIdx, float velocity, int note
     // Convert grainMode choice index (0=Fast, 1=Normal, 2=Smooth) to log2 hop adjust (-1, 0, +1)
     int hopAdj = grainMode - 1;
 
-    v.volume = sm.resolveParam (sliceIdx, kLockVolume, s.volume, globalVolume);
+    v.volume = dbToLinear (sm.resolveParam (sliceIdx, kLockVolume, s.volume, globalVolume));
+
+    v.releaseTail = sm.resolveParam (sliceIdx, kLockReleaseTail,
+                                      s.releaseTail ? 1.0f : 0.0f,
+                                      globalReleaseTail ? 1.0f : 0.0f) > 0.5f;
+    v.sampleEnd = sample.getNumFrames();
 
     // Reset stretch state
     v.stretchActive = false;
@@ -260,17 +272,23 @@ static void fillStretchBlock (Voice& v, const SampleData& sample)
     for (int i = 0; i < inputSamples; ++i)
     {
         double pos = v.stretchSrcPos;
+        // Clamp to sample buffer bounds for safety
+        pos = juce::jlimit (0.0, (double) v.sampleEnd - 1, pos);
         v.stretchInBufL[(size_t) i] = sample.getInterpolatedSample (pos, 0);
         v.stretchInBufR[(size_t) i] = sample.getInterpolatedSample (pos, 1);
-        v.stretchSrcPos += 1.0;
+        v.stretchSrcPos += (double) v.direction;
 
         // Check bounds
-        if (v.stretchSrcPos >= v.endSample)
+        if (v.direction > 0 && v.stretchSrcPos >= v.endSample)
         {
             if (v.pingPong)
             {
                 v.stretchSrcPos = v.endSample - 1;
-                // For simplicity, just clamp — ping-pong with stretch is edge case
+                v.direction = -1;
+            }
+            else if (v.releaseTail && v.stretchSrcPos < v.sampleEnd)
+            {
+                // Continue reading beyond slice end during release tail
             }
             else
             {
@@ -286,6 +304,14 @@ static void fillStretchBlock (Voice& v, const SampleData& sample)
                 break;
             }
         }
+        else if (v.direction < 0 && v.stretchSrcPos <= v.startSample)
+        {
+            if (v.pingPong)
+            {
+                v.stretchSrcPos = v.startSample;
+                v.direction = 1;
+            }
+        }
     }
 
     v.stretchOutBufL.resize (kStretchBlockSize);
@@ -305,6 +331,21 @@ static void fillBungeeBlock (Voice& v, const SampleData& sample)
     if (! v.bungeeStretcher)
         return;
 
+    // Ping pong boundary checks before requesting next grain
+    if (v.pingPong)
+    {
+        if (v.bungeeSpeed > 0.0 && v.bungeeSrcPos >= v.endSample)
+        {
+            v.bungeeSrcPos = v.endSample - 1;
+            v.bungeeSpeed = -std::abs (v.bungeeSpeed);
+        }
+        else if (v.bungeeSpeed < 0.0 && v.bungeeSrcPos <= v.startSample)
+        {
+            v.bungeeSrcPos = v.startSample;
+            v.bungeeSpeed = std::abs (v.bungeeSpeed);
+        }
+    }
+
     auto& stretcher = *v.bungeeStretcher;
 
     // Set up the request for this grain
@@ -327,13 +368,16 @@ static void fillBungeeBlock (Voice& v, const SampleData& sample)
     int maxIn = stretcher.maxInputFrameCount();
     v.bungeeInputBuf.resize ((size_t) maxIn * 2);
 
+    // Determine effective end for reading (release tail allows reading past slice end)
+    int effectiveEnd = v.releaseTail && !v.pingPong ? v.sampleEnd : v.endSample;
+
     // Fill input buffer (non-interleaved: ch0 then ch1)
     for (int i = 0; i < numFrames; ++i)
     {
         double pos = inputChunk.begin + i;
 
         float sL = 0.0f, sR = 0.0f;
-        if (pos >= v.startSample && pos < v.endSample)
+        if (pos >= v.startSample && pos < effectiveEnd)
         {
             sL = sample.getInterpolatedSample (pos, 0);
             sR = sample.getInterpolatedSample (pos, 1);
@@ -346,8 +390,8 @@ static void fillBungeeBlock (Voice& v, const SampleData& sample)
     int muteHead = 0, muteTail = 0;
     if (inputChunk.begin < v.startSample)
         muteHead = v.startSample - inputChunk.begin;
-    if (inputChunk.end > v.endSample)
-        muteTail = inputChunk.end - v.endSample;
+    if (inputChunk.end > effectiveEnd)
+        muteTail = inputChunk.end - effectiveEnd;
 
     stretcher.analyseGrain (v.bungeeInputBuf.data(), (intptr_t) maxIn, muteHead, muteTail);
 
@@ -407,10 +451,24 @@ void VoicePool::processSample (const SampleData& sample, double sampleRate,
             // Fill output buffer if empty
             if (v.stretchOutReadPos >= v.stretchOutAvail)
             {
-                if (v.stretchSrcPos >= v.endSample && !v.pingPong)
+                bool pastEnd = (v.direction > 0)
+                    ? (v.stretchSrcPos >= v.endSample)
+                    : (v.stretchSrcPos <= v.startSample);
+
+                if (pastEnd && !v.pingPong)
                 {
-                    if (v.envelope.getState() != AdsrEnvelope::Release)
-                        v.envelope.noteOff();
+                    if (v.releaseTail && v.stretchSrcPos < v.sampleEnd && v.stretchSrcPos >= 0)
+                    {
+                        // Release tail: trigger noteOff but keep filling
+                        if (v.envelope.getState() != AdsrEnvelope::Release)
+                            v.envelope.noteOff();
+                        fillStretchBlock (v, sample);
+                    }
+                    else
+                    {
+                        if (v.envelope.getState() != AdsrEnvelope::Release)
+                            v.envelope.noteOff();
+                    }
                 }
                 else
                 {
@@ -444,10 +502,23 @@ void VoicePool::processSample (const SampleData& sample, double sampleRate,
             // Fill output buffer if empty
             if (v.bungeeOutReadPos >= v.bungeeOutAvail)
             {
-                if (v.bungeeSrcPos >= v.endSample && !v.pingPong)
+                bool pastEnd = (v.bungeeSpeed > 0.0)
+                    ? (v.bungeeSrcPos >= v.endSample)
+                    : (v.bungeeSrcPos <= v.startSample);
+
+                if (pastEnd && !v.pingPong)
                 {
-                    if (v.envelope.getState() != AdsrEnvelope::Release)
-                        v.envelope.noteOff();
+                    if (v.releaseTail && v.bungeeSrcPos < v.sampleEnd && v.bungeeSrcPos >= 0)
+                    {
+                        if (v.envelope.getState() != AdsrEnvelope::Release)
+                            v.envelope.noteOff();
+                        fillBungeeBlock (v, sample);
+                    }
+                    else
+                    {
+                        if (v.envelope.getState() != AdsrEnvelope::Release)
+                            v.envelope.noteOff();
+                    }
                 }
                 else
                 {
@@ -517,6 +588,12 @@ void VoicePool::processSample (const SampleData& sample, double sampleRate,
                         if (newPos < v.startSample)
                             newPos += len;
                     }
+                    else if (v.releaseTail && newPos >= v.endSample && newPos < v.sampleEnd)
+                    {
+                        // Release tail: trigger noteOff but keep reading beyond slice end
+                        if (v.envelope.getState() != AdsrEnvelope::Release)
+                            v.envelope.noteOff();
+                    }
                     else
                     {
                         if (v.envelope.getState() != AdsrEnvelope::Release)

project/src/audio/VoicePool.h

@@ -21,6 +21,7 @@ class VoicePool
                      bool globalStretchEnabled, float dawBpm,
                      float globalTonality, float globalFormant, bool globalFormantComp,
                      int globalGrainMode, float globalVolume,
+                     bool globalReleaseTail,
                      const SampleData& sample);
 
     void releaseNote (int note);