image_to_braille
Convert images into sharp Unicode braille art and stamp them onto the canvas at a chosen position. Use it for detailed photo, logo, or silhouette rendering with dithering or clean edge outlines.
Instructions
Convert an image file (png, jpg, webp, ...) into high-resolution Unicode braille art and stamp it onto the canvas at (x, y). Each braille cell holds a 2x4 dot grid, so this renders at 2x the horizontal and 4x the vertical resolution of image_to_ascii — the sharpest photo/logo/silhouette rendering here. Dots are 1-bit, so dithering (on by default) fakes tone. The image is fitted to max_width braille cells (rows follow the aspect ratio). Returns the placed size so you can size the canvas first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "image_to_braille"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | ||
| y | No | ||
| path | Yes | Absolute or relative path to the image file. | |
| edges | No | Outline mode: light dots only along steep brightness gradients, turning the image into a clean braille line drawing (ignores dither/tone). | |
| gamma | No | Midtone gamma. 1 = off; <1 deepens shadows, >1 lifts them. | |
| dither | No | 1-bit tone: 'floyd' = Floyd–Steinberg grain (default, best for photos), 'bayer' = ordered cross-hatch, 'none' = hard threshold for line art. | floyd |
| invert | No | Flip which pixels light a dot — use for dark subjects on a light background. | |
| max_width | No | Target width in braille cells (each cell is 2 sub-pixels wide). | |
| threshold | No | Dot cutoff 0..1 for dither='none' (crisp line art). Ignored when dithering. | |
| transparent | No | Composite over existing art — skip blank cells (braille-blank / space) so the render layers on top instead of erasing the background. | |
| auto_contrast | No | Stretch the brightness range for a sharper result. | |
| edge_threshold | No | Edge sensitivity 0..1 for `edges` (lower = more contour detail). |