# G2S_SetBlendBrightnessExt

## Syntax

      #include <nitro/gx/g2.h>

      void G2S_SetBlendBrightnessExt(
          int plane1 /* GXBlendPlaneMask */,
          int plane2 /* GXBlendPlaneMask */,
          int ev1,
          int ev2,
          int brightness
      );

## Arguments

`plane1` | Selects the plane where the brightness will be changed (result of a logical OR with the `GXBlendPlaneMask` type values)
`plane2` | Selects the screen where alpha-blending is performed on the translucent OBJ, bitmap OBJ, and 3D screen.
`ev1` | Alpha-blending coefficient for translucent OBJ, bitmap OBJ, and 3D screen. (0 ≤ ev1 ≤ 31)
`ev2` | Alpha-blending coefficient for plane2. (0 ≤ ev2 ≤ 31)
`brightness` | Specifies the coefficient to change the brightness of `plane1` (-16 ≤ `brightness` ≤ 16)

## Return Values

None.

## Description

If the value of ev1 or ev2 is greater than 16, the alpha-blending coefficient that is actually set is 16.
This function uses the sub 2D Engine to change the brightness of the plane that was specified by `plane1`. If `brightness` is positive, the brightness increases; if it is negative, the brightness decreases. Furthermore, alpha-blending is performed on the translucent OBJ, bitmap OBJ, 3D screen, and the screen specified by `plane2`. Refer to the `G2S_SetBlendAlpha` function for details on the `GXBlendPlaneMask` type.

## See Also

`G2S_BlendNone
G2S_SetBlendAlpha
G2S_SetBlendBrightness
G2S_ChangeBlendAlpha
G2S_ChangeBlendBrightness`

## Revision History

2008/10/30 Added description of the alpha-blending coefficients.

2004/02/09 Initial version.

CONFIDENTIAL