Skip to content

Commit a2738e2

Browse files
committed
Add logo mode walkthrough with photo vs logo comparison
Shows ASCII_MCP text through both modes — explains auto-invert, trimming, clean spaces, and why mode selection matters.
1 parent c1c6aeb commit a2738e2

File tree

4 files changed

+23
-1
lines changed

4 files changed

+23
-1
lines changed

.gitignore

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -178,4 +178,6 @@ docs/
178178
!ascii_preview.png
179179
!ascii_logo_preview.png
180180
!charset_*.png
181-
!width_*.png
181+
!width_*.png
182+
!logo_example.png
183+
!logo_photo_mode.png

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,26 @@ Two modes — **photo** and **logo** — with smart defaults for each.
1818

1919
![Logo mode — horse silhouette as ASCII art](ascii_logo_preview.png)
2020

21+
### How Logo Mode Works
22+
23+
Logo mode is designed for images with a clear subject on a uniform background — logos, text, icons, silhouettes.
24+
25+
Here's a black-and-white "ASCII_MCP" text image run through **logo mode**:
26+
27+
![Logo mode — ASCII_MCP text](logo_example.png)
28+
29+
What logo mode does automatically:
30+
1. **Detects the light background** by sampling the corners of the image
31+
2. **Auto-inverts** so the dark text becomes dense characters (`@%#*`) and the white background becomes empty space
32+
3. **Trims whitespace** borders so the output is tight around the subject
33+
4. **Uses real spaces** instead of `` fill, keeping the background clean
34+
35+
Compare with the same image in **photo mode** (wrong mode for this):
36+
37+
![Photo mode on a logo — ░ fill makes it muddy](logo_photo_mode.png)
38+
39+
Photo mode fills every empty pixel with ``, which destroys the negative space that defines the logo. That's why mode matters.
40+
2141
## Quick Start
2242

2343
Works out of the box as an MCP server — install it, add it to your config, done.

logo_example.png

5.76 KB
Loading

logo_photo_mode.png

6.87 KB
Loading

0 commit comments

Comments
 (0)