尝试使用 libpng 加载图像时在 Windows 上出现运行时错误

如果您自己包含libpng，或者如果另一个库包含并使用libpng，则需要注意一些事项。

• 无论您使用的是哪个版本的 Visual Studio，libpng（dll 或 lib）文件都必须从您的解决方案所链接的同一版本的 Visual Studio 生成。
• 您正在使用的 32 位或 64 位平台值得关注。
生成
• png 库时的项目设置必须与当前项目的生成类型匹配。（代码生成 ->运行时库）必须匹配。您的字符集也应该匹配。

要说到底是什么导致了问题，有点困难，但这些是需要注意的几件事。

我建议的一件事是访问提供最新版本libpng的网站并下载它。在计算机上设置一个文件夹，并创建"通过窗口的系统环境变量"以指向您的库。在您正在使用的当前版本的 VS 中打开此库的解决方案，为静态库和动态库（两种不同的解决方案）构建它，并将它们构建为 32 位和 64 位，将生成的文件保存到单独的文件夹中。然后进入依赖于此的另一个库，并尝试切换 dll 或库，并在可能的情况下链接到新的库。此外，您应该尝试在相同版本的VS中打开其解决方案，并尝试从那里进行干净的构建。然后确保正确链接所有内容。您可能还必须修改 props 文件。

编辑

我不熟悉pHash或CImg，但我熟悉libpng。

这是我的一个项目中的一个函数，用于将 png 加载到纹理结构中。现在这是依赖于许多其他类的类对象的一部分，但您应该能够从此代码段中看到我已成功使用 libpng。

// ----------------------------------------------------------------------------
// loadPng()
bool TextureFileReader::loadPng( Texture* pTexture ) {
    struct PngFile {
        FILE*       fp;
        png_struct* pStruct;
        png_info*   pInfo;
        // --------------------------------------------------------------------
        PngFile() :
            fp( NULL ),
            pStruct( NULL ),
            pInfo( NULL )
        {} // PngFile
        // --------------------------------------------------------------------
        ~PngFile() {
            if ( NULL != fp ) {
                fclose( fp );
            }
            if ( NULL != pStruct ) {
                if ( NULL != pInfo ) {
                    png_destroy_read_struct( &pStruct, &pInfo, NULL );
                } else {
                    png_destroy_read_struct( &pStruct, NULL, NULL );
                }
            }
        } // ~PngFile
    } png;
    // Error Message Handling
    std::ostringstream strStream;
    strStream << __FUNCTION__ << " ";
    if ( fopen_s( &png.fp, m_strFilenameWithPath.c_str(), "rb" ) != 0 ) {
        strStream << "can not open file for reading";
        throwError( strStream );
    }
    // Test If File Is Actually A PNG Image
    const int NUM_HEADER_BYTES = 8;
    png_byte headerBytes[NUM_HEADER_BYTES];
    // Read The File Header
    if ( fread( headerBytes, 1, NUM_HEADER_BYTES, png.fp ) != NUM_HEADER_BYTES ) {
        strStream << "error reading header";
        return false;
    }
    // Test Header
    if ( png_sig_cmp( headerBytes, 0, NUM_HEADER_BYTES ) != 0 ) {
        return false; // Not A PNG FILE
    }
    // Init PNG Read Structure - Test PNG Version Compatibility
    png.pStruct = png_create_read_struct( PNG_LIBPNG_VER_STRING, NULL, NULL, NULL );
    if ( NULL == png.pStruct ) {
        strStream << "can not create struct for PNG file";
        throwError( strStream );
    }
    // Init PNG Info Structure - Allocate Memory For Image Info
    png.pInfo = png_create_info_struct( png.pStruct );
    if ( NULL == png.pInfo ) {
        strStream << "can not create info for PNG file";
        throwError( strStream );
    }
    // Prepare For Error Handling
    if ( setjmp( png_jmpbuf( png.pStruct ) ) ) {
        strStream << "can not init error handling for PNG file";
        throwError( strStream );
    }
    // Tell libPng Where The File Data Is
    png_init_io( png.pStruct, png.fp );
    // Tell libPng That You Have Already Read The Header Bytes
    png_set_sig_bytes( png.pStruct, NUM_HEADER_BYTES );
    // Read Image Data From The File
    png_read_png( png.pStruct, png.pInfo, PNG_TRANSFORM_STRIP_16 | PNG_TRANSFORM_PACKING | PNG_TRANSFORM_EXPAND | PNG_TRANSFORM_GRAY_TO_RGB, NULL );
    // Show Image Attributes
    png_byte colorType = png_get_color_type( png.pStruct, png.pInfo );
    switch( colorType ) {
        case PNG_COLOR_TYPE_RGB: 
        case PNG_COLOR_TYPE_RGBA: {
            break;
        }
        default: {
            strStream << "PNG is saved in an unsupported color type (" << colorType << ")";
            throwError( strStream );
        }
    }
    unsigned uHeight = png_get_image_height( png.pStruct, png.pInfo );
    unsigned uBytesPerRow = png_get_rowbytes( png.pStruct, png.pInfo );
    if ( 0 == uHeight || 0 == uBytesPerRow ) {
        strStream << "invalid image size. Height(" << uHeight << "), Bytes per row(" << uBytesPerRow << ")";
        throwError( strStream );
    }
    // Make Room For All Pixel Data
    unsigned uTotalNumBytes = uHeight * uBytesPerRow;
    pTexture->vPixelData.resize( uTotalNumBytes );
    // Get All Pixel Data From PNG Image
    png_bytepp ppPixelRow = png_get_rows( png.pStruct, png.pInfo );
    for ( unsigned int r = 0; r < uHeight; ++r ) {
        memcpy( &pTexture->vPixelData[ uBytesPerRow * ( uHeight - 1 - r ) ], ppPixelRow[r], uBytesPerRow );
    }
    // Store Other Values In Texture
    pTexture->uWidth            = png_get_image_width( png.pStruct, png.pInfo );
    pTexture->uHeight           = uHeight;
    pTexture->hasAlphaChannel   = ( colorType == PNG_COLOR_TYPE_RGBA );
    return true;
} // loadPng

查看源代码以获取png_create_read_struct_2()，只有 2 种故障模式：无法分配内存（这不太可能是问题）和库版本冲突。

预编译版本，则必须确保在运行时动态链接的 libpng DLL 的副本与编译 pHash 所针对的库版本相同。 pHash.org 上的最新 Windows 版本在"发布"子目录中附带 libpng12.dll，这可能与您在问题中提到的版本（即 1.4.19）不兼容。

如果要从源代码构建 pHash，请确保 libpng 包含构建过程中使用的文件与运行时加载的版本匹配。

如果您不确定在运行时加载了哪些 DLL，那么我知道确定它的最可靠方法是使用进程监视器。