Files
rgbds/doc/asm/incbin.htm
2009-09-12 18:53:03 -06:00

45 lines
1.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<TITLE>xAsm INCBIN</TITLE>
<link rel="stylesheet" type="text/css" href="../style.css">
</HEAD>
<BODY>
<I><H2>INCBIN
</H2></I>
<HR>
<P>You probably have some graphics you'd like to include. Use <B>INCBIN</B> to include a raw binary
file as it is. If the file isn't found in the current directory the <A HREF="usage.htm">include-path</A> list will be searched.<BR>
<BR>
<TABLE BORDER=0 BGCOLOR="Black" CELLPADDING=8 WIDTH="50%">
<TR>
<TD><FONT COLOR="#00FF00">
<PRE>INCBIN "titlepic.bin"
INCBIN "sprites\\hero.bin"</PRE>
</FONT></TD>
</TR>
</TABLE>
<P>You can also include only part of a file with <B>INCBIN</B>. The example below includes 256 bytes from <I>data.bin</I> starting from position 78.<BR>
<BR>
<TABLE BORDER=0 BGCOLOR="Black" CELLPADDING=8 WIDTH="50%">
<TR>
<TD><FONT COLOR="#00FF00">
<PRE>INCBIN "data.bin",78,256</PRE>
</FONT></TD>
</TR>
</TABLE>
<H3>See also:</H3>
<UL>
<LI><A HREF="expr_str.htm">String expressions, functions and formatting</A>
</UL>
<BR><HR>
<FONT SIZE="-1"><I><P ALIGN=RIGHT>Last updated 21 June 1997 by <A HREF="mailto:surfsmurf@matilde.demon.co.uk">Carsten Sorensen</A></P></I></FONT>