VI Demos

Location

$REVOLUTION_SDK_ROOT/build/demos/videmo

Compilation

Go to the directory $REVOLUTION_SDK_ROOT/build/demos/videmo and enter make. The executable file (*.elf file) will be created in the directory $REVOLUTION_SDK_ROOT/build/demos/videmo/bin/RVL/.

Execution

You must configure DVDRoot before execution. Be sure to specify the folder name $REVOLUTION_SDK_ROOT/dvddata as the DvdRoot argument of the SetNdEnv command.

Go to the directory $REVOLUTION_SDK_ROOT/build/demos/videmo/bin/RVL/ and do one of the following:

uTo simply run the application, execute the script XXX (for NDEV) or XXX (for XXX) with the.elf file as the argument.
uRun ide with a .elf file as an argument (if you want to debug with CodeWarrior).

Description

`color`	Sample on double-field frame buffers.
	This demo paints all the screen with a single color and changes the color once a second.
`moving`	Sample on single-field 60Hz rendering (field rendering).
	This demo renders the screen with a simple pattern and moves it. Sample to show how to use `VIGetNextField` in field-rendering mode.
`moving.30Hz`	Sample on 30Hz rendering.
	This demo works similarly to the moving demo, but in 30Hz. It shows how to make 30Hz games.
`moving.Progressive`	Progressive Display Sample
	This demo is the same as the moving demo, except that is uses progressive scan for the display. This demo shows how to make progressive display settings.
`viewer`	BMP file viewer.
	This demo opens all BMP files under DVDRoot/pictures 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 Dolphin Graphics Programmer's Guide.))
	Six versions of the viewer are generated. The "viewer_NTSC_INT" viewer is for NTSC interlaced mode, the "viewer_NTSC_DS" viewer is for NTSC double-strike mode, and so on.
	To add a picture, place the BMP file in the DVDRoot/pictures directory. Any files with extensions other than "BMP", "BMA", and "BMB" are ignored. Subdirectories under the "pictures" directory are also ignored.
*smp-onetri_PAL*	This is a PAL version of smp-onetri sample demo. For more information, see the GX Sample Demo Manual.
	By default, this demo shows PAL 50Hz 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.
*smp-onetri_Progressive*	This sample tests switching from interlace to progressive using the smp_onetri sample demo.
	This 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. This 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. If the test results are not good (the VI retrace interrupt delay count is greater than zero) when conducting similar tests in your own applicatons, check whether interrupts are being disabled for long periods during gameplay.
*frb-vi-gamma*	This test adds a VI gamma correction feature to the GX gamma demo (`frb-gamma`).
	Revolution 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 `frb-gamma` demo.
*cross-color*	Represents the test used to check the trap filter feature (`VISetTrapFilter`).
	The 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.

Revision History

7/22/2006 Added a cross-color test.
6/16/2006 Added frb-vi-gamma test.
6/5/2006 Revised the description of the DVDROOT settings.
6/5/2006 Added the moving.Progressive test and smp-onetri_Progressive test.
03/01/2006 Initial version.