mirror of
https://github.com/gbdev/rgbds.git
synced 2025-11-20 10:12:06 +00:00
e895832b2b
The code comes from the RGBDS source and documentation zip files found on this website: http://www.otakunozoku.com/1999/08/01/rednex-gameboy-development-system/ The same website reports: "Best of all, it’s free! That’s right! Free! The executables are free to use, either for personal hobby use, or full blown commercial productions — I know of at least a dozen commercial games you can purchase that are written with RGBDS — and the source code is free to modify. "The only thing I ask is that you do not charge for either distributing the executables or source code, and any derivative works you give credit to the original authors of the tools. That means you have to say “Thanks” to the original authors SurfSmurf and Otaku." Signed-off-by: Vegard Nossum <vegard.nossum@gmail.com>
102 lines
3.5 KiB
HTML
102 lines
3.5 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>RGBFix</TITLE>
|
|
</HEAD>
|
|
|
|
<BODY BGCOLOR="#692764" TEXT="#F5A0D8" LINK="#8AAEE6" VLINK="#2B9DA4" ALINK="#95F0DA">
|
|
<HR><CENTER>
|
|
<TABLE CELLPADDING=25 BORDER=0 BGCOLOR="#000000">
|
|
<TR>
|
|
<TD><FONT COLOR="#FFFFFF"><H2>RGBFix Documentation</H2></FONT></TD>
|
|
</TR>
|
|
</TABLE>
|
|
<HR>
|
|
<H2>Table of Contents<BR></H2></CENTER>
|
|
<UL>
|
|
<LI><A HREF="#History">History</A>
|
|
<LI><A HREF="#Usage">Usage</A>
|
|
<LI><A HREF="#Options">Options</A>
|
|
</UL>
|
|
<BR><HR><H3><BR><A NAME="History">History</A></H3>
|
|
<TABLE BORDER=1>
|
|
<CAPTION><I>The history of RGBFix</I></CAPTION>
|
|
<TR>
|
|
<TD ALIGN="Center"><B><I>Version</I></B></TD>
|
|
<TD ALIGN="Center"><B><I>Dated</I></B></TD>
|
|
<TD><B><I>Release notes</I></B></TD>
|
|
</TR>
|
|
<TR>
|
|
<TD ALIGN="Center">1.0</TD>
|
|
<TD ALIGN="Center">1 Oct. 96</TD>
|
|
<TD>First release</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD ALIGN="Center">1.01</TD>
|
|
<TD ALIGN="Center">3 Dec. 96</TD>
|
|
<TD>-t didn't Work. Fixed.</TD>
|
|
</TR>
|
|
<TR>
|
|
<TD ALIGN="Center">1.02</TD>
|
|
<TD ALIGN="Center">20 July 1997</TD>
|
|
<TD>RGBFix can now also truncate the ROM-images to a valid size.</TD>
|
|
</TD>
|
|
</TABLE>
|
|
<BR>
|
|
<HR><H3><BR><A NAME="Usage">Usage</A></H3><BR>
|
|
<PRE> rgbfix [options] image[.gb]</PRE>
|
|
<BR>
|
|
Options are preceded by a dash (-) and go as follows:<BR>
|
|
<BR>
|
|
<PRE> t<B>name</B> : Change title field of image
|
|
p : Pad image to valid size
|
|
v : Validate header
|
|
d : Debug, don't change image
|
|
r : Truncate image to valid size
|
|
h : Short help text</PRE>
|
|
<P><FONT SIZE="-1"><B>Note:</B> <B>RGBFix</B> was previously released by me as a standalone program known as GBFix.
|
|
I have chosen to release it in the <B>ASMotor</B> package instead from now on. Its usage has changed a bit from that of GBFix
|
|
for the sake of consistence with the other <B>ASMotor</B> tools. Being part of <B>RGBDS</B> means <B>RGBFix</B>'
|
|
distribution now follows the same rules as the rest of the <B>ASMotor</B> package. GBFix still follows its own rules.</FONT> <BR>
|
|
<BR><HR><H3><BR><A NAME="Options">Options</A></H3>
|
|
<P>How to use the various options.
|
|
<H4><BR>
|
|
Titlefield</H4>
|
|
<P>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.<BR>
|
|
<BR>
|
|
<PRE> rgbfix -tASMOTOR foobar.gb</PRE>
|
|
<H4><BR>Pad Image</H4>
|
|
<P>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.<BR>
|
|
<BR>
|
|
<PRE> rgbfix -p foobar.gb</PRE>
|
|
<H4><BR>Truncate Image</H4>
|
|
<P>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.<BR>
|
|
<BR>
|
|
<PRE> rgbfix -r foobar.gb</PRE>
|
|
<H4><BR>
|
|
Validate Header</H4>
|
|
<P>Examines the header for errors and validates them if any.<BR>
|
|
<BR>
|
|
Areas examined:
|
|
<UL>
|
|
<LI>Nintendo Character Area
|
|
<LI>ROM size byte
|
|
<LI>Cartridge type byte
|
|
<LI>Checksums
|
|
</UL>
|
|
<BR>
|
|
<PRE> rgbfix -v foobar.gb</PRE>
|
|
<H4><BR>
|
|
Debug</H4>
|
|
<P>Pretends it performs the desired changes.<BR>
|
|
<BR>
|
|
<PRE> rgbfix -tASMOTOR -p -v -d foobar.gb</PRE>
|
|
<BR>
|
|
<HR>
|
|
<FONT SIZE="-1"><I><P ALIGN=RIGHT>Last updated 18 July 1997 by <A HREF="mailto:surfsmurf@matilde.demon.co.uk">Carsten Sorensen</A></P></I></FONT>
|
|
</BODY>
|
|
</HTML>
|