nomacs 图像浏览器技术文档

nomacs 是一个免费且开源的图像查看器，支持多种操作系统平台，包括 Windows、Linux、FreeBSD、Mac 和 OS/2。它能够处理常见的图像格式，如 JPEG、PNG、RAW 以及 PSD 等。本文档将引导您完成从安装到深入使用的全过程。

安装指南

Windows

1. 准备环境：确保已安装 Visual Studio、Python、Git 和 Qt。
2. 克隆仓库：git clone https://github.com/nomacs/nomacs.git.
3. 初始化并更新子模块：git submodule init && git submodule update.
4. 构建 nomacs：运行 python scripts/make.py "qtpath/bin"，构建结果将在 build/nomacs 目录下。
5. （可选）开发者构建请参考 README 中的开发者构建部分。

Ubuntu/Linux

• 更新系统包，然后安装依赖项（根据您的Ubuntu版本选择相应命令）。
• 克隆仓库后，在 ImageLounge 目录下执行 mkdir build; cd build; cmake ..; make; sudo make install。
• 安装完成后，通过 sudo ldconfig 更新库链接。

MacOS

• 使用 Homebrew 安装依赖，并克隆 nomacs 仓库。
• 运行 cmake 配置，并编译。对于 MacOS，还需特别关注 Qt 的路径配置。
• 完成编译后，可以安装至 /Applications 或生成 .dmg 安装包。

其他平台和特殊构建方式

对于跨平台构建、Windows MSYS2 环境、Docker 以及 Windows Cross-Compile 的详细步骤，参照 README 文件中的相应章节。

项目的使用说明

启动 nomacs 后，可以通过拖拽文件到窗口或通过菜单打开图像进行查看。支持多标签页浏览，图像基本编辑功能，如裁剪、旋转和颜色调整等。利用同步视图功能，可以方便地比较两个或多个图像。

项目API使用文档

nomacs 作为一个图像查看器，其 API 主要面向插件开发者。尽管直接调用内核API的文档不够详细，但可以通过源码分析和示例插件学习如何扩展 nomacs 功能。具体插件开发指南可访问官方文档或者 nomacs-plugins 存储库获取更详细的指导。

项目安装方式

1. 预编译包：访问 nomacs 的 GitHub 发布页面，下载对应操作系统的安装包进行安装。
2. 源代码安装：按照上述的“安装指南”步骤，手动构建并安装 nomacs。

---

nomacs 提供了灵活的构建选项以适应不同开发者的需要，无论是业余爱好者还是专业开发者，都能通过这个强大而简洁的工具满足图像查看和基本编辑的需求。如果您在使用过程中遇到任何问题，可以参阅官方文档，加入 Matrix 聊天室交流，或贡献您的代码改进 nomacs。