Windows HEIC Thumbnails 项目使用教程

Windows HEIC Thumbnails 项目使用教程

项目地址:https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnails

1. 项目的目录结构及介绍

windows-heic-thumbnails/
├── README.md
├── LICENSE
├── vcpkg.json
├── vcpkg-overlay/
├── src/
│   ├── HEICThumbnailHandler.cpp
│   ├── HEICThumbnailHandler.h
│   ├── heif.dll
│   ├── libde265.dll
│   └── HEICThumbnailHandler.dll
└── docs/
    └── 使用说明.md

• README.md: 项目介绍和基本使用说明。
• LICENSE: 项目许可证（MIT 许可证）。
• vcpkg.json: vcpkg 配置文件，用于管理依赖项。
• vcpkg-overlay/: 自定义 vcpkg 端口目录，用于移除对 x265 编码器的依赖。
• src/: 源代码目录，包含主要的 DLL 文件和源代码文件。
  • HEICThumbnailHandler.cpp: 主要源代码文件。
  • HEICThumbnailHandler.h: 头文件。
  • heif.dll: HEIF 库文件。
  • libde265.dll: libde265 库文件。
  • HEICThumbnailHandler.dll: 生成的 DLL 文件，用于在 Windows Explorer 中显示 HEIC 文件的缩略图。
• docs/: 文档目录，包含详细的使用说明。

2. 项目的启动文件介绍

项目的启动文件是 HEICThumbnailHandler.dll，该文件需要在 Windows 系统中注册后才能使用。具体步骤如下：

1. 下载并解压项目文件：

   • 从 GitHub 仓库下载最新版本的 HEICThumbnailHandler.dll、heif.dll 和 libde265.dll。
   • 将这些文件解压到一个目录中。

2. 注册 DLL 文件：

   • 打开命令提示符（以管理员身份）。
   • 导航到解压后的目录。
   • 运行以下命令注册 DLL 文件：

     regsvr32 HEICThumbnailHandler.dll
     

3. 验证：

   • 打开 Windows Explorer，查看 HEIC 文件是否显示缩略图。

3. 项目的配置文件介绍

项目的配置文件主要是 vcpkg.json，该文件用于配置 vcpkg 依赖项管理工具。以下是 vcpkg.json 的基本内容：

{
  "name": "windows-heic-thumbnails",
  "version-string": "1.0.0",
  "dependencies": [
    "libheif"
  ],
  "overlay-ports": [
    "vcpkg-overlay"
  ]
}

• name: 项目名称。
• version-string: 项目版本号。
• dependencies: 项目依赖项，这里指定了 libheif。
• overlay-ports: 自定义端口目录，用于移除对 x265 编码器的依赖。

通过配置 vcpkg.json，可以确保项目在构建时正确安装所需的依赖项。

---

以上是 windows-heic-thumbnails 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！

windows-heic-thumbnails Enable Windows Explorer to display thumbnails for HEIC files 项目地址: https://gitcode.com/gh_mirrors/wi/windows-heic-thumbnails