VIResetDimmingCount

Syntax

#include <revolution/vi.h>

BOOL VIResetDimmingCount( void );

Arguments

None.

Return Values

Returns TRUE if the counter was successfully reset and FALSE otherwise.

Description

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

Screen burn-in reduction starts when this counter reaches zero. If the counter is already zero (screen burn-in reduction is running) when this function is executed, reset the counter and recover from screen burn-in reduction at the same time.
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 a Nintendo DS series handheld console or a USB device as the controller for the Wii. 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 prohibiting use except when the Nintendo DS is employed as a controller.
2006/11/28 Initial version.


CONFIDENTIAL