NAME

     cbgt2tga — CBGT image to TGA converter

SYNOPSIS

     cbgt2tga [options] cbgt pal 2da tga

DESCRIPTION

     cbgt2tga converts CBGT image files into common TGA images.  CBGT, Compressed BackGround
     Tiles, are used as area background images in BioWare's Nintendo DS game Sonic Chronicles:
     The Dark Brotherhood.

     Internally, a CBGT consists of a collection of 64×64 pixel cells, divided into tiles of 8×8
     pixels.  Each cell is compressed using Nintendo's 0x10 LZSS algorithm.  Moreover, PAL files
     with the same name as the CBGT file contain the palette data, and 2DA files with the same
     name yet again contain the mapping of palette indices onto cells.

     The width and height of the final image is not stored within the CBGT file, but the palette
     mapping 2DA does contain the number cells in X and Y direction, since it stores the palette
     indices in a two-dimensional array of those dimensions.  Therefore, multiplying the number
     of columns and rows in said 2DA by 64 yields the width and height, respectively, of the
     final image.

OPTIONS

     -h
     --help
         Show a help text and exit.
     --version
         Show version information and exit.
     cbgt
         The name of the CBGT file to read.  The CBGT contains the pixel graphics part of the
         image.
     pal
         The name of the PAL file to use.  The PAL file contains the palette part of the image.
     2da
         The name of the 2DA file to use.  The 2DA file contains information on which palette to
         use for each part of the CBGT, and on how many parts are in the CBGT in the first place.
     tga
         The resulting TGA file will be written there.

EXAMPLE

     Convert a CBGT+PAL+2DA into a TGA:

           $ cbgt2tga a.cbgt a.pal a.2da result.tga

SEE ALSO

     cdpth2tga(1), ncgr2tga(1)

     More information about the xoreos project can be found on its website: https://xoreos.org/.

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.