1j01/textual-paint
1
1
Fork 0
mirror of https://github.com/1j01/textual-paint.git synced 2024-08-17 03:40:26 +03:00
Code Issues Packages Projects Releases Wiki Activity

Move file formats to a separate section

Browse Source
This commit is contained in:
Isaiah Odhner 2023-07-24 16:01:27 -04:00
parent cbc1ab9314
commit 3630ec8e73
1 changed files with 28 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@ -15,23 +15,7 @@ This is a TUI (Text User Interface) image editor, inspired by MS Paint, built wi
- [x] Drag and drop files to open
- [x] Warnings when overwriting an existing file, or closing with unsaved changes
- [x] Automatically saves a temporary `.ans~` backup file alongside the file you're editing, for recovery in case of a crash
- File formats, chosen by typing a file extension in the Save As dialog:
- [x] ANSI (.ans) — Note that while it handles many more ANSI control codes when loading than those that it uses to save files, you may have limited success loading other ANSI files that you find on the web, or create with other tools. ANSI files can vary a lot and even encode animations!
- [x] mIRC codes (.irc, .mirc) — invented file extensions, and not to be confused with .mrc mIRC script files
- [x] Plain Text (.txt)
- [x] SVG (.svg) — can open SVGs saved by Textual Paint, which embed ANSI data; can also open some other SVGs that consist of a grid of rectangles and text elements. For fun, as a challenge, I made it quite flexible; it can handle uneven grids of unsorted rectangles. But that's only used as a fallback, because it's not perfect.
- [x] HTML (.htm, html) — write-only (opening not supported)
- [x] PNG (.png) — opens first frame of an APNG file
- [x] Bitmap (.bmp)
- [x] GIF (.gif) — opens first frame
- [x] TIFF (.tiff) — opens first frame
- [x] WebP (.webp) — opens first frame
- [x] JPEG (.jpg, .jpeg) — saving disabled because it's lossy (it would destroy your pixel art)
- [x] Windows Icon (.ico) — opens largest size in the file
- [x] Mac OS Icon (.icns) — opens largest size in the file; saving disabled because it requires specific sizes
- [x] Windows Cursor (.cur) — opens largest size in the file; saving not supported by Pillow (and it would need a defined hot spot)
- See [Pillow's documentation](https://pillow.readthedocs.io/en/stable/handbook/image-file-formats.html) for more supported formats.
- Note that metadata is not preserved when opening and saving image files. (This is however common for many image editors.)
- [x] Edits ANSI art and raster images and more. See [File Formats](#file-formats)
- Tools
- [x] Free-Form Select
- [x] Select
@ -145,6 +129,33 @@ The rest match MS Paint's keyboard shortcuts:
- <kbd>Ctrl</kbd>+<kbd>PageUp</kbd>: Large Size
- <kbd>Ctrl</kbd>+<kbd>PageDown</kbd>: Normal Size
### File Formats
Many file formats are supported, including ANSI art, raster images, SVG and HTML.
To choose a file format when saving, type its file extension. For example, to save a PNG, add `.png` to the end of the filename. The default is `.ans`.
| Format | Notes |
| --- | --- |
| **ANSI** (.ans) | Note that while it handles many more ANSI control codes when loading than those that it uses to save files, you may have limited success loading other ANSI files that you find on the web, or create with other tools. ANSI files can vary a lot and even encode animations! |
| **mIRC codes** (.irc, .mirc) | invented file extensions, and not to be confused with .mrc mIRC script files |
| **Plain Text** (.txt) | |
| **SVG** (.svg) | can open SVGs saved by Textual Paint, which embed ANSI data; can also open some other SVGs that consist of a grid of rectangles and text elements. For fun, as a challenge, I made it quite flexible; it can handle uneven grids of unsorted rectangles. But that's only used as a fallback, because it's not perfect. |
| **HTML** (.htm, html) | write-only (opening not supported) |
| **PNG** (.png) | opens first frame of an APNG file |
| **Bitmap** (.bmp) | |
| **GIF** (.gif) | opens first frame |
| **TIFF** (.tiff) | opens first frame |
| **WebP** (.webp) | opens first frame |
| **JPEG** (.jpg, .jpeg) | saving disabled because it's lossy (it would destroy your pixel art) |
| **Windows Icon** (.ico) | opens largest size in the file |
| **Mac OS Icon** (.icns) | opens largest size in the file; saving disabled because it requires specific sizes |
| **Windows Cursor** (.cur) | opens largest size in the file; saving not supported by Pillow (and it would need a defined hot spot) |
See [Pillow's documentation](https://pillow.readthedocs.io/en/stable/handbook/image-file-formats.html) for more supported formats.
Note that metadata is not preserved when opening and saving image files. This is however common for many image editors.
### Tips
You can draw with a character by clicking the selected color display area in the palette and then typing the character,