VISetVSyncTimingTest

C Specification

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

Arguments

None.

Return Values

None.

Description

This function is primarily used to test whether the switch from interlace to progressive mode occurred correctly. To switch modes, execute this function anytime during interlaced display and then execute VIGetVSyncTimingTest after the display switches to progressive mode.

This function checks if the VI retrace interrupt timing is delayed. If the VI retrace interrupt timing is behind standard timing, the error counter increments by one. The error counter can be obtained using VIGetVSyncTimingTest. This check is carried out every field until VIGetVSyncTimingTest executes.

If VI retrace interrupt timing is delayed when switching from interlace to progressive mode, there is a risk that the switch to progressive mode will not occur correctly. The main factor causing delays in VI retrace interrupt timing is long periods where interrupts are disabled. If the return value of VIGetVSyncTimingTest is not 0, be sure to check whether a long period where interrupts are disabled was set in the program.

See Also

VIGetVSyncTimingTest

Revision History

06/06/2006 Initial version.