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:

Description

color Sample on double-field frame buffers.
This demo paints the whole screen with a single color and changes the color once a second.
moving Sample on single-field 60 Hz 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 30 Hz rendering.
This demo works similarly to the moving demo, but in 30 Hz. It shows how to make 30 Hz games.
moving.Progressive Progressive Display Sample.
This demo is the same as the moving demo, except that it 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 Revolution 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 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.
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 applications, 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.
dimming This test checks the screen burn-in protection feature (VISetTimeToDimming and VIGetDimmingCount).
The number displayed at the upper screen area (Count to dimming) indicates the count to the execution of screen burn-in protection (VIGetDimmingCount value). This value counts down from a set initial value and activates the screen burn-in protection when the count reaches 0.
Pressing the A/+/- Buttons on the Wii Remote changes the time until screen burn-in reduction goes into effect. When the B Button is pressed, VIGetDimmingCount will be executed after 500 fields. (This is to make sure that the count (Count to dimming) is not cleared due the execution of VIGetDimmingCount.)
VIResetDimmingCount will be activated 500 fields after the 1 Button on the Wii Remote is pressed.
The count (Count to dimming) will be reset the instant the 1 Button is pressed, but it will also be reset 500 fields later byVIResetDimmingCount.
If 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.
moving.regions This demo automatically sets the TV type using VIGetTvFormat.
Reference this demo to support all video formats with a single game image. For the console output, before and after VIInit, the value for VIGetTvFormat is output. Verify how the output TV type changes. Execute the restart process that uses OSRestart by pressing the A button. Also verify the video type after restart.

See Also

VI Functions
frb-gamma

Revision History

2007/07/17 Revised the text about the dimming test (added VIResetDimmingCount).
2006/10/25 Revised the text about the dimming test (added VISetTimeToDimming and removed VIEnableDimming).
2006/09/22 Added moving.regions test.
2006/09/21 Changed "screen saver" to "burn-in protection" in the descriptions.
2006/09/13 Revised the text about the dimming test.
2006/09/07 Added a dimming test.
2006/07/22 Added a cross-color test.
2006/06/16 Added a frb-vi-gamma test.
2006/06/05 Revised the DVDROOT settings description.
2006/06/05 Added the moving.Progressive test and smp-onetri_Progressive test.
2006/03/01 Initial version.


CONFIDENTIAL