Import Bitmaps

Previous Topic  Next Topic 

Halo 2 Tool's bitmaps command converts TIFF (.tif), TARGA (.tga), JPEG (.jpg), and Windows bitmap (.bmp) image files into compact Halo 2 .bitmap files that can be loaded and drawn by the game engine. Image files that are intended to be used as Halo 2 .bitmap files must have pixel dimensions that are powers of two—that is, the length and width are any of 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024, or 2048 pixels long.

The bitmaps command operates on an entire directory, scanning for and converting any file type that it recognizes within the folder specified by the input parameter.


C:\<Halo2ArchitectDirectory>\H2Tool bitmaps <directory>


<directory>: The location of the directory containing image files that Halo 2 Tool will convert into .bitmap files. This parameter can be relative ("scenarios\bitmaps...") instead of absolute (C:\...") as long Halo 2 Tool is run from a valid Halo 2 directory structure.


This example will result in .bitmap files that are created or reimported into the C:\Halo 2 Work\tags\scenarios\bitmaps\multi\gladiator\ directory, provided the source directory contains valid image files.

C:\<Halo2ArchitectDirectory>\H2Tool bitmaps "C:\Halo 2 Tool\data\scenarios\bitmaps\multi\gladiator"

If successful, Halo 2 Tool will create .bitmap files in the \tags\ folder off of the specified folder's base directory and set up any additional subdirectories needed. If an image file already has a corresponding .bitmap file in the \tags\ directory structure, it is reimported using the potentially updated compression settings specified in the existing .bitmap file. New image files create .bitmap files using the default compression method.

Errors and other notable events encountered during the conversion process are reported on the command-line screen and recorded in debug.html, found in the base directory of the image files that are being imported.


Courtesy of Halo Maps website
Halo 2 Vista Maps