VIResetDimmingCount

C Specification

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

Arguments

None.

Return Values

Returns TRUE if the counter was reset successfully; otherwise, returns FALSE.

Description

This function resets the counter until screen burn-in reduction goes into effect. (Returns it to the initial value.)

Screen burn-in reduction goes into effect when this counter reaches zero. If this function is called when the counter is already zero (when screen burn-in reduction is in effect), the counter is reset and the system will recover from screen burn-in reduction. The counter will be reset at the next field. There is no need to execute VIFlush.

Use this function to recover from screen burn-in reduction when using Nintendo DS (or DS Lite) as the controller for Wii. As a basic rule, do not use this function for any other purpose.

Executing this function on a regular periodic basis is the same as turning off the screen burn-in reduction feature. You thus need to be careful not to continually execute this function over an extended period of time.

See Also

VIEnableDimming, VIGetDimmingCount, VISetTimeToDimming

Revision History

2007/07/11 Added a cautionary note that the use is prohibited except when using a Nintendo DS as a controller.
2006/11/28 Initial version.