# G2S_SetBlendBrightnessExt

## C Specification

      #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 the translucent OBJ, bitmap OBJ, and 3D screen. `ev1` ≤ 31)
`ev2` | alpha-blending coefficient for `plane2`. `ev2` ≤ 31)
brightness | Specifies the coefficient to change the brightness of `plane1` (-16 ≤ `brightness` ≤ 16)

## Return Values

None.

## Description

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`. See `G2S_SetBlendAlpha` for details on the `GXBlendPlaneMask` type.

## See Also

`G2S_BlendNone, G2S_SetBlendAlpha, G2S_SetBlendBrightness, G2S_ChangeBlendAlpha, G2S_ChangeBlendBrightness`

## Revision History

02/09/2004 Initial version