1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<meta http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<meta name="GENERATOR" content="Microsoft FrontPage 5.0"> 7<meta http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>VI Demos</title> 10</head> 11 12<body> 13 14<h1>VI Demos</h1> 15 16<h2>Location</h2> 17 18<p><CODE>$REVOLUTION_SDK_ROOT/build/demos/videmo</CODE></p> 19 20<h2>Compilation</h2> 21 22<p>Go to the directory <CODE>$REVOLUTION_SDK_ROOT/build/demos/videmo</CODE> and enter <CODE>make</CODE>. The executable file (<code>*.elf</code> file) will be created in the directory <code>$REVOLUTION_SDK_ROOT/build/demos/videmo/bin/RVL/</code>.</p> 23 24<h2>Execution</h2> 25 26<p>You must configure <CODE>DVDRoot</CODE> before execution. Be sure to specify the folder name <CODE>$REVOLUTION_SDK_ROOT/dvddata</CODE> as the <CODE>DvdRoot</CODE> argument of the <CODE>SetNdEnv</CODE> command.</p> 27 28<p>Go to the directory <code>$REVOLUTION_SDK_ROOT/build/demos/videmo/bin/RVL/</code> and do one of the following: 29 30<ul> 31<li>To simply run the application, execute the script <code>XXX</code> (for NDEV) or <code>XXX</code> (for XXX) with the<code>.elf</code> file as the argument</li> 32<li>Run <CODE>ide</CODE> with an <CODE>.elf</CODE> file as an argument (if you want to debug with CodeWarrior)</li> 33</ul> 34 35<h2>Description</h2> 36 37<table border="0" width="776"> 38<TBODY> 39 <tr> 40<td width="161"><strong><code>color</code></strong></td> 41<td width="607"><span>Sample on double-field frame buffers.</span></td> 42 </tr> 43 <tr> 44 <td width="161"></td> 45<td width="607"><span>This demo paints the whole screen with a single color and changes the color once a second.</span></td> 46 </tr> 47 <tr> 48<td width="161"><strong><code>moving</code></strong></td> 49<td width="607"><span>Sample on single-field 60 Hz rendering (field rendering).</span></td> 50 </tr> 51 <tr> 52 <td width="161"></td> 53<td width="607">This demo renders the screen with a simple pattern and moves it. Sample to show how to use <a href="../VIGetNextField.html"><code>VIGetNextField</code></a> in field-rendering mode.</td> 54 </tr> 55 56 57 <tr> 58<td width="161"><strong><code>moving.30Hz</code></strong></td> 59<td width="607"><span>Sample on 30 Hz rendering.</span></td> 60 </tr> 61 <tr> 62 <td width="161"></td> 63<td width="607">This demo works similarly to the <code>moving</code> demo, but in 30 Hz. It shows how to make 30 Hz games.</td> 64 </tr> 65 66 67 68 69 <tr> 70<td width="161"><strong><code>moving.Progressive</code></strong></td> 71<td width="607"><span>Progressive Display Sample.</span></td> 72 </tr> 73 <tr> 74 <td width="161"></td> 75<td width="607">This demo is the same as the <code>moving</code> demo, except that it uses progressive scan for the display. This demo shows how to make progressive display settings.</td> 76 </tr> 77 78 79 80 81 <tr> 82<td width="161"><strong><code>viewer</code></strong></td> 83<td width="607"><span>BMP file viewer.</span></td> 84 </tr> 85 <tr> 86 <td width="161"></td> 87<td width="607">This demo opens all BMP files under <code>DVDRoot/pictures</code> and displays them on screen. Files with with the extensions "BMA" and "BMB" are pairs and appear on screen simultaneously. The "BMA" file is treated as the image for the "above" field and the "BMB" file is treated as the image for the "below" field. (For an explanation of "above" and "below" fields, see "Video Interface Library (VI)" in the <em>Revolution Graphics Programmer's Guide</em>.))</td> 88 </tr> 89 <tr> 90 <td width="161"></td> 91<td width="607">Six versions of the viewer are generated. The "<code>viewer_NTSC_INT</code>" viewer is for NTSC interlaced mode, the "<code>viewer_NTSC_DS</code>" viewer is for NTSC double-strike mode, and so on.</td> 92 </tr> 93 <tr> 94 <td width="161"></td> 95<td width="607">To add a picture, place the BMP file in the <code>DVDRoot/pictures</code> directory. Any files with extensions other than BMP, BMA, and BMB are ignored. Subdirectories under the "<code>pictures</code>" directory are also ignored.</td> 96 </tr> 97 98 99 100 <tr> 101<td><b><i>smp-onetri_PAL</i></b></td> 102<td>This is a PAL version of smp-onetri sample demo. For more information, see the <a href="../../gx/sampledemos/Simple/smp-onetri.html">GX Sample Demo Manual</a>. </td> 103 </tr> 104 105 <tr> 106 <td></td> 107<td>By default, this demo shows PAL 50 Hz mode using Y scaling. By pressing the A button, you can toggle the mode to PAL 60, then PAL 50Hz with black bars, and then back to PAL 50Hz using Y scaling.</td> 108 </tr> 109 110 111 112 113 114 115 <tr> 116<td><b><i>smp-onetri_Progressive</i></b></td> 117<td>This sample tests switching from interlace to progressive using the <CODE>smp_onetri</CODE> sample demo. </td> 118 </tr> 119 120 <tr> 121 <td></td> 122 <td> 123This sample demo shows how to check the VI retrace interrupt timing and test for delay when switching from interlace to progressive scan. If the VI retrace interrupt is delayed, the display may not switch to progressive scan correctly. 124 125This demo first carries out interlaced scan and then automatically switches to progressive scan after about five seconds (six seconds when using PAL). After switching to progressive scan, the result of the progressive switching test (the number of times the VI retrace interrupt was delayed) is displayed on the console. If there is no problem, test results are OK (the VI retrace interrupt delay count = 0). OK always results when using this demo.</br> 126 127If the test results are not good (the VI retrace interrupt delay count is greater than zero) when conducting similar tests in your own applications, check whether interrupts are being disabled for long periods during gameplay. 128 129 </td> 130 </tr> 131 132 133 134 135 <tr> 136<td><b><i>frb-vi-gamma</i></b></td> 137<td>This test adds a VI gamma correction feature to the GX gamma demo <a href="../../gx/sampledemos/Framebuffer/frb-gamma.html">(<code>frb-gamma</code></a>). </td> 138 </tr> 139 140 <tr> 141 <td></td> 142 <td> 143Revolution has two gamma correction modes. One is GX-based gamma correction; the other is VI-based gamma correction. This program tests both GX and VI gamma correction modes. Toggle between the GX and VI gamma correction modes with the Z trigger. For details on other operations, see the page on the <a href="../../gx/sampledemos/Framebuffer/frb-gamma.html"><code>frb-gamma</code></a> demo. 144 145 </td> 146 </tr> 147 148 149 150 <tr> 151<td><b><i>cross-color</i></b></td> 152<td>Represents the test used to check the trap filter feature (<a href="../VISetTrapFilter.html"><code>VISetTrapFilter</code></a>). </td> 153 </tr> 154 155 <tr> 156 <td></td> 157 <td> 158The trap filter feature is disabled by default under this demo. Toggles enabled/disabled status for trap filter settings each time the A Button is pressed. Outputs the current status of trap filter settings to the console output. If trap filter settings are disabled, cross-color phenomena appear. 159 160 </td> 161 </tr> 162 163 164 165 166 167 168 169 <tr> 170<td><b><i>dimming</i></b></td> 171<td>This test checks the screen burn-in protection feature (<a href="../VISetTimeToDimming.html"><code>VISetTimeToDimming</code></a> and <a href="../VIGetDimmingCount.html"><code>VIGetDimmingCount</code></a>). </td> 172 </tr> 173 174 <tr> 175 <td></td> 176 <td> 177The number displayed at the upper screen area (Count to dimming) indicates the count to the execution of screen burn-in protection (<a href="../VIGetDimmingCount.html"><code>VIGetDimmingCount</code></a> value). This value counts down from a set initial value and activates the screen burn-in protection when the count reaches 0.<br> 178 179 180Pressing the A/+/- Buttons on the Wii Remote changes the time until screen burn-in reduction goes into effect. When the B Button is pressed, <a href="../VIGetDimmingCount.html"><code>VIGetDimmingCount</code></a> will be executed after 500 fields. (This is to make sure that the count (Count to dimming) is not cleared due the execution of <a href="../VIGetDimmingCount.html"><code>VIGetDimmingCount</code></a>.)<br> 181 182 183<a href="../VIResetDimmingCount.html"><code>VIResetDimmingCount</code></a> will be activated 500 fields after the 1 Button on the Wii Remote is pressed.<br>The count (Count to dimming) will be reset the instant the 1 Button is pressed, but it will also be reset 500 fields later by<a href="../VIResetDimmingCount.html"><code>VIResetDimmingCount</code></a>.<br> 184 185 186If the input status of the controller changes, these counts will return to initial values. Please also note that if the burn-in protection settings are turned off in the system settings menu, the burn-in protection will always be disabled. 187 188 </td> 189 </tr> 190 191 192 193 <tr> 194<td><b><i>moving.regions</i></b></td> 195<td>This demo automatically sets the TV type using <a href="../VIGetTvFormat.html"><code>VIGetTvFormat</code></a>. </td> 196 </tr> 197 198 <tr> 199 <td></td> 200 <td> 201Reference this demo to support all video formats with a single game image. For the console output, before and after <a href="../VIInit.html"><code>VIInit</code></a>, the value for <a href="../VIGetTvFormat.html"><code>VIGetTvFormat</code></a> is output. Verify how the output TV type changes. Execute the restart process that uses <a href="../../os/Reset/OSRestart.html"><code>OSRestart</code></a> by pressing the A button. Also verify the video type after restart. 202 </td> 203 </tr> 204 205 206</TBODY> 207</table> 208 209 210<h2>See Also</h2> 211 212<p> 213<a href="../toc.html"><code>VI Functions</code></a><br> <a href="../../gx/sampledemos/Framebuffer/frb-gamma.html"><code>frb-gamma</code></a> 214</p> 215 216<H2>Revision History</H2> 217<P> 2182007/07/17 Revised the text about the dimming test (added <CODE>VIResetDimmingCount</CODE>).<br> 2006/10/25 Revised the text about the dimming test (added <CODE>VISetTimeToDimming</CODE> and removed <CODE>VIEnableDimming</CODE>).<br>2006/09/22 Added moving.regions test.<br>2006/09/21 Changed "screen saver" to "burn-in protection" in the descriptions.<br>2006/09/13 Revised the text about the dimming test.<br>2006/09/07 Added a dimming test.<br>2006/07/22 Added a cross-color test.<br>2006/06/16 Added a frb-vi-gamma test.<br>2006/06/05 Revised the DVDROOT settings description.<br>2006/06/05 Added the moving.Progressive test and smp-onetri_Progressive test.<br>2006/03/01 Initial version. <BR> 219 220</P> 221<hr> 222<P>CONFIDENTIAL</p> 223</BODY> 224</HTML>