#include <revolution/vi.h> u32 VIGetVSyncTimingTest(void);
None.
Returns the number of times the VI retrace interrupt was delayed.
This function is primarily used to test whether the switch from interlace to progressive mode occurred correctly. To switch modes, execute VISetVSyncTimingTest anytime during interlaced display and then execute this function after the display switches to progressive mode.
This function returns the number of times that VI retrace interrupt timing was delayed since VISetVSyncTimingTest executed. Then stop checking the VI retrace interrupt timing that executed for each field. So, to get the correct number of interrupt delays, always use this function together VISetVSyncTimingTest.
Although the progressive display shown on the TV screen sometimes appears correct even though the return value of this function is non-zero, this is only a case of the display occasionally coming out correctly. Be sure the return value of this function is always 0. If the return value is not 0, check if a long period where interrupts are disabled was set within the program.
This function always returns non-zero because the VI interrupt timing is slightly delayed when debugging using Code Warrior's step execution feature. We recommend that you test software under normal execution conditions when testing progressive display.
2006/10/18 Added a caution about Code Warrior's step execution.
2006/06/06 Initial version.
CONFIDENTIAL