Mirrors/gbdk-2020
2
0
Fork 0
mirror of https://github.com/gbdk-2020/gbdk-2020.git synced 2026-03-12 10:18:28 +01:00
Code Issues Packages Projects Releases Wiki Activity

update docs

Browse Source
This commit is contained in:
Toxa
2021-03-16 20:02:32 +03:00
parent 2255240ec8
commit 9353d57f70
179 changed files with 2533 additions and 1975 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
docs/api/docs_example_programs.html
View File

@@ -7,7 +7,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.20"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>GBDK 2020 Docs: GBDK Example Programs</title>
<title>GBDK 2020 Docs: Example Programs</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
@@ -86,23 +86,23 @@ $(document).ready(function(){initNavTree('docs_example_programs.html',''); initR
<div class="PageDoc"><div class="header">
<div class="headertitle">
<div class="title">GBDK Example Programs </div> </div>
<div class="title">Example Programs </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>GBDK includes several example programs both in C and in assembly. They are located in the examples directory, and in its subdirectories. They can be built by typing <code>make</code> in the correnponding directory.</p>
<h1><a class="anchor" id="autotoc_md87"></a>
<h1><a class="anchor" id="autotoc_md92"></a>
banks (various projects)</h1>
<p>There are several different projects showing how to use ROM banking with GBDK.</p>
<h1><a class="anchor" id="autotoc_md88"></a>
<h1><a class="anchor" id="autotoc_md93"></a>
comm</h1>
<p>Illustrates how to use communication routines.</p>
<h1><a class="anchor" id="autotoc_md89"></a>
<h1><a class="anchor" id="autotoc_md94"></a>
crash</h1>
<p>Demonstrates how to use the optional GBDK crash handler which dumps debug info to the Game Boy screen in the event of a program crash.</p>
<h1><a class="anchor" id="autotoc_md90"></a>
<h1><a class="anchor" id="autotoc_md95"></a>
colorbar</h1>
<p>The colorbar program, written by Mr. N.U. of TeamKNOx, illustrates the use of colors on a Color GameBoy.</p>
<h1><a class="anchor" id="autotoc_md91"></a>
<h1><a class="anchor" id="autotoc_md96"></a>
dscan</h1>
<p>Deep Scan is a game written by Mr. N.U. of TeamKNOx that supports the Color GameBoy. Your aim is to destroy the submarines from your boat, and to avoid the projectiles that they send to you. The game should be self-explanatory. The following keys are used: </p><pre class="fragment">RIGHT/LEFT : Move your boat
A/B : Send a bomb from one side of your boat
@@ -113,45 +113,48 @@ When game is paused:
SELECT : Invert A and B buttons
RIGHT/LEFT : Change speed
UP/DOWN : Change level
</pre><h1><a class="anchor" id="autotoc_md92"></a>
</pre><h1><a class="anchor" id="autotoc_md97"></a>
filltest</h1>
<p>Demonstrates various graphics routines.</p>
<h1><a class="anchor" id="autotoc_md93"></a>
<h1><a class="anchor" id="autotoc_md98"></a>
fonts</h1>
<p>Examples of how to work with the built in font and printing features.</p>
<h1><a class="anchor" id="autotoc_md94"></a>
<h1><a class="anchor" id="autotoc_md99"></a>
galaxy</h1>
<p>A C translation of the space.s assembly program.</p>
<h1><a class="anchor" id="autotoc_md95"></a>
<h1><a class="anchor" id="autotoc_md100"></a>
gb-dtmf</h1>
<p>The gb-dtmf, written by Osamu Ohashi, is a Dual Tone Multi-Frequency (DTMF) generator.</p>
<h1><a class="anchor" id="autotoc_md96"></a>
<h1><a class="anchor" id="autotoc_md101"></a>
irq</h1>
<p>Illustrates how to install interrupt handlers.</p>
<h1><a class="anchor" id="autotoc_md97"></a>
<h1><a class="anchor" id="autotoc_md102"></a>
large map</h1>
<p>Shows how to scroll with maps larger than 32 x 32 tiles using <a class="el" href="gb_8h.html#a9369a5771b340680f4af3386ac4e19b2">set_bkg_submap()</a>. It fills rows and columns at the edges of the visible viewport (of the hardware Background Map) as it scrolls from the desired sub-region of the large map.</p>
<h1><a class="anchor" id="autotoc_md103"></a>
lcd isr wobble</h1>
<p>An example of how to use the LCD ISR for visual special effects</p>
<h1><a class="anchor" id="autotoc_md98"></a>
<h1><a class="anchor" id="autotoc_md104"></a>
paint</h1>
<p>The paint example is a painting program. It supports different painting tools, drawing modes, and colors. At the moment, it only paints individual pixels. This program illustrates the use of the full-screen drawing library. It also illustrates the use of generic structures and big sprites. </p><pre class="fragment">Arrow keys : Move the cursor
SELECT : Display/hide the tools palette
A : Select tool
</pre><h1><a class="anchor" id="autotoc_md99"></a>
</pre><h1><a class="anchor" id="autotoc_md105"></a>
rand</h1>
<p>The rand program, written by Luc Van den Borre, illustrates the use of the GBDK random generator.</p>
<h1><a class="anchor" id="autotoc_md100"></a>
<h1><a class="anchor" id="autotoc_md106"></a>
ram_fn</h1>
<p>The ram_fn example illustrates how to copy functions to RAM or HIRAM, and how to call them from C.</p>
<h1><a class="anchor" id="autotoc_md101"></a>
<h1><a class="anchor" id="autotoc_md107"></a>
rpn</h1>
<p>A basic RPN calculator. Try entering expressions like 12 134* and then 1789+.</p>
<h1><a class="anchor" id="autotoc_md102"></a>
<h1><a class="anchor" id="autotoc_md108"></a>
samptest</h1>
<p>Demonstration of playing a sound sample.</p>
<h1><a class="anchor" id="autotoc_md103"></a>
<h1><a class="anchor" id="autotoc_md109"></a>
sgb (various)</h1>
<p>A collection of examples showing how to use the Super Game Boy API features.</p>
<h1><a class="anchor" id="autotoc_md104"></a>
<h1><a class="anchor" id="autotoc_md110"></a>
sound</h1>
<p>The sound example is meant for experimenting with the soung generator of the GameBoy (to use on a real GameBoy). The four different sound modes of the GameBoy are available. It also demonstrates the use of bit fields in C (it's a quick hack, so don't expect too much from the code). The following keys are used: </p><pre class="fragment">UP/DOWN : Move the cursor
RIGHT/LEFT : Increment/decrement the value
@@ -161,14 +164,17 @@ START : Play the current mode's sound (or all modes if in control screen)
START+A : Play a little music with the current mode's sound
SELECT : Change the sound mode (1, 2, 3, 4 and control)
SELECT+A : Dump the sound registers to the screen
</pre><h1><a class="anchor" id="autotoc_md105"></a>
</pre><h1><a class="anchor" id="autotoc_md111"></a>
space</h1>
<p>The space example is an assembly program that demonstrates the use of sprites, window, background, fixed-point values and more. The following keys are used: </p><pre class="fragment">Arrow keys : Change the speed (and direction) of the sprite
Arrow keys + A : Change the speed (and direction) of the window
Arrow keys + B : Change the speed (and direction) of the background
START : Open/close the door
SELECT : Basic fading effect
</pre> </div></div><!-- contents -->
</pre><h1><a class="anchor" id="autotoc_md112"></a>
templates</h1>
<p>Two basic template examples are provided as a starting place for writing your GBDK programs. </p>
</div></div><!-- contents -->
</div><!-- PageDoc -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.8.14-->