shithub: rgbds

ref: 38372c59edb070d2c0320d21c6cf898e118e3e26
dir: /doc/asm/incbin.htm/

View raw version
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
	<title>xAsm INCBIN</title>
        <link rel="stylesheet" type="text/css" href="../style.css">
</head>
<body>
<h1>INCBIN</h1>
<p>You  probably have some graphics you’d like to include. Use <dfn>INCBIN</dfn> 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.</p>
<pre>INCBIN    "titlepic.bin"
INCBIN    "sprites\\hero.bin"</pre>
<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.</p>
<pre>INCBIN    "data.bin",78,256</pre>
<h1>See also:</h1>
<ul>
	<li><a href="expr_str.htm">String expressions, functions and formatting</a>
</ul>
<hr>
<p>Last updated 21 June 1997 by <a href="mailto:[email protected]">Carsten Sorensen</a></p>
</body>
</html>