FindPNG

查找 libpng，PNG 图像格式的官方参考库

find_package(PNG [<version>] [...])

注意

PNG 库依赖于 ZLib 压缩库，必须找到该库才能使此模块成功。

导入的目标

此模块提供以下 导入目标

PNG::PNG

3.5 版本新增。

封装 libpng 库使用要求的目标，在找到 libpng 时可用。

结果变量

此模块定义了以下变量

PNG_FOUND

布尔值，指示是否找到 (所请求版本的) PNG 库。

PNG_VERSION

版本 4.2 中添加。

找到的 PNG 库的版本。

PNG_INCLUDE_DIRS

包含 PNG 头文件 (例如 png.h) 的目录。

PNG_LIBRARIES

链接 PNG 库所需的库。

PNG_DEFINITIONS

使用 PNG 的编译定义 (如果存在)。当不使用 PNG::PNG 导入目标时，可以使用 target_compile_definitions() 命令添加它们。

已弃用变量

为了向后兼容，以下变量也可能被设置

PNG_LIBRARY

3.0 版已弃用：使用 PNG::PNG 导入目标。

PNG 库的路径。

PNG_INCLUDE_DIR

3.0 版已弃用：使用 PNG::PNG 导入目标。

包含 PNG 头文件的目录 (与 PNG_INCLUDE_DIRS 相同)。

PNG_VERSION_STRING

4.2 版已弃用：由 PNG_VERSION 取代。

找到的 PNG 库的版本。

示例

查找 PNG 库并在项目中使用它

find_package(PNG)
target_link_libraries(project_target PRIVATE PNG::PNG)