# GX_SetVCount

## Syntax

      #include <nitro/gx/gx.h>

      void GX_SetVCount(s32 count);

## Arguments

count | V count to set in the V-Counter (202 ≤ `count` ≤ 211).

## Return Values

None.

## Description

This function writes a value in the V-Count register. The written value takes effect when the V-Counter is updated. First, confirm that the current V count is between 202 and 211, then write that value between 202 and 211.
However, because the V count cannot be set if line 212 has been reached while calling this function, to be sure this doesn't happen interrupts must be disabled and this function must called by line 210.

Caution: Because this could have a detrimental effect on the LCD, the following usage methods are prohibited.

- Advancing V-Count.
- Calling it twice or more in one frame.

Because the synchronization of parent or child V blanking is thrown off if this function is used to set the V count during MP communications, do not use this function during MP communications as it will become impossible to stably perform communications in frame synchronous communication mode.

## See Also

GX_GetVCount

## Revision History

2007/11/26 Changed warning notes.
2007/10/16 Added restrictions during MP communications.
2007/01/26 Added warning notes.
2004/01/19 Initial version.

CONFIDENTIAL