VIGetVSyncTimingTest

C Specification

#include <revolution/vi.h>
u32 VIGetVSyncTimingTest(void)

Arguments

None.

Return Values

Returns the number of times the VI retrace interrupt was delayed.

Description

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 with 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. Therefore, 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.

See Also

VISetVSyncTimingTest

Revision History

06/06/2006 Initial version.