RGBFix Documentation


Table of Contents




History

The history of RGBFix
Version Dated Release notes
1.0 1 Oct. 96 First release
1.01 3 Dec. 96 -t didn't Work. Fixed.
1.02 20 July 1997 RGBFix can now also truncate the ROM-images to a valid size.
1.04 ?? ???? 1999 Added command line option -c/-o for Gameboy Colour compatibility mode.
1.05 9 February 2000 Added command line option -q to supress messages (quiet mode).



Usage


    rgbfix [options] image[.gb]

Options are preceded by a dash (-) and go as follows:

t name : Change title field of image
q : Quiet mode (suppress al output except errors)
p : Pad image to valid size
m : Change RAM size of cartridge
b : Set MBC type
c : Set Colour Gameboy compatible mode
o : Set Colour Gameboy only mode
v : Validate header
d : Debug, don't change image
r : Truncate image to valid size
h : Short help text

Note: RGBFix was previously released by me as a standalone program known as GBFix. I have chosen to release it in the ASMotor package instead from now on. Its usage has changed a bit from that of GBFix for the sake of consistence with the other ASMotor tools. Being part of RGBDS means RGBFix' distribution now follows the same rules as the rest of the ASMotor package. GBFix still follows its own rules.



Options

How to use the various options.


Titlefield

This option changes the titlefield of the image to the string you specify truncated to a maximum of 16 characters. No uppercase conversion is performed.

    rgbfix -tASMOTOR foobar.gb


Pad Image

Pad the image to a valid size. 32Kb, 64Kb, 128Kb, 256Kb and 512Kb. RGBFix intelligently decides which one to use. The cartridge size byte in the image header is left unchanged. If you find this undesireable use the Validate Header option.

    rgbfix -p foobar.gb


Truncate Image

Truncates the image to a valid size. 32Kb, 64Kb, 128Kb, 256Kb and 512Kb. RGBFix intelligently decides which one to use. The cartridge size byte in the image header is left unchanged. If you find this undesireable use the Validate Header option.

    rgbfix -r foobar.gb


Validate Header

Examines the header for errors and validates them if any.

Areas examined:


    rgbfix -v foobar.gb


Debug

Pretends it performs the desired changes.

    rgbfix -tASMOTOR -p -v -d foobar.gb


Last updated 18 July 1997 by Carsten Sorensen