基于QAudioDecoder与QPainter绘制音频波形的问题排查

针对你遇到的波形间隙、缩放错误、44100Hz高采样率绘制异常问题，直接给出针对性修复方案：

1. 解决波形间隙问题 #

间隙本质是解码数据未连续累积，每次覆盖旧数据导致绘制断层。修复方式是在解码回调中追加采样数据而非覆盖：

waveform.cpp 解码回调修改 #

void Waveform::onBufferReady()
{
    QAudioBuffer buffer = m_decoder->read();
    if (!buffer.isValid()) return;

    // 这里以16位单声道PCM为例，确保匹配实际音频格式
    const qint16 *sampleData = buffer.constData<qint16>();
    int sampleCount = buffer.sampleCount();

    // 追加到全局采样数组，提前预留空间提升性能
    m_samples.reserve(m_samples.size() + sampleCount);
    for (int i = 0; i < sampleCount; ++i) {
        m_samples.append(sampleData[i]);
    }

    // 触发波形控件重绘
    m_waveformWidget->update();
}

2. 修复缩放比例错误与波形超出宽度问题 #

核心是基于控件实际尺寸和总采样数动态计算缩放系数，同时限制绘制点数量不超过控件宽度：

waveformwidget.cpp 绘制函数重写 #

void WaveformWidget::paintEvent(QPaintEvent *event)
{
    QWidget::paintEvent(event);
    QPainter painter(this);
    painter.setRenderHint(QPainter::Antialiasing);
    painter.setPen(QPen(Qt::blue, 1));

    if (m_samples.isEmpty()) return;

    int widgetW = width();
    int widgetH = height();
    int halfH = widgetH / 2;

    // 计算降采样因子：让绘制点数量匹配控件宽度，避免超出或挤在一起
    int downsampleFactor = qMax(1, (int)m_samples.size() / widgetW);
    int drawPointCount = m_samples.size() / downsampleFactor;

    // 水平步长：每个绘制点占的控件宽度
    float xStep = static_cast<float>(widgetW) / drawPointCount;
    // 垂直缩放：把16位PCM采样值（-32768~32767）映射到控件高度
    float yScale = static_cast<float>(halfH) / 32768.0f;

    float currentX = 0.0f;
    for (int i = 0; i < drawPointCount; ++i) {
        // 取当前降采样区间内的最大/最小采样值，还原波形起伏
        int startIdx = i * downsampleFactor;
        int endIdx = qMin(startIdx + downsampleFactor, (int)m_samples.size());
        qint16 minSample = 32767;
        qint16 maxSample = -32768;

        for (int j = startIdx; j < endIdx; ++j) {
            qint16 s = m_samples[j];
            minSample = qMin(minSample, s);
            maxSample = qMax(maxSample, s);
        }

        // 计算绘制坐标（波形居中，采样值为负时向下，正时向上）
        int yMin = halfH - static_cast<int>(minSample * yScale);
        int yMax = halfH - static_cast<int>(maxSample * yScale);
        painter.drawLine(QPointF(currentX, yMin), QPointF(currentX, yMax));

        currentX += xStep;
    }
}

3. 解决44100Hz高采样率绘制异常 #

44100Hz采样率下采样点数量极大，直接绘制会导致性能爆炸+波形畸变，上面的代码已通过降采样解决：

• 自动计算降采样因子，让绘制点数量等于控件宽度，既保证波形形状和Audacity一致，又避免超出控件范围
• 取区间极值而非单个采样点，还原波形的起伏特征

额外注意事项 #

• 如果是立体声音频，需要先合并双声道数据（比如取左右声道平均值，或单独绘制其中一个声道）
• 控件大小变化时，在resizeEvent中调用update()，重新计算缩放参数
• 解码前要确认QAudioDecoder的输出格式和原音频一致，避免采样数据解析错误

内容的提问来源于stack exchange，提问作者Alexandru Nitan