commit b88ff8d0107bb5505edd0cce7a01aafa7ced6faf
Author: MrjensK <jens.se@icloud.com>
AuthorDate: Wed Apr 22 21:04:11 2026 +0200
Commit: MrjensK <jens.se@icloud.com>
CommitDate: Wed Apr 22 21:04:11 2026 +0200
readme updated
---
README.md | 47 ++++++++++++++++++++++++++++++++++++-----------
1 file changed, 36 insertions(+), 11 deletions(-)
diff --git a/README.md b/README.md
index f1763f8..2a81668 100644
--- a/README.md
+++ b/README.md
@@ -10,16 +10,26 @@ A browser-based editor and viewer for NFO, ANS and ANSI art files. No install, n
- ANSI escape code parser: colors, bold, cursor movement (`ESC[C`, `ESC[H`, etc.)
- Adjustable column width (80 / 160 / auto)
+### New Canvas
+`[ NEW ▾ ]` opens a dropdown with three options:
+- **Empty** — configure columns and rows
+- **From clipboard** — reads the system clipboard and auto-detects column width; falls back to the ANSI code dialog if the clipboard is empty or inaccessible
+- **From ANSI code** — paste raw ANSI escape sequences into a textarea (supports `\x1b` and `\033` escape notation)
+
### Edit
- **Text mode** — type directly onto the canvas with active FG/BG color
- **Draw mode** — click or drag to paint cells with any character + color
- Right-click to erase (drag to erase multiple cells)
- **Select mode** — drag to select a rectangular region
- - Cut / Copy / Paste
+ - Cut / Copy (`Ctrl+C` also copies plain text to the system clipboard) / Paste
+ - Paste from system clipboard (`Ctrl+V`) — supports ASCII art and ANSI art from external apps
- **Move** — click inside a selection and drag to reposition content
- **Eyedropper** — right-click any cell to pick its FG/BG color; or use `[ PICK ]` for one-shot pick
-- 16-color CGA palette for both foreground and background
-- Full-block, half-block and any CP437 character via the character picker (`F2`)
+- **256-color picker** — click the FG or BG color button to open a popup with:
+ - 16 system colors
+ - 6×6×6 color cube (arranged as 6 distinct planes)
+ - 24-step grayscale ramp
+- Full CP437 character set via the character picker (`F2`)
- Insert / delete rows
- Zoom in/out
- Undo / Redo (50 steps)
@@ -27,14 +37,20 @@ A browser-based editor and viewer for NFO, ANS and ANSI art files. No install, n
### Image → ANSI
Convert any image to ANSI art directly in the browser:
- Configurable column/row count with optional aspect-ratio lock
-- Half-block mode (`▀`) for double vertical resolution
+- **ASCII-tecken mode** — maps pixel luminance to a character density ramp (` .:-=+*#%@`) with palette color per cell
+- **Half-block mode** (`▀`) — double vertical resolution using foreground + background color per cell
+- **Full-block mode** (`█`) — one palette color per cell
+- **256-color mode** — uses all 256 xterm colors for nearest-color matching (much better accuracy for photos)
- Floyd–Steinberg dithering for better color gradients
-### Export
-Single `[ EXPORT ▾ ]` button with three formats:
+### Save & Export
+- **`[ SAVE ]`** — saves directly back to the original file (Chrome/Edge only via File System Access API); on other browsers the button is disabled
+ - `Ctrl+S` triggers save; if no file handle exists a save-as dialog appears
+- **`[ EXPORT ▾ ]`** — always downloads a new file:
+
| Format | Description |
|--------|-------------|
-| `.ANS` | ANSI escape codes + color, standard terminal format |
+| `.ANS` | ANSI escape codes + color, standard terminal format; 256-color sequences (`38;5;N`) used automatically when needed |
| `.NFO plain` | Raw CP437 text, no color codes, `\r\n` line endings |
| `.HTML` | Self-contained HTML with inline color styles |
@@ -47,14 +63,17 @@ Single `[ EXPORT ▾ ]` button with three formats:
| Shortcut | Action |
|----------|--------|
| `Ctrl+O` | Open file |
-| `Ctrl+N` | New canvas |
-| `Ctrl+S` | Export ANS |
+| `Ctrl+N` | New (opens dropdown) |
+| `Ctrl+S` | Save directly to file (Chrome/Edge) |
| `Ctrl+Shift+S` | Export HTML |
| `Ctrl+Z` | Undo |
| `Ctrl+Y` | Redo |
+| `Ctrl+C` | Copy selection (+ to system clipboard) |
+| `Ctrl+X` | Cut selection |
+| `Ctrl+V` | Paste — from app clipboard or system clipboard |
| `Tab` | Toggle Text ↔ Draw mode |
| `F2` | Open character picker |
-| `Esc` | Exit edit mode / deselect |
+| `Esc` | Exit edit mode / close dialogs |
| `Ctrl+Delete` | Delete current row |
| `Ctrl+Insert` | Insert empty row |
| `Ctrl++` / `Ctrl+-` | Zoom in / out |
@@ -74,4 +93,10 @@ The editor uses the **IBM VGA 8x16** bitmap font for authentic rendering. The fo
## Browser Support
-Any modern browser with Canvas 2D, `localStorage`, and `FileReader` API support (Chrome, Firefox, Edge, Safari).
+| Feature | Chrome/Edge | Firefox | Safari |
+|---------|-------------|---------|--------|
+| Editor (view, edit, export) | ✓ | ✓ | ✓ |
+| Save directly to file (`Ctrl+S`) | ✓ | — | — |
+| Open with file handle | ✓ | — | — |
+
+Direct save requires the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API), supported in Chrome 86+ and Edge 86+.