diff options
| author | Alexey 'Cluster' Avdyukhin <clusterrr@clusterrr.com> | 2022-10-29 18:00:55 +0300 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-10-29 18:00:55 +0300 |
| commit | dc03e3aaa3964b8dc22c37e1dbfb67a5ee4c814a (patch) | |
| tree | b89ef8f968e2d9d63aebdeaf0a82ef230691fa11 | |
| parent | 3d7c309c2bd0b7eac1b02bb7a20d2821e7204484 (diff) | |
Images!
| -rw-r--r-- | README.md | 31 |
1 files changed, 27 insertions, 4 deletions
@@ -2,17 +2,40 @@ Tool for converting pictures into NES format: pattern tables, nametables, attribute tables and palettes.
## What does it do
-When developing applications and games for NES, to display images, you need to split each image into tiles, combine tiles into nametables, select colors so that they do not go beyond the limits of the NES, and then convert all this into a format understandable for the NES. This tool at least partly helps to automate this process. The application can accept multiple images as input, the main point is to use single set of palettes (and tiles if required) for all of them, so it's possible to switch CHR banks and base nametable on a certain line, in the middle of rendering process. You can't change palettes while image renders, so palette set must be the same for all images.
+When developing applications and games for NES, to display images, you need to split each image into tiles, combine tiles into nametables, select colors so that they do not go beyond the limits of the NES, and then convert all this into a format understandable for the NES. This tool at least partly helps to automate this process. The application can accept multiple images as input, the main point is to use single set of palettes (and tiles if required) for all of them, so it's possible to switch CHR banks and base nametable on a certain line, in the middle of rendering process. You can't change palettes while image renders, so palette set must be the same for all images. Of course, the ideal result will be achieved only in the case of properly prepared images that do not go beyond the limitations of NES. But it's possible to do lossy conversion. Check [Examples](https://github.com/ClusterM/NesTiler/tree/master/Examples) directory for examples.
The sequence of actions is as follows:
-* Load available NES colors from JSON or PAL file
-* Load images, crop them if need
+* Load available NES colors from JSON or PAL file and their indices.
+
+
+
+* Load images, crop/split them if need
+
+
+
* Change every pixel of each image, so it's matches most similar color from available NES colors
+
+
+
* Calculate desired number of palettes to fit every image or at least trying to do it
+
+
+
* Generate attribute table for each image, assign palette index for each tiles set
+
+
+
* Change colors of every tile to match assigned palette index (if need)
+
+
+
* Create set of tiles, trying to fit them into 256, grouping same tiles into one
-* Generate pattern table and nametable for each image
+
+
+
+* Save pattern table and nametable of each image to file, so it's easy to include them to NES ROM and show the image
+
+
## How to use
|