C#处理Flutter传入的BMP透明区域，解决FastReport.NET图片全黑问题

你的BMP图片能在浏览器/OSX预览正常显示，但Windows资源管理器和FastReport.NET生成的PDF里全黑，核心原因是：这张BMP采用了32位带Alpha通道的非标准编码格式（大概率是Flutter导出时未正确设置BMP头的Alpha通道标识，或是用了Windows GDI+不支持的预乘Alpha格式）。FastReport.NET生成PDF依赖的GDI+渲染引擎对这类非标准32位BMP的Alpha通道支持有限，会直接把透明区域识别为黑色。

1. 转换为标准PNG格式再嵌入 #

这是最直接的兼容方案，PNG的Alpha通道支持是通用标准，FastReport.NET对PNG的兼容性远优于特殊BMP。

• 实现步骤：
  1. 将Base64解码为BMP流后，用System.Drawing或第三方图像库转换为PNG格式。
  2. 将转换后的PNG嵌入FastReport报表。
• 示例代码（基于System.Drawing）：

// base64Str为从Flutter获取的Base64字符串
byte[] bmpBytes = Convert.FromBase64String(base64Str);
using (var bmpMs = new MemoryStream(bmpBytes))
using (var bmp = new Bitmap(bmpMs))
using (var pngMs = new MemoryStream())
{
    bmp.Save(pngMs, ImageFormat.Png);
    pngMs.Position = 0;
    // 将PNG流绑定到报表图片控件
    var reportPic = report.FindObject("TargetPicture") as PictureObject;
    reportPic.Image = Image.FromStream(pngMs);
}

2. 修复BMP头的Alpha通道标识 #

如果必须保留BMP格式，需要修改BMP文件头，明确告知GDI+这是带Alpha通道的32位BMP：

• 32位BMP的BITMAPINFOHEADER中，biCompression字段需设为BI_BITFIELDS（值为0x0003），同时添加4个DWORD的颜色掩码（对应R、G、B、Alpha通道的位掩码：0x00FF0000, 0x0000FF00, 0x000000FF, 0xFF000000）。
• 示例修复代码：

byte[] FixBmpAlphaHeader(byte[] bmpData)
{
    if (bmpData.Length < 54) return bmpData;
    
    // 修改biCompression为BI_BITFIELDS
    BitConverter.GetBytes((uint)3).CopyTo(bmpData, 30);
    
    // 扩展BMP数据，添加颜色掩码
    var fixedData = new byte[bmpData.Length + 16];
    Array.Copy(bmpData, fixedData, 54);
    // 写入R、G、B、Alpha掩码
    BitConverter.GetBytes(0x00FF0000).CopyTo(fixedData, 54);
    BitConverter.GetBytes(0x0000FF00).CopyTo(fixedData, 58);
    BitConverter.GetBytes(0x000000FF).CopyTo(fixedData, 62);
    BitConverter.GetBytes(0xFF000000).CopyTo(fixedData, 66);
    // 更新文件大小和信息头长度
    BitConverter.GetBytes(fixedData.Length).CopyTo(fixedData, 2);
    BitConverter.GetBytes(56).CopyTo(fixedData, 14);
    
    return fixedData;
}

修复后的BMP可被GDI+正确识别Alpha通道，再嵌入FastReport即可正常显示。

3. 用ImageSharp替代System.Drawing处理图像 #

如果System.Drawing处理仍有问题，可换用跨平台的ImageSharp库（对特殊图像格式支持更友好）：

• 先安装SixLabors.ImageSharp NuGet包。
• 示例代码：

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Formats.Bmp;
using SixLabors.ImageSharp.PixelFormats;

byte[] bmpBytes = Convert.FromBase64String(base64Str);
using (var ms = new MemoryStream(bmpBytes))
using (var image = Image.Load<Bgra32>(ms))
using (var outputMs = new MemoryStream())
{
    // 保存为标准32位BMP或直接导出为PNG
    image.Save(outputMs, new BmpEncoder { BitsPerPixel = BmpBitsPerPixel.Pixel32 });
    outputMs.Position = 0;
    // 将流绑定到报表图片控件
}

4. 在FastReport中手动绘制图像 #

如果以上方案都无效，可在FastReport的BeforePrint事件中手动处理图像渲染：

• 利用GDI+的DrawImage结合ImageAttributes强制识别Alpha通道：

private void TargetPicture_BeforePrint(object sender, EventArgs e)
{
    var picObj = sender as PictureObject;
    byte[] bmpBytes = Convert.FromBase64String(yourBase64String);
    using (var ms = new MemoryStream(bmpBytes))
    using (var bmp = new Bitmap(ms))
    {
        var imgAttr = new ImageAttributes();
        // 设置颜色矩阵确保Alpha通道生效
        var colorMatrix = new ColorMatrix();
        colorMatrix.Matrix33 = 1.0f;
        imgAttr.SetColorMatrix(colorMatrix);
        
        // 手动绘制图像到报表区域
        picObj.Graphics.DrawImage(bmp, picObj.Bounds, 0, 0, bmp.Width, bmp.Height, GraphicsUnit.Pixel, imgAttr);
        picObj.Visible = false; // 隐藏原控件，用手动绘制的内容替代
    }
}

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