ncgr2tga - Man Page
Nintendo NCGR image to TGA converter
Synopsis
ncgr2tga | [options] width height ncgr [ngr ...] nclr tga |
Description
ncgr2tga converts Nintendo's tile-based NCGR images into common TGA images.
2D graphics on the Nintendo DS is fundamentally tile-based. Specifically, the graphics data in NCGR is ordered in tiles of 8×8 pixels. Moreover, an NCGR file can itself be a tile of a larger image. This tool can automatically combine and unwrap these tiles, and, together with an NCLR file for the palette, converts a grid of NCGR into a plain old linear TGA image.
Options
- -h
- --help
Show a help text and exit.
- --version
Show version information and exit.
- width
The width of the NCGR grid, in NCGR files.
- height
The height of the NCGR grid, in NCGR files.
- ncgr
The name of an NCGR file to use. The NCGR contains the pixel graphics part of the image.
width × height NCGR files have to be given; they are drawn into the final TGA in row-major order. An empty filename, commonly specified with "", means that this grid cell will be empty, filled with palette entry 0.
- nclr
The name of the NCLR file to use. The NCLR file contains the palette part of the image.
- tga
The resulting TGA file will be written there.
Limitations
Only NCGR files with version 1.1 are supported
Only NCLR files with version 1.0 are supported
Only palettes with bit-depths of 4 or 8 are supported
Non-tiled or partitioned NCGR files are not supported
Some NCGR files don't contain valid width/height values, and seem to need an NCER file for this information. These files are currently not supported
Examples
Convert a 2×3 grid of NCGR files:
$ ncgr2tga 2 3 a0.ncgr a1.ncgr a2.ncgr a3.ncgr a4.ncgr a5.ncgr \ a.nclr a.tga
Convert a 2×2 grid of NCGR files, leaving the lower left quadrant blank:
$ ncgr2tga 2 2 b0.ncgr, b1.ncgr "" b2.ncgr b.nclr b.tga
See Also
More information about the xoreos project can be found on its website.
Authors
This program is part of the xoreos-tools package, which in turn is part of the xoreos project, and was written by the xoreos team. Please see the AUTHORS
file for details.