# G2_SetBlendBrightnessExt

## Syntax

      #include <nitro/gx/g2.h>

      void G2_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 is set to 16.
This function changes the brightness of the screen 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 `G2_SetBlendAlpha` function for details on the `GXBlendPlaneMask` type.

## See Also

`G2_BlendNone, G2_SetBlendAlpha, G2_SetBlendBrightness, G2_ChangeBlendAlpha, G2_ChangeBlendBrightness`

## Revision History

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

2004/01/19 Initial version.

CONFIDENTIAL