🔌 Plugin Validation - Tests de Conformidad

🎯 Bypass Test (Null Test)

El test más importante:

[Input] → [Plugin bypassed] → [Output]

Output debe ser BIT-IDENTICAL a Input

Criterio: Output === Input (bit-perfect) Tolerancia: CERO Razón: Processing leak en bypass es bug crítico

🎚️ Automation Smoothness

Validar:

• Parameter changes sin clicks audibles
• Ramping suave (no discontinuidades)
• Smooth tanto para cambios lentos como rápidos

Métricas:

// Derivada del parámetro debe ser limitada
float maxDerivative = calculateMaxDerivative(parameterRamp);
assert(maxDerivative < SMOOTHING_THRESHOLD);

// No zero-crossings abruptas en señal
bool hasClickArtifacts = detectTransientArtifacts(outputBuffer);
assert(!hasClickArtifacts);

Target: Inaudible bajo cualquier material musical

💾 State Recall (Serialization)

Test protocol:

1. Set todos parámetros a valores únicos/random
2. Serialize estado completo
3. Create nueva instancia de plugin
4. Deserialize estado
5. Comparar: todos parámetros deben ser idénticos

Criterio: 100% accuracy Include: Parámetros, estado interno, buffers

📊 Parameter Ranges

Validar:

// Min/max respetados
setParameter(ID, value);
assert(getParameter(ID) >= minValue);
assert(getParameter(ID) <= maxValue);

// Clamping correcto
setParameter(ID, maxValue + 1000.0f);
assert(getParameter(ID) == maxValue);

// Out-of-range handled gracefully (no crash)
setParameter(ID, NaN);          // Must not crash
setParameter(ID, Infinity);      // Must not crash

✅ Host Compliance

VST3 Specific:

• ✅ IAudioProcessor::process() thread-safe
• ✅ IEditController en thread separado
• ✅ Latency reporting correcto
• ✅ Tail time reporting (para reverbs, delays)
• ✅ Preset management funcionando

AU Specific (macOS):

• ✅ AudioUnitInitialize() success
• ✅ Stream format handling
• ✅ Property listeners funcionando
• ✅ Carbon/Cocoa UI validado

AAX Specific (Pro Tools):

• ✅ Stem format support
• ✅ Sidechain routing
• ✅ Delay compensation
• ✅ AudioSuite offline processing

🔄 Concurrency & Thread Safety

Critical tests:

// Simultaneous parameter changes desde UI y automation
std::thread uiThread([&]() { setParameter(ID, 0.5f); });
std::thread automationThread([&]() { setParameter(ID, 0.7f); });
// Must not crash, race condition free

// Audio processing mientras cambios de parámetros
while (audioThreadRunning) {
    processBlock(buffer);
    // UI thread changing parameters concurrently
}
// Must be glitch-free

📏 Latency Validation

Test:

1. Feed impulse (single sample = 1.0)
2. Measure delay to first non-zero output
3. Compare con reported latency

Criterio: Reported latency === Measured latency

🎛️ Preset Compatibility

Validate:

• ✅ Load presets from previous versions
• ✅ Handle missing parameters gracefully
• ✅ Default values sensible para new parameters
• ✅ Backward compatibility maintained

🔍 Resource Management

Check:

// Memory leaks
createPlugin();
processAudio(1000000 iterations);
destroyPlugin();
// Memory usage debe volver a baseline

// CPU usage reasonable
float cpuUsage = measureCPUUsage(processBlock);
assert(cpuUsage < REAL_TIME_THRESHOLD);

// File handles cerrados
int openFilesBefore = getOpenFileCount();
plugin.loadPreset();
int openFilesAfter = getOpenFileCount();
assert(openFilesBefore == openFilesAfter);

✅ Validation Checklist

□ Bypass test passed (bit-perfect)
□ Automation smooth (no clicks)
□ State recall 100% accurate
□ Parameter ranges enforced
□ Host-specific compliance verified
□ Thread-safety validated
□ Latency reporting correct
□ Preset compatibility checked
□ Resource management clean
□ Regression tests passing