在可執行文件中嵌入 PNG（或帶有 alpha 通道的 Bitmap）

Question

TL;DR：我想創建一個嵌入了圖像資源（帶有 alpha 通道）的獨立應用程序。 這樣做和提取數據的現代/標准方法是什么？

我目前正在 C++ 中編寫一個應用程序，它使用 OpenGL 作為圖形引擎（我選擇它是因為與 Vulkan 相比開發時間更快，盡管我也真的很想學習 Vulkan）並且在這個應用程序中我使用 Signed Distance Fields 來渲染我的文字。 這需要一個帶有 alpha 通道的 Font Atlas 來繪制字符。

我希望能夠將這個 Font Atlas（目前它是一個 .PNG 文件）嵌入到可執行文件中。 還有其他圖像資源，但我提到這個場景是為了說明為什么我真的需要 alpha 通道。

---

我使用 Win32 API 執行以下操作：

獲取當前模塊。

HMODULE getCurrentModule()
{
    HMODULE hModule = NULL;
    GetModuleHandleEx(
        GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS,
        (LPCTSTR)getCurrentModule,
        &hModule);
    return hModule;
}

為着色器嵌入文本文件。

std::string loadShaderFromResource(int shaderID) 
{
    // Load resource from executable.
    HRSRC shaderResource = FindResource(getCurrentModule(), MAKEINTRESOURCE(shaderID), MAKEINTRESOURCE(TEXTFILE));
    HGLOBAL resourceData = LoadResource(getCurrentModule(), shaderResource);
    DWORD resourceSize = SizeofResource(getCurrentModule(), shaderResource);
    char* resourceFinal = (char*)LockResource(resourceData);
    std::string shaderSource;
    shaderSource.assign(resourceFinal, resourceSize);
    return shaderSource;
}

我的 resource.h 文件。

它有點混亂，但我將其包括在內以提供盡可能多的信息。

/*=======================================================================================================================================*/
/* Setup by Visual Studio.                                                                                                               */
/*=======================================================================================================================================*/

// Next default values for new objects
// 
#ifdef APSTUDIO_INVOKED
#ifndef APSTUDIO_READONLY_SYMBOLS
#define _APS_NEXT_RESOURCE_VALUE        116
#define _APS_NEXT_COMMAND_VALUE         40003
#define _APS_NEXT_CONTROL_VALUE         1001
#define _APS_NEXT_SYMED_VALUE           101
#endif
#endif

/*=======================================================================================================================================*/
/* Resources.                                                                                                                            */
/*=======================================================================================================================================*/

//-------------------------------------------------------------------------------------------------
// Resource Types
#define TEXTFILE 255
#define PNG 254
//-------------------------------------------------------------------------------------------------
// Shaders
#define BASIC_SHADER 253
#define STATIC_SHADER 252
#define TEXTURE_SHADER 251
//-------------------------------------------------------------------------------------------------
// ImGui images.
#define COMPONENT_PNG 250               
#define DRAW_CIRCUIT_BUCKETS 249
#define DRAW_MCC_PNG 248                
//-------------------------------------------------------------------------------------------------
// OpenGL Textures.
#define CIRCUIT_TREE_PNG 247
//-------------------------------------------------------------------------------------------------
// OpenGL Fonts. 
#define ARIAL_SDF_FNT 246       
#define ARIAL_SDF_PNG 245       
#define ARIAL_SDF_BMP 244
#define ARIAL_SDF_MIN_FNT 243
#define ARIAL_SDF_MIN_PNG 242   
//-------------------------------------------------------------------------------------------------
// Application icon.
#define IDI_ICON1 116           // Exe icon.
#define ICON_BMP 115            // GLFW icon.
#define PANDA 114
//-------------------------------------------------------------------------------------------------

/*=======================================================================================================================================*/
/* Includes.                                                                                                                             */
/*=======================================================================================================================================*/

// Windows api for the exe.
#include <Windows.h>
#include <string>

/*=======================================================================================================================================*/
/* Data.                                                                                                                                 */
/*=======================================================================================================================================*/

// Struct that stores the bitmap data.
struct Bitmap {
    void* pixelData;
    int width = 0;
    int height = 0;
};

/*=======================================================================================================================================*/
/* Functions.                                                                                                                            */
/*=======================================================================================================================================*/

// Load the current module.
HMODULE getCurrentModule();

// Load shader from resource.
std::string loadShaderFromResource(int shaderID);

// Loading bitmaps.
Bitmap loadBitmapFromResource(int bitmapID);
unsigned int loadBitmapToGL(Bitmap bitmap);


/*=======================================================================================================================================*/
/* EOF.                                                                                                                                  */
/*=======================================================================================================================================*/

我的 resource.rc 文件。

// Microsoft Visual C++ generated resource script.
//
#include "resource.h"

#define APSTUDIO_READONLY_SYMBOLS
/////////////////////////////////////////////////////////////////////////////
//
// Generated from the TEXTINCLUDE 2 resource.
//
#include "winres.h"

/////////////////////////////////////////////////////////////////////////////
#undef APSTUDIO_READONLY_SYMBOLS

/////////////////////////////////////////////////////////////////////////////
// English (United States) resources

#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU)
LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US
#pragma code_page(1252)

#ifdef APSTUDIO_INVOKED
/////////////////////////////////////////////////////////////////////////////
//
// TEXTINCLUDE
//

1 TEXTINCLUDE
BEGIN
"resource.h\0"
END

2 TEXTINCLUDE
BEGIN
"#include ""winres.h""\r\n"
"\0"
END

3 TEXTINCLUDE
BEGIN
"\r\n"
"\0"
END

#endif    // APSTUDIO_INVOKED

/*=======================================================================================================================================*/
/* Resources.                                                                                                                            */
/*=======================================================================================================================================*/

//-------------------------------------------------------------------------------------------------
// Resource ID                  Resource Type               Resource Path
//-------------------------------------------------------------------------------------------------
// Application icon.
IDI_ICON1                       ICON                        "Icons\\circuitIcon128.ico"
ICON_BMP                        BITMAP                      "Icons\\circuitIcon.bmp"
PANDA                           BITMAP                      "Icons\\panda.bmp"
//-------------------------------------------------------------------------------------------------
// Shaders.
BASIC_SHADER                    TEXTFILE                    "Shaders\\basicShader.shader"
STATIC_SHADER                   TEXTFILE                    "Shaders\\staticShader.shader"
TEXTURE_SHADER                  TEXTFILE                    "Shaders\\textureShader.shader"
//-------------------------------------------------------------------------------------------------
// ImGui images.
COMPONENT_PNG                   PNG                         "Icons\\component.png"
DRAW_CIRCUIT_BUCKETS_PNG        PNG                         "Icons\\Draw_Circuit_Buckets.png"
DRAW_MCC_PNG                    PNG                         "Icons\\Draw_MCC.png"
//-------------------------------------------------------------------------------------------------
// OpenGL Textures.
CIRCUIT_TREE_PNG                PNG                         "Textures\\circuitTree.png"
//-------------------------------------------------------------------------------------------------
// OpenGL Fonts. 
ARIAL_SDF_FNT                   TEXTFILE                    "Fonts\\Arial_SDF.fnt"
ARIAL_SDF_PNG                   PNG                         "Fonts\\Arial_SDF_PNG.png"
ARIAL_SDF_BMP                   BITMAP                      "Fonts\\Arial_SDF_BMP_32.bmp"
ARIAL_SDF_MIN_FNT               TEXTFILE                    "Fonts\\Arial_SDF_Min.fnt"
ARIAL_SDF_MIN_PNG               PNG                         "Fonts\\Arial_SDF_Min.png"
//-------------------------------------------------------------------------------------------------

#endif    // English (United States) resources

//=================================================================================================

#ifndef APSTUDIO_INVOKED
/////////////////////////////////////////////////////////////////////////////
//
// Generated from the TEXTINCLUDE 3 resource.
//


/////////////////////////////////////////////////////////////////////////////
#endif    // not APSTUDIO_INVOKED
 /*=======================================================================================================================================*/
/* EOF.                                                                                                                                  */
/*=======================================================================================================================================*/

---

我注意到大多數關於 Win32 API 的論壇和此類問題都非常非常古老。 現在還在用嗎？ 有更現代的方法嗎？ 我看到有人用 CMake。

---

編輯 1

我嘗試按照@Barmak 的建議添加以下內容並進行一些編輯：

HBITMAP loadImageFromResource(int resourceID)
{
    HBITMAP hbitmap = NULL;
    ULONG_PTR token;
    Gdiplus::GdiplusStartupInput tmp;
    Gdiplus::GdiplusStartup(&token, &tmp, NULL);
    if (auto hres = FindResource(getCurrentModule(), MAKEINTRESOURCE(resourceID), RT_RCDATA))
        if (auto size = SizeofResource(getCurrentModule(), hres))
            if (auto data = LockResource(LoadResource(getCurrentModule(), hres)))
                if (auto stream =  SHCreateMemStream((BYTE*)data, size))
                {
                    Gdiplus::Bitmap bmp(stream);
                    stream->Release();
                    bmp.GetHBITMAP(Gdiplus::Color::Transparent, &hbitmap);
                }
    Gdiplus::GdiplusShutdown(token);
    return hbitmap;
}

但是，在調試模式下查看hbitmap時，它顯示0xffffffffa00513d7 {unused=???}並且不起作用。

資源.h：

#define ICON_PNG 240            // GLFW icon.

資源.rc:

ICON_PNG                        RCDATA                      "Icons\\circuitImage.png"

---

編輯 2

我犯了一個簡單的錯誤。 我將這些行添加到 function：

BITMAP bitmap;
GetObject(hbitmap, sizeof(BITMAP), &bitmap);

現在它通過返回 BITMAP 而不是 HBITMAP 來工作。 但是，它是倒置的，並且在將它與glfwSetWindowIcon()一起使用時，某些顏色似乎消失了。 它在其他地方完美運行！

BITMAP loadImageFromResource(int resourceID)
{
    HBITMAP hbitmap = NULL;
    ULONG_PTR token;
    Gdiplus::GdiplusStartupInput tmp;
    Gdiplus::GdiplusStartup(&token, &tmp, NULL);
    if (auto hres = FindResource(getCurrentModule(), MAKEINTRESOURCE(resourceID), RT_RCDATA))
        if (auto size = SizeofResource(getCurrentModule(), hres))
            if (auto data = LockResource(LoadResource(getCurrentModule(), hres)))
                if (auto stream =  SHCreateMemStream((BYTE*)data, size))
                {
                    Gdiplus::Bitmap bmp(stream);
                    stream->Release();
                    bmp.GetHBITMAP(Gdiplus::Color::Transparent, &hbitmap);
                }
    Gdiplus::GdiplusShutdown(token);
    BITMAP bitmap;
    GetObject(hbitmap, sizeof(BITMAP), &bitmap);
    return bitmap;
}

Answer 1

圖片來源： Barmak Shemirani

首先，通過將這些行添加到以下內容來存儲 .PNG 文件：

資源.h

#define ICON_PNG 240            // GLFW icon.

資源.rc

ICON_PNG                        RCDATA                      "Icons\\circuitImage.png"

然后將 .PNG 加載為 bitmap，如下所示：

BITMAP loadImageFromResource(int resourceID)
{
    HBITMAP hbitmap = NULL;
    ULONG_PTR token;
    Gdiplus::GdiplusStartupInput tmp;
    Gdiplus::GdiplusStartup(&token, &tmp, NULL);
    if (auto hres = FindResource(getCurrentModule(), MAKEINTRESOURCE(resourceID), RT_RCDATA))
        if (auto size = SizeofResource(getCurrentModule(), hres))
            if (auto data = LockResource(LoadResource(getCurrentModule(), hres)))
                if (auto stream =  SHCreateMemStream((BYTE*)data, size))
                {
                    Gdiplus::Bitmap bmp(stream);
                    stream->Release();
                    bmp.GetHBITMAP(Gdiplus::Color::Transparent, &hbitmap);
                }
    Gdiplus::GdiplusShutdown(token);
    BITMAP bitmap;
    if(!hbitmap) return NULL;
    GetObject(hbitmap, sizeof(BITMAP), &bitmap);
    return bitmap;
}

通過這樣調用它：

BITMAP image = loadImageFromResource(ICON_PNG);

---

編輯 1

我使用這個 function 將 bitmap 加載到 OpenGL 中：

unsigned int loadBitmapToGL(BITMAP bitmap) 
{
    unsigned int textureID = 0;
    glCreateTextures(GL_TEXTURE_2D, 1, &textureID);
    glBindTexture(GL_TEXTURE_2D, textureID);
    glPixelStorei(GL_UNPACK_ALIGNMENT, 4);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);
    glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, bitmap.bmWidth, bitmap.bmHeight, 0, GL_RGBA, GL_UNSIGNED_BYTE, (const void*)bitmap.bmBits);
    return textureID;
}

還添加了if(;hbitmap) return NULL; 正如巴爾馬克所建議的那樣。