免费开源工具，让照片在数分钟内变成像素艺术

# 免费开源工具，几分钟内把照片变成像素艺术\n\n如果你喜欢 8 位图形的怀旧风格，却不想亲手绘制像素，Photo2Pixel 就是答案。它是一个使用 PyTorch 的 Python 仓库，能自动将任意照片转换为像素艺术风格图像。该算法使用模糊卷积核实现平滑的色彩过渡，将图像量化为固定大小的像素块，并可添加可选的黑色边缘线，营造经典复古的感觉。\n\n## Photo2Pixel 是什么？\n\nPhoto2Pixel 不只是一个脚本；它是一个小型生态系统：\n\n* 在线演示 – 访问 photo2pixel.co 查看浏览器中的转换器。\n* Colab 笔记本 – 仓库包含一个随时可运行的笔记本，允许你在不安装任何本地软件的情况下进行实验。\n* CLI 工具 – 一个轻量级命令行界面（convert.py），可接受图片路径和若干可调参数。\n\n该项目采用 Apache‑2.0 许可证发布，GitHub 上已有 500+ 颗星，并且持续维护中。\n\n## 主要功能\n\n| 功能 | 描述 |\n|---------|-------------|\n| 卷积核大小 | 平滑色彩过渡；更大的值会带来更柔和的效果。 |\n| 像素块大小 | 控制每个像素块的尺寸；尺寸越小细节保留越好。 |\n| 边缘阈值 | 较低的阈值会添加更深的黑色边缘，营造鲜明、经典的像素艺术边框。 |\n| 多语言支持 | README 已提供英文和简体中文版本。 |\n| 跨平台 | 需要 Python 3、PyTorch、Pillow；支持 Windows、macOS、Linux。 |\n\n## 安装与配置\n\nbash\n# 克隆仓库\ngit clone https://github.com/Jzou44/photo2pixel.git\ncd photo2pixel\n\n# 创建虚拟环境（可选但建议）\npython -m venv venv\nsource venv/bin/activate # 在 Windows: venv\\Scripts\\activate\n\n# 安装依赖\npip install -r requirements.txt\n\n\n如果你只想使用在线转换器，可以跳过本地安装，直接使用 photo2pixel.co 上的 Web UI。\n\n## 基本用法\n\nbash\npython convert.py --input ./images/example_input_mountain.jpg\n\n\n默认情况下，输出将写入 ./result.png。命令将使用：\n\n* kernel_size=10\n* pixel_size=16\n* edge_thresh=100\n\n这些默认值适用于大多数图像。\n\n## 自定义输出\n\n根据你的喜好调整这三个参数：\n\nbash\npython convert.py \ --input ./images/hero.png \ --kernel_size 12 \ --pixel_size 12 \ --edge_thresh 80 \ --output ./output/hero_pixel.png\n\n\n* kernel_size – 较大的值（≥15）带来更平滑的效果，较小值（≤5）则保持尖锐过渡。\n* pixel_size – 8 位像素艺术通常为 8–16px；若需极其精细的像素效果，尝试 4px。\n* edge_thresh – 设置较低（如 50）可得到更粗的黑色轮廓；保持较高（>200）可去除大部分轮廓。\n\n### 示例：将风景照片转换为复古 8‑bit\n\nbash\npython convert.py --input ./images/example_input_mountain.jpg \ --kernel_size 12 \ --pixel_size 12 \ --edge_thresh 120 \ --output ./output/mountain_pixel.png\n\n\n生成的图像将平滑色彩渐变与清晰像素块完美融合，呼应早期游戏机的风格。\n\n## 在 Colab 中运行\n\n如果你更喜欢基于网页的环境，可将 convert.ipynb 笔记本内容复制至 Google Colab：\n\n1. 上传仓库中的 convert.ipynb。\n2. 通过 !pip install -r requirements.txt 安装依赖。\n3. 上传一张图片。\n4. 运行单元格即可实时查看转换效果。\n\n此方法非常适合快速实验或与合作者共享结果。\n\n## 贡献\n\n本项目热烈欢迎贡献！\n\n* Bug Reports – 若发现问题，请提交 issue。\n* Pull Requests – Fork 仓库，改进后提交 PR。请遵循现有风格，并确保测试（如有）通过。\n* Feature Enhancements – 例如新增边缘检测算法、交互式 UI 或批处理模式等建议非常受欢迎。\n\n欢迎你用母语添加文档或为新人创建教程。\n\n## 社区与支持\n\n* GitHub 讨论区，解答一般性问题。\n* Discord（链接见 README）提供实时帮助。\n* 关注推特 @photo2pixel 获取最新动态。\n\n## 结论\n\nPhoto2Pixel 展示了强大图像处理工具如何被包装成简单、开源的命令行应用。无论你是想在游戏中嵌入像素风效果的开发者，还是想创造复古艺术的业余爱好者，该项目都能让你在不承担手工像素工具负担的情况下，获得完整的控制与灵活性。\n\n下载仓库，探索参数设置，尽情创作自己的 8‑bit 名作——全程仅需数分钟。\n---\n\n快乐像素艺术之旅！