OS4 DepotLogo by Marko 
(anonymous IP:,2192) 

   Bug tracker
   Locale browser


   o Audio (343)
   o Datatype (51)
   o Demo (203)
   o Development (595)
   o Document (22)
   o Driver (97)
   o Emulation (147)
   o Game (1004)
   o Graphics (497)
   o Library (115)
   o Network (232)
   o Office (66)
   o Utility (923)
   o Video (69)

Total files: 4364

Full index file
Recent index file



Support the site

 Readme for:  Development » Cross » nes_sprtools.lha


Description: Tools to convert BMP images to NES formats
Download: nes_sprtools.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size: 500kb
Date: 19 Sep 2006
Author: Bob Rost, AmigaOS 4.0 compile by Spot / Up Rough
Submitter: Spot / Up Rough
Email: spot/triad se
Homepage: http://bobrost.com/
Category: development/cross
License: Public domain
Distribute: yes
Min OS Version: 4.0
FileID: 2078
Comments: 0
Snapshots: 0
Videos: 0
Downloads: 528  (Current version)
528  (Accumulated)
Votes: 0 (0/0)  (30 days/7 days)

Show comments Show snapshots Show videos Show content Show crashlogs Replace file 
NES Sprite Tools
March 18, 2004

The Windows versions of these tools require the cygwin1.dll file. This file is
available from Bob Rost's NES development resources page.


 Included tools (and author):



Bob Rost 



Bob Rost 



Bob Rost 



Bob Rost 



Bob Rost 



Bob Rost 



Bob Rost 



Joey Echeverria  


 General Usage:

 These tools convert between various kinds of bitmaps images and other data
formats useful in creating games for the NES. Due to the BMP image loader used
in these tools, any BMP image used must be 24-bit uncompressed color. This is
the standard Windows bitmap output by applications such as Photoshop. The tools
themselves may impose further restrictions on size and number of colors allowed
in the images. All of these tools are command line applications. If you do not
understand how to use them, consult appropriate documentation for using a
command line in your computer's operating system.


 Source Code:

 These tools are released with source code into the public domain. They come
with no warranty. Each of the included tools makes use of the BMPImage class,
written for public domain by Bob Rost. They have been tested under Mac OSX and
should work without modification on most popular operating systems. Under
standard C++ development environments, you should be able to compile all of the
tools with the Makefile.


This command line application converts a BMP image file into a NES CHR file. The
input image size must be 128x128 pixels, and it may contain only the following






becomes sub-palette color 0 





becomes sub-palette color 1 





becomes sub-palette color 2 





becomes sub-palette color 3  


Usage: bmp2chr input.bmp output.chr



 This tool allows you to input bitmaps with information about your desired
level, which can then be automatically converted into usable level data to draw
and use the level in a game. The levels currently supported by the tool may be
one or two screens wide.

 Usage: bmp2level map.bmp pattern.bmp palette.bmp collision.bmp special.bmp



A full-color screenshot of what your level should look like. The tool supports
one or two screens at a time, which means that your image should be either
256x240 pixels, or 512x240 pixels. The tool relies on 16x16 pixel major blocks
to create the map, so your map data should consist of sections of that size from
your pattern table. 



A standard 4-color pattern table, as created by bmp2pattern or chr2bmp, or
required for bmp2chr. The image should be 128x128 pixels. Colors 0, 1, 2, and 3
map to black, white, red, and blue. 



An image 16 pixels wide. Pixels 0, 4, 8, and 12 must all be the same color, to
conform with standard Nintendo color palettes. Only the first row of 16 pixels
will be used in order to load the palette. 



An image the same size as your map data. It should consist of 16x16 pixel
squares of solid color. Black squares indicate no collision at that point, and
white squares indicate collision, meaning that game characters are expected to
be able to stand on the square and not go through it. 



An image the same size as your map data. Like the collision image, it should
consist of 16x16 pixel squares of solid color. The color indicates that a
special object of a particular type exists at that location. Each type is simply
a number, which should be interpreted by your program. The colors map to type
numbers as shown below.





no data 







































The output data file for your level. You may include this file directly in your
rom to use in your game. The binary format is as follows:

1024 or 2048 bytes 

Name and Attribute table data to draw the level. If the level is on screen wide,
then the 1024 bytes may be copied directly to PPU memory at a nametable starting
address, such as $2000, in order to load the nametable and attribute table
correctly. If your level is two screens wide, then the first 1024 bytes will be
the lefthand screen, and the next 1024 bytes will be the righthand screen. 

256 or 512 bytes 

Collision data corresponding to the level. Data is 256 bytes for a one-screen
level, or 512 bytes for a two-screen level. Each byte represents a single major
block from the collision map, and its value is 0 for passable blocks and 1 for
solid blocks. Blocks are addressed in row order from far left to the far right
of the map, from top to bottom. 

3n +1 bytes
for n special items 

Each 3 bytes represents a single special item. The first byte is the item type,
the second byte is the x coordinate, and the third byte is the y coordinate.
Coordinates are in major blocks from the upper left of the map, right and
downward. The list is null-terminated by a single zero.  




 Usage: bmp2palette flag palette.bmp output.dat



You may optionally specify which system palette to use for designating colors.
The available palettes are by Chris Covell, Loopy, and Matthew Conte. If no flag
is specified, then Chris Covell's palette is used by default. The flags for each
palette are as follows:



This image should by 16 pixels wide, and either 1 or 2 pixels tall. It may
consist of any colors you wish, to be matched to the NES palette. However, every
fourth pixel (starting with the upper left pixel) must be the same color, to
conform to NES system restrictions. 



If you wish, you may specify an output filename. This file will be binary data,
16 or 32 bytes, where each byte is the NES system color of the corresponding
pixel, as read in standard row order. If you do not specify an output file, then
the colors will output to the console as an nbasic data statement.  



 This tool converts a BMP image file to a NES-style tile layout version. The
program does not check for color restrictions.

 Usage: bmp2sprite input.bmp output.bmp


An image file that is a multiple of 8x16 pixels. 


The output file. It will be a horizontal arrangement of the input file, 8 pixels
tall. The 8x8 pixel tiles will be read column order from the input and laid into
the output as encountered.  



 This tool converts a pattern table to a 4-color NES compatible pattern table,
based on the provided palette. The user will be alerted of ambiguous palette
matches, and it is the user's responsibility to resolve them manually.

 Usage: bmp2table input.bmp palette.bmp output.bmp


A 128x128 pixel image in full color. 


An image containing multiple sub palettes, to which the full color image will be
matched. The image may contain any number of sub palettes, each one 4x1 pixels.
The palette image may be any multiple of 4x1 pixels. 


A 128x128 pixel image in NES 4 color, consisting of black, white, red, and blue.
This image may be fed to bmp2chr.  



 This tool merges two bitmaps. It compares 8x8 tiles. For each tile which is
blank (solid color) in one of the input tiles and non-blank in the other, the
output file will contain the non-blank tile.

 Usage: bmp2table input1.bmp input2.bmp output.bmp


A 128x128 pixel image. 


A 128x128 pixel image. 


A 128x128 pixel image, created as a result of merging the two input pictures.  



 This command line application converts a NES CHR file to a BMP image. The input
file must be a single-bank CHR ROM (4096 bytes), or else only the first bank
will be used. The output image will be a conversion into 4-color space from the
NES sub-palette entries, with a size of 128x128 pixels. Palette color 0 becomes
black, 1 becomes white, 2 becomes red, and 3 becomes blue.

 Usage: chr2bmp input.chr output.bmp





 Takes a number of input bitmaps and arranges them, in the order provided, into
an output pattern table. It does not attempt to alter any colors.

 Usage: sprites2chrsprite input1.bmp [input2.bmp [...]] output.bmp


An image 8 pixels tall, and a multiple of 8 pixels wide. 


Optional input images, also 8 pixels tall and a multiple of 8 pixels wide. 


A 128x128 pixel pattern table. It will have the same colors as the input files.
The input bitmap images will be concatenated row order into the pattern table,
in rows of 16 tiles.

File Version Size Date OS Dls Readme
nes_dev.lha218kb19 Sep 20064.0599¤ Nes_dev - NES Basic and NES ASM, develop your own NES games!
nes_example.zip23kb19 Sep 20064.0587¤ Nes_example - An example project for NES Basic and NES ASM.
nes_mina.lha249kb20 Sep 20064.0383¤ Nes_mina - Minachun Disassembler for 6502 Famicom (NES)
nes_palette.png11kb19 Sep 20064.0429¤ Nes_palette - A NES palette to use when making NES graphics
Copyright © 2004-2024 by Björn Hagström All Rights Reserved