README.md

本程式是2024 師大資工白客松中我們小隊（歐姆巴說的對）的參賽作品：Ascii Artist

✨ 概述

這是一個 ascii art 生成器。

你可以輸入照片或隨機產生照片與其互動。

甚至你可以透過打開前置攝像頭互動，產生及時的 ascii art 圖像。

🧑‍💻 團隊分工

boyan1001 (Hank Chen) : Project manager / Camera interacting function /
                        Colorful ascii art image generating / TUI design

noyapoyo : Use anime api (waifu) and dog api (dor.ceo) /
           Black and white ascii art image generating

Jerryleess : Find api we can use / Offer ideas to us   

🧱 結構

2024_ascii_artist
├── /files/                存放照片檔案的地方，你也可以在這邊加入你想要輸入的圖片  
│  ├── original.png        原始檔案
│  ├── modify.png          經過調整對比度與亮度處理的圖片
│  ├── ascii_art.png       轉換成 ascii_art 風格的圖片
│  └── ...
├── /font/                 儲存字體的資料夾  
│  ├── DejaVuSansMono.ttf  目前正在使用在 ascii art 的字體，必須為等寬且可支援 window 環境的字體  
│  └── ...
├── main.py                主函式
├── camera.py              照相機模組  
├── UI.py                  UI 函式庫  
└── ...

🖥️ 環境要求

本程式可在 Window 作業系統上順利執行。

由於 Ascii Artist 有使用到許多 pip 套件，因此必須要先安裝完所需的套件才可執行。

請先確認您所屬環境中是否已安裝 python 及 pip。
(Python 版本要求 : python 3.10 以上)

python3 --version
pip --version

如果你尚未安裝，請先安裝完成。

接著，安裝 requests、pillow、opencv-python、numpy 這四個套件在您所屬的環境中：
（為了防止套件衝突，可以使用 虛擬環境 安裝套件）

pip install requests pillow opencv-python numpy

安裝完成套件後，即可執行該程式。

⚙️ 執行程式

如果你已安裝完環境後，可輸入下方指令開始執行程式：

python main.py

本程式使用 TUI 設計，整個程式將在 Terminal 中執行。

🛠️ 貢獻者須知

貢獻者需知可參考 CONTRIBUTING.md 與 CODE_OF_CONDUCT.md 檔案～

有任何想法，歡迎在 Issues 提出。

💪 貢獻者

感謝下列大大們的貢獻～

（可在 contributer 中觀看完整版貢獻者清單）

🪪 Lisence

MIT License © Hank Chen