使用Direct2D绘制GIF时出现水平透明横线故障求助

基于微软Direct2D GIF示例实现了GIF绘制功能，核心代码如下：

// 渲染循环中的代码
IWICBitmapFrameDecode* frame = nullptr;
IWICFormatConverter* converter = nullptr;
gifDecoder->GetFrame(current_frame, &frame);

if (frame)
{
    d2dWICFactory->CreateFormatConverter(&converter);

    if (converter)
    {
        ID2D1Bitmap* temp = nullptr;

        converter->Initialize(frame, GUID_WICPixelFormat32bppPBGRA,
            WICBitmapDitherTypeNone, NULL, 0.f, WICBitmapPaletteType::WICBitmapPaletteTypeCustom);

        tar->CreateBitmapFromWicBitmap(converter, NULL, &temp);

        scale->SetValue(D2D1_SCALE_PROP_SCALE, D2D1::Vector2F(1, 1));
        scale->SetInput(0, temp);

        target->DrawImage(scale);

        SafeRelease(&temp);
    }
}
SafeRelease(&frame);
SafeRelease(&converter);

gifDecoder的创建代码：

d2dWICFactory->CreateDecoderFromFilename(pathToGif, NULL, GENERIC_READ, WICDecodeMetadataCacheOnLoad, &gifDecoder);

故障效果：

程序中几乎所有GIF除第一帧外，均出现水平透明横线故障，浏览器或其他程序查看同一GIF则无此问题。尝试修改像素格式、调色板类型，故障仍存在，请问问题出在哪里？

核心问题 #

你没有处理GIF动画的帧合成规则：GIF的后续帧大多不是完整画布，而是基于前一帧的增量更新（仅绘制变化区域、保留前帧未修改的像素）。你的代码每次单独解码当前帧并直接绘制，没有将前一帧的内容保留并叠加当前帧，导致帧中未定义的区域显示为透明，从而出现横线故障。

解决步骤 #

1. 维护累积帧缓冲区
   创建一个持久的ID2D1Bitmap作为画布，用于保存所有帧叠加后的完整画面，每次新帧绘制时都基于这个缓冲区更新。

2. 读取帧元数据
   每帧需要获取以下关键元数据，用于正确定位和合成：

   • 帧的位置（Left/Top）、尺寸（Width/Height）
   • 帧处置方式（DisposalMethod）：决定当前帧绘制后，下一帧如何处理当前帧的内容

3. 按规则合成帧
   根据处置方式，在累积缓冲区上叠加当前帧，确保画面连续性。

修改后的代码示例 #

初始化阶段创建累积缓冲区

ID2D1Bitmap* accumulatedBitmap = nullptr;
// 获取GIF画布原始尺寸
UINT gifWidth, gifHeight;
gifDecoder->GetSize(&gifWidth, &gifHeight);
// 创建对应大小的累积缓冲区
originalTarget->CreateBitmap(
    D2D1::SizeU(gifWidth, gifHeight),
    D2D1::BitmapProperties(D2D1::PixelFormat(DXGI_FORMAT_B8G8R8A8_UNORM, D2D1_ALPHA_MODE_PREMULTIPLIED)),
    &accumulatedBitmap
);

渲染循环中的帧合成逻辑

IWICBitmapFrameDecode* frame = nullptr;
IWICFormatConverter* converter = nullptr;
IWICMetadataQueryReader* frameMetadata = nullptr;

gifDecoder->GetFrame(current_frame, &frame);
frame->GetMetadataQueryReader(&frameMetadata);

// 读取帧位置与尺寸
UINT frameLeft = 0, frameTop = 0, frameWidth = 0, frameHeight = 0;
frameMetadata->GetMetadataByName(L"/imgdesc/Left", &frameLeft);
frameMetadata->GetMetadataByName(L"/imgdesc/Top", &frameTop);
frameMetadata->GetMetadataByName(L"/imgdesc/Width", &frameWidth);
frameMetadata->GetMetadataByName(L"/imgdesc/Height", &frameHeight);

// 读取帧处置方式
UINT disposalMethod = WICGifDisposalMethodNone;
frameMetadata->GetMetadataByName(L"/appext/gif/GraphicControlExtension/DisposalMethod", &disposalMethod);

if (frame)
{
    d2dWICFactory->CreateFormatConverter(&converter);
    if (converter)
    {
        ID2D1Bitmap* tempFrameBitmap = nullptr;
        converter->Initialize(frame, GUID_WICPixelFormat32bppPBGRA,
            WICBitmapDitherTypeNone, NULL, 0.f, WICBitmapPaletteTypeCustom);
        originalTarget->CreateBitmapFromWicBitmap(converter, NULL, &tempFrameBitmap);

        // 切换渲染目标到累积缓冲区
        originalTarget->SetTarget(accumulatedBitmap);
        originalTarget->BeginDraw();

        // 根据处置方式处理前帧残留（仅非第一帧需要）
        if (current_frame > 0)
        {
            switch (disposalMethod)
            {
                case WICGifDisposalMethodRestoreToBackground:
                    // 用GIF背景色填充当前帧区域（需提前读取背景色元数据）
                    originalTarget->FillRectangle(
                        D2D1::RectF(frameLeft, frameTop, frameLeft + frameWidth, frameTop + frameHeight),
                        backgroundBrush // 提前创建的背景色画刷
                    );
                    break;
                case WICGifDisposalMethodRestoreToPrevious:
                    // 需提前保存前一帧对应区域的内容，此处省略实现逻辑
                    break;
                // 其他处置方式按需处理
            }
        }

        // 将当前帧绘制到累积缓冲区的对应位置
        originalTarget->DrawImage(
            tempFrameBitmap,
            D2D1::Point2F(frameLeft, frameTop),
            D2D1::RectF(0, 0, frameWidth, frameHeight)
        );

        HRESULT hr = originalTarget->EndDraw();
        // 恢复到原始渲染目标（屏幕/窗口缓冲区）
        originalTarget->SetTarget(originalTarget);

        // 将累积缓冲区绘制到屏幕
        scale->SetInput(0, accumulatedBitmap);
        originalTarget->DrawImage(scale);

        SafeRelease(&tempFrameBitmap);
    }
}

SafeRelease(&frame);
SafeRelease(&converter);
SafeRelease(&frameMetadata);

补充说明 #

• 需额外读取GIF的背景色元数据（/appext/gif/LogicalScreenDescriptor/BackgroundColorIndex），转换为实际颜色后创建画刷，用于处置方式为RestoreToBackground的情况。
• 帧处置方式的完整枚举参考WICGifDisposalMethod，需根据实际需求处理所有可能的取值。

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