VISetTimeToDimming

Syntax

#include <revolution/vi.h>

VITimeToDIM VISetTimeToDimming( VITimeToDIM time );

Arguments

time Time until the execution of the screen burn-in protection function.
Name Time Until Execution
VI_DM_DEFAULT Approximately 5 minutes.
VI_DM_10M Approximately 10 minutes.
VI_DM_15M Approximately 15 minutes.

Return Values

Returns the previously set value.

Description

This function changes the wait time until the burn-in protection executes. The screen burn-in protection will execute if the controller input state does not change. The time until the execution is five minutes by default. There is no real need to execute VIFlush after this function.
The exact time until activation can be obtained using the VIGetDimmingCount function.

Changes through this function will become enabled starting next field if the controller idle time at the moment is smaller than the set time.
This is illustrated in the following example.
VISetTimeToDimming1.gif (4496 bytes)

In the above case, the changes will be reflected at the next field. (Time until the execution changes.)
VISetTimeToDimming2.gif (3387 bytes)





If the controller's idle time is already longer than the specified time, the change is put on hold.
VISetTimeToDimming3.gif (4494 bytes)

In the above case, the execution wait time is changed at the next field when the controller's idle time becomes smaller than the specified time. (In other words, when there is controller input or during the recovery from screen burn-in protection.)
VISetTimeToDimming4.gif (4922 bytes)





Please note that the VIInit function will reset the execution wait time to the default value of approximately five minutes.
Please also note that screen burn-in protection functions only if burn-in protection has been set to ON in the system settings menu.

See Also

VIEnableDimming
VIResetDimmingCount
VIGetDimmingCount

Revision History

2007/07/12 Added a link to VIResetDimmingCount.
2006/10/25 Initial version.


CONFIDENTIAL