• 显示苹果 HEIC 图片的实现原理
• 一个最简单的显示程序
• 高品质显示效果，保持纵横比缩放
• 转为 jpg 格式，指定 jpg 的品质效果
• 本文例子源码下载

1. 显示苹果 HEIC 图片的实现原理

CopyTrans HEIC for Windows 是一个解码器插件，可以免费家庭使用。官网下载地址：https://www.copytrans.net/copytransheic/

这个软件没有界面，安装之后可以在 Windows 资源管理器、系统自带的照片、及其他看图软件 (IrfanView 等) 显示苹果 HEIC 图片。

C++ Builder 可以通过 Graphics::TWICImage 调用解码器插件显示图片，不仅仅是刚安装的 HEIC，还可以显示其他 Windows 支持的格式

2. 一个最简单的显示程序

新建一个项目：HEIC 测试 1
在 Form 上放置控件：
Image1：用于显示图片；
Label1，LabelFile：用于显示文件名；
OpenDialog1：用于选择打开文件；
ButtonLoad：点击这个按钮执行打开文件。

在 Form 上放置控件

按钮 ButtonLoad 的点击事件：

void __fastcall TForm1::ButtonLoadClick(TObject *Sender)
{
    OpenDialog1->Filter = L"图片文件|*.jpg;*.jpeg;*.png;*.gif;*.tif;*.tiff;*.heic;*.bmp";
    if(OpenDialog1->Execute(Handle))
    {
        std::auto_ptr<Graphics::TWICImage> wic(new Graphics::TWICImage);
        wic->LoadFromFile(OpenDialog1->FileName);
        LabelFile->Caption = OpenDialog1->FileName;
        Image1->Canvas->StretchDraw(TRect(0,0,Image1->Width,Image1->Height),wic.get());
    }
}

点击 ButtonLoad 选择一个 HEIC 图片，可以看到显示在 Image1 里面了

执行结果

HEIC 测试 1 的显示效果并不理想，因为和看图软件相比，显得太粗糙了。
上面截图↑是这个测试程序的效果，下面截图↓是看图软件的效果

看图软件的效果

3. 高品质显示效果，保持纵横比缩放

• 发现问题：经过测试发现显示效果差的原因是使用 Canvas->StretchDraw 进行缩放引起的，其他环节都没有问题。
• 解决方法：通过 API 函数 SetStretchBltMode 把缩放设为 HALFTONE 模式，使用 StretchBlt 缩放可以进行高品质显示。

新建一个项目：HEIC 测试 2

在 Form 上放置控件

Anchors 属性

打开 Form 的头文件：
在类的 private: 里面添加一个位图的定义，public: 里面添加析构函数：

private:    // User declarations
    Graphics::TBitmap *bmp;
public:     // User declarations
    __fastcall TForm1(TComponent* Owner);
    __fastcall ~TForm1();

打开 Form 的 cpp 文件：
在构造函数 TForm1::TForm1 里面添加内容；
添加析构函数 TForm1::~TForm1 的实现；
添加 PaintBox1 的 OnPaint 画图事件的实现；
添加 ButtonLoad 的 OnClick 点击事件的实现：

__fastcall TForm1::TForm1(TComponent* Owner)
    : TForm(Owner)
{
    LabelFile->Caption = L"";
    bmp = new Graphics::TBitmap;
}
//---------------------------------------------------------------------------
__fastcall TForm1::~TForm1()
{
    delete bmp;
}
//---------------------------------------------------------------------------
void __fastcall TForm1::PaintBox1Paint(TObject *Sender)
{
    if(bmp->Width>0 && bmp->Height>0)
    {
        int iPaintW = PaintBox1->Width;
        int iPaintH = PaintBox1->Height;
        TRect r(0,0,iPaintW,iPaintH);

        int iRatioW = iPaintH * bmp->Width / bmp->Height;
        int iRatioH = iPaintW * bmp->Height / bmp->Width;
        if(iRatioW < iPaintW) // 为了保证纵横比，需要减少宽度
        {
            r.Left = (iPaintW - iRatioW) / 2;
            r.Right = r.Left + iRatioW;
        }
        if(iRatioH < iPaintH) // 为了保证纵横比，需要减少高度
        {
            r.Top = (iPaintH - iRatioH) / 2;
            r.Bottom = r.Top + iRatioH;
        }
//      PaintBox1->Canvas->StretchDraw(r,bmp); // StretchDraw()：低品质缩放
        ::SetStretchBltMode(PaintBox1->Canvas->Handle, HALFTONE); // 设定 ::StretchBlt() 模式：高品质缩放
        ::SetBrushOrgEx(PaintBox1->Canvas->Handle, 0, 0, NULL); // MSDN: SetBrushOrgEx must be called after setting the HALFTONE mode to avoid brush misalignment.
        ::StretchBlt(PaintBox1->Canvas->Handle, r.Left,r.Top,r.Width(),r.Height(), bmp->Canvas->Handle, 0,0,bmp->Width,bmp->Height, SRCCOPY);
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::ButtonLoadClick(TObject *Sender)
{
    OpenDialog1->Filter = L"图片文件|*.jpg;*.jpeg;*.png;*.gif;*.tif;*.tiff;*.heic;*.bmp";
    if(OpenDialog1->Execute(Handle))
    {
        std::auto_ptr<Graphics::TWICImage> wic(new Graphics::TWICImage);
        wic->LoadFromFile(OpenDialog1->FileName);
        LabelFile->Caption = OpenDialog1->FileName;
        bmp->Assign(wic.get());
        PaintBox1->Invalidate();
    }
}
//---------------------------------------------------------------------------

为了提高效率，使用一个位图保存解码之后的图片，每次刷新显示只需要把这个位图缩放到合适比例显示到 PaintBox1 里面，而不是每次显示都重新读取文件和解码。显示的时候，使用了 SetStretchBltMode 和 StretchBlt 替换 Canvas->StretchDraw 来提高显示效果。

运行结果：
以下截图为 HEIC 测试 2 的运行效果。

HEIC 测试 2 运行结果

HEIC 测试 2 运行结果

HEIC 测试 2 运行结果

4. 转为 jpg 格式，指定 jpg 的品质效果

TJPEGImage 的 CompressionQuality 为生成的 jpg 文件的品质效果，可以设 0 到 100 之间的数值，数值越大效果越好，文件也越大；数值越小效果越差，文件也越小。滑动条 TrackBarQuality 的范围，即 Min 和 Max 属性设为 0 和 100，PageSize 和 Frequency 属性设为 10，LineSize 属性设为 1。

以下代码为 TrackBarQuality 的 OnChange 事件和 ButtonToJpg 的 OnClick 事件。
TrackBarQuality 的 OnChange 事件里面只是显示了滑动条的位置，ButtonToJpg 的 OnClick 事件里面把解码之后的位图 bmp 按照滑动条的位置设为生成 jpg 文件的品质效果，转为 jpg 格式存盘。

void __fastcall TForm1::TrackBarQualityChange(TObject *Sender)
{
    LabelQuality->Caption = IntToStr(TrackBarQuality->Position) + L"%";
}
//---------------------------------------------------------------------------
void __fastcall TForm1::ButtonToJpgClick(TObject *Sender)
{
    if(LabelFile->Caption == L"")
    {
        ShowMessage(L"请先加载图片");
        return;
    }

    SaveDialog1->DefaultExt = L"jpg";
    SaveDialog1->Filter = L"JPEG 图片|*.jpg";
    SaveDialog1->Options = SaveDialog1->Options << ofOverwritePrompt;
    if(SaveDialog1->Execute())
    {
        std::auto_ptr<Imaging::Jpeg::TJPEGImage> jpg(new Imaging::Jpeg::TJPEGImage);
        jpg->CompressionQuality = TrackBarQuality->Position; // 1 - 100
        jpg->Assign(bmp);
        jpg->SaveToFile(SaveDialog1->FileName);
        ShowMessage(L"成功保存文件：" + SaveDialog1->FileName);
    }
}
//---------------------------------------------------------------------------

要注意的是，直接用 Assign 把 Graphics::TWICImage 转为 Imaging::Jpeg::TJPEGImage 无法指定生成 jpg 文件的品质效果，只有先解码为位图 Graphics::TBitmap，然后再转为 jpg 才可以指定生成 jpg 的品质效果。

如果要转为 bmp 可以直接把解码之后的 bmp 存盘，其他格式可以使用 TPngImage 、TGIFImage 等，和 TJPEGImage 的代码类似，只要有了解码之后的位图，就可以保存为 C++ Builder 支持的其他格式。

本文例子源码下载：heic-display-convert-to-jpg-src-cbuilder.rar
解码器推荐官网下载：https://www.copytrans.net/copytransheic/
解码器网盘备份：CopyTransHEICforWindowsv1.009.rar
(这个备份在我上传时是最新版，但是你看到这篇文章时就不一定是最新版了)

C++ Builder 基础知识
C++ Builder 编程技巧
C++ Builder 参考手册