1NCGR2TGA(1)               BSD General Commands Manual              NCGR2TGA(1)
2

NAME

4     ncgr2tga — Nintendo NCGR image to TGA converter
5

SYNOPSIS

7     ncgr2tga [options] width height ncgr [ngr ...] nclr tga
8

DESCRIPTION

10     ncgr2tga converts Nintendo's tile-based NCGR images into common TGA
11     images.
12
13     2D graphics on the Nintendo DS is fundamentally tile-based.  Specifi‐
14     cally, the graphics data in NCGR is ordered in tiles of 8×8 pixels.
15     Moreover, an NCGR file can itself be a tile of a larger image.  This tool
16     can automatically combine and unwrap these tiles, and, together with an
17     NCLR file for the palette, converts a grid of NCGR into a plain old lin‐
18     ear TGA image.
19

OPTIONS

21     -h
22     --help
23           Show a help text and exit.
24     --version
25           Show version information and exit.
26     width
27         The width of the NCGR grid, in NCGR files.
28     height
29         The height of the NCGR grid, in NCGR files.
30     ncgr
31         The name of an NCGR file to use.  The NCGR contains the pixel graph‐
32         ics part of the image.
33
34         width × height NCGR files have to be given; they are drawn into the
35         final TGA in row-major order.  An empty filename, commonly specified
36         with "", means that this grid cell will be empty, filled with palette
37         entry 0.
38     nclr
39         The name of the NCLR file to use.  The NCLR file contains the palette
40         part of the image.
41     tga
42         The resulting TGA file will be written there.
43

LIMITATIONS

45     ·   Only NCGR files with version 1.1 are supported
46     ·   Only NCLR files with version 1.0 are supported
47     ·   Only palettes with bit-depths of 4 or 8 are supported
48     ·   Non-tiled or partitioned NCGR files are not supported
49     ·   Some NCGR files don't contain valid width/height values, and seem to
50         need an NCER file for this information.  These files are currently
51         not supported
52

EXAMPLES

54     Convert a 2×3 grid of NCGR files:
55
56           $ ncgr2tga 2 3 a0.ncgr a1.ncgr a2.ncgr a3.ncgr a4.ncgr a5.ncgr \
57             a.nclr a.tga
58
59     Convert a 2×2 grid of NCGR files, leaving the lower left quadrant blank:
60
61           $ ncgr2tga 2 2 b0.ncgr, b1.ncgr "" b2.ncgr b.nclr b.tga
62

SEE ALSO

64     cbgt2tga(1)
65
66     More information about the xoreos project can be found on its website:
67     https://xoreos.org/.
68

AUTHORS

70     This program is part of the xoreos-tools package, which in turn is part
71     of the xoreos project, and was written by the xoreos team.  Please see
72     the AUTHORS file for details.
73
74BSD                              July 23, 2015                             BSD
Impressum