VIInit

Syntax

#include <revolution/vi.h>

void VIInit(void);

Arguments

None.

Return Values

None.

Description

This function sets the default state of the video controller. It must be called before any other VI functions are called.

How VIInit initializes the video controller depends on the selected TV format when this function is called.

When the TV format is NTSC: On NTSC hardware, the IPL initializes the TV format to NTSC. VIInit configures the video controller to display at 640x480 and 60Hz and retains the scan type (interlaced, non-interlaced or progressive) and the TV format (NTSC) as set by the IPL.

When the TV format is PAL: On PAL hardware, IPL initializes the TV format to PAL. In this case, VIInit configures the video controller to display at 640x574 and retains the scan type (interlaced, non-interlaced or progressive) and TV format (PAL or EURGB60) as set by the IPL. Restarting does not change the TV format.

When execution of VIInit completes, both the D-Terminal cable (component cable) connection and SCGetProgressiveMode have been checked already, so there is no need for the application to perform these checks.

VIInit disables the trap filter and sets the gamma value to 1.0.
After a forced recovery from screen burn-in protection, the burn-in protection settings from the system settings menu are set.

See Also

None.

Revision History

2008/06/16 Mentioned that progressive mode is also considered when determining scan type.
2008/04/08 Corrected a mention of MPAL that had escaped deletion.
2007/12/04 Deleted the MPAL description.
2006/10/17 Revised the description of the video mode set initially.
2006/09/21 Changed "screen saver" to "burn-in protection" in the descriptions.
2006/09/16 Added description regarding trap filter, gamma value, and burn-in protection.
2006/03/01 Initial version.


CONFIDENTIAL