若要在 Python 中將影像轉換為 ASCII 藝術,請將解碼後的影像調整為字元網格,將每個儲存格轉換為灰度,並依其亮度對應到密度階梯中的字元。

這會產生視覺化的 ASCII 藝術,而非光學字元辨識:它以一般文字字元呈現可見的明暗色調,但不會辨識物件、字詞或含意。下方 Python 範例會使用 Pillow,將結果印到終端機,並儲存為純文字檔案。

convert image to ascii art python
在 Python 中將影像轉換為 ASCII 藝術:完整指令碼

Python 轉換流程的運作方式

影像轉 ASCII 會結合影像縮放與色調映射。完成後的網格中,每個字元都代表已縮放影像中取樣的一個儲存格。密度較高的符號可代表深色區域,而密度較低的符號或空格則可代表淺色區域。

  • 將來源檔案解碼成像素,並選擇要轉換的影格。
  • 將透明像素疊在白色背景上,使其具有明確的亮度。
  • 計算文字網格的高度,並考量一般等寬字元儲存格的形狀。
  • 將影像縮放至預定的欄數與列數。
  • 將每個縮放後的像素轉換為亮度值,並從密度階梯中選擇字元。
  • 以換行分隔符連接各列字元,建立最終文字。

逐步建立 Python 轉換器

下列工作流程會建立可重複使用的指令碼,而不會將轉換功能繫結至特定影像。程式碼片段使用分號,讓多個簡短的 Python 陳述式能放在同一個顯示行中;你也可以將每個陳述式各自放在一行。

  1. 建立 Python 環境並安裝 Pillow。在專案資料夾中執行 python -m venv .venv。在 Windows 上使用 .venv\Scripts\activate 啟用它,或在 macOS 與 Linux 上使用 source .venv/bin/activate,接著以 python -m pip install Pillow 安裝相依套件。使用 python -m pip 有助於確保套件安裝在將執行指令碼的同一個 Python 直譯器中。
  2. 建立名為 image_to_ascii.py 的檔案,並加入匯入與設定:from pathlib import Path; from PIL import Image, ImageOps; RAMP = "@%#*+=-:. "; source_path = "input.jpg"; columns = 100; reverse = False。此階梯刻意以空格結尾,因此請將最後那個字元保留在結束引號內。範例使用十個字元,因為其亮度映射會選取從零到九的索引。
  3. 解碼影像、選擇第一個影格,並將透明度疊在白色背景上:source = Image.open(source_path); source.seek(0); rgba = source.convert("RGBA"); source.close(); white = Image.new("RGBA", rgba.size, (255, 255, 255, 255)); rgb = Image.alpha_composite(white, rgba).convert("RGB"); gray = ImageOps.grayscale(rgb)。對於動畫 GIF,此指令碼會轉換第一個影格,而不會跟隨其動畫播放。
  4. 計算輸出高度,並將影像縮放至文字網格:width, height = gray.size; rows = max(1, int(height / width * columns * 0.5 + 0.5)); small = gray.resize((columns, rows), Image.Resampling.LANCZOS); ramp = RAMP[::-1] if reverse else RAMP; pixels = list(small.getdata())。此處的 columns 是輸出寬度的字元數,而非來源像素數。請將其設為適合目標終端機或文字編輯器的正整數。
  5. 將灰度值映射至字元,並組合各列:to_char = lambda pixel: ramp[min(9, max(0, int(pixel / 255 * 9 + 0.5)))]; render_row = lambda row_number: "".join(to_char(pixel) for pixel in pixels[row_number * columns:(row_number + 1) * columns]); text = "\n".join(map(render_row, range(rows)))。to_char 函式會將最深的灰度值映射至階梯的第一個字元,並將最淺的值映射至最後一個字元。render_row 函式則會一次收集一列。
  6. 顯示並儲存完成的藝術字:print(text); Path("output.txt").write_text(text, encoding="utf-8")。使用 python image_to_ascii.py 執行程式。終端機會收到預覽,而 output.txt 只包含產生的字元與換行分隔符。

若要轉換其他圖片,請將 source_path 替換為其檔名或完整路徑。當反向密度方向更能呈現影像時,將 reverse 設為 True。

維持字元網格的比例

ASCII 輸出通常以等寬字型顯示,但字元儲存格的高度通常比寬度大。實用的列數計算方式是 round(source height ÷ source width × output columns × 0.5),最少一列。0.5 係數可補償字元儲存格約為一比二的外形比例。

例如,在 100 欄的條件下,1200 × 600 的來源影像會產生 600 ÷ 1200 × 100 × 0.5 = 25 rows,形成 100 欄乘 25 列的網格。這項修正可在產生的文字網格中保留來源比例,而不會將每個字元儲存格視為正方形。

結果顯示於編輯器、終端機或網頁後,看起來仍可能較高或較矮。字型選擇、行高、縮放與字元間距都會影響最終顯示。請使用行距緊密的等寬字型;若終端機會換行顯示過長的列,請減少欄數。

選擇並反轉密度階梯

在範例中,一般階梯會從代表深色像素的 @ 逐漸移向代表淺色像素的空格。設定 reverse = True 會反轉整個序列,使淺色區域獲得密度較高的字元,而深色區域則獲得密度較低的字元。

  • 使用提供的亮度公式時,請將階梯維持為十個符號;變更其長度時,也必須變更索引計算方式。
  • 對於明亮主體配深色背景,或淺色背景配深色文字的影像,請測試兩個方向。
  • 若色調看起來過於平淡,請在縮放前增加對比,但避免在細節豐富的照片中放大壓縮雜訊。
  • 若細小的臉部或建築特徵消失,請增加欄數,同時確認目標環境能顯示較長的列。

每個字元只由縮放後的亮度網格決定。即使此指令碼會在映射色調前將影像轉換為灰度,也不會保留原始色彩。

修正常見的 Python 轉換問題

  • 「No module named PIL」:使用啟動指令碼的同一套 Python 安裝或虛擬環境,以 python -m pip install Pillow 安裝 Pillow。
  • 「Cannot identify image file」:副檔名相符並不能證明檔案含有有效的影像資料。請確認來源確實是影像,並確認已安裝的 Pillow 版本包含可解碼其格式與編碼設定的解碼器。
  • 結果只有一個影格:此範例會明確選擇第零影格。若要選擇動畫 GIF 的其他影格,請在將其轉換為 RGBA 之前呼叫 source.seek(frame_number)。
  • 透明區域看起來是黑色:如指令碼所示,在轉換為灰度前,將 RGBA 影像疊在白色背景上。如此完全透明的區域就會像淺色背景,而非不透明的黑色區域。
  • 列在終端機中換行:請減少欄數或降低終端機字型大小。即使目前使用的終端機太窄,無法將每列顯示在一行內,產生的檔案仍可能有效。
  • 輸出與瀏覽器轉換器不同:Pillow 的灰度轉換與 LANCZOS 重採樣不一定會產生與瀏覽器 Canvas 處理完全相同的取樣像素。字元映射原理可能相同,但個別字元仍可能不同。

在瀏覽器中執行相同的轉換

若要使用無須設定的替代方案,Image To Ascii 會在目前的瀏覽器分頁中,於本機執行相同的亮度轉文字流程。支援的順序很直接:

  1. 選擇一個 PNG、JPEG、GIF 或 WebP 檔案,且其大小須在可見的編碼與解碼限制內。
  2. 輸入 10 至 200 個字元的完整輸出寬度,並選擇是否反轉固定的密度階梯。
  3. 產生完整的 ASCII 結果,然後複製可見文字或下載本機 TXT 檔案。

瀏覽器必須實際解碼影像後才能進行轉換。副檔名或 MIME 類型相符只會通過最初的格式檢查;內容格式錯誤或不支援的編碼設定仍可能在解碼期間失敗。動畫 GIF 輸入會視為單一靜止影格,而不會播放為動畫。

功能 Python 指令碼 Image To Ascii
輸入 由已安裝的 Pillow 版本解碼的一個本機路徑 由瀏覽器解碼的一個 PNG、JPEG、GIF 或 WebP
處理位置 本機 Python 程序 目前的瀏覽器分頁
輸出寬度 由指令碼設定;資源使用量取決於產生的大小 嚴格限定為 10 至 200 的十進位整數
密度控制 範例中可編輯的十字元階梯,以及反向旗標 固定的十字元階梯,以及可選的反向設定
動畫 此範例中的第一個影格 一個靜止影格
輸出 主控台文字與 UTF-8 TXT 檔案 可複製的預覽與本機純文字下載
來源限制 取決於 Pillow 與可用的系統資源 15 MiB 的編碼大小、每個解碼邊長 8,192 像素,以及 24 million 個解碼像素
結果限制 此範例中沒有固定的文字上限 50,000 個字元,包含每個換行分隔符

決定轉換能否完成的瀏覽器限制

瀏覽器工具的寬度欄位採嚴格驗證。10 與 200 的寬度可接受,而超出該範圍的值會導致失敗,不會自動限制在範圍內。此欄位也會拒絕正負號、單位、空白、小數、前導零形式與科學記號。

即使要求的寬度有效, tall 的影像仍可能超過 50,000 個字元的結果預算。在這種情況下,工具會回報限制,且不會產生部分預覽或下載檔案;它絕不會在未告知的情況下縮短完整結果。不支援或超過限制的來源影像也會清除先前的 ASCII,而不會留下未完成的輸出。

所有解碼、縮放、像素讀取、亮度計算、複製與 TXT 建立作業都在目前的瀏覽器分頁中進行。影像、像素、產生的文字與檔名不會上傳至 Lizely。瀏覽器的重採樣結果也可能因算繪引擎而略有差異,尤其是細緻圖樣或大幅縮小的影像。

瞭解文字輸出會保留哪些內容

ASCII art 是一種亮度視覺化呈現,因此可下載的文字內容遠不如原始影像完整。如果視覺逼真度、透明度、動畫、中繼資料、相機資訊、圖層、嵌入描述檔或封存細節很重要,請保留原始檔案。

  • 輸出內容包含一般字元與換行分隔符,而不是原始的壓縮影像。
  • 色彩、透明度、動畫、中繼資料、相機資訊、圖層與嵌入描述檔都不會保留。
  • 計算亮度時,原始影像中透明的像素會合成至白色背景上。
  • 瀏覽器工具採用 W3C 相對亮度,而 Python 範例採用 Pillow 的灰階轉換,因此相同的來源檔案可能產生不同的字元。
  • 採用較緊密行高的等寬字型,可在各種瀏覽器、編輯器與終端機中提供最一致的預覽效果。