# G2S_SetBlendBrightnessExt

## C Specification

      #include <nitro/gx/g2.h>

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

## Description

This function uses the sub 2D Engine to change the brightness of the plane that was specified by `plane1`. Positive `brightness` increases brightness. Negative `brightness` decreases brightness. It also performs alpha-blending for planes selected by OBJ, bitmap OBJ, and 3D planes, and `plane2`. For details on the `GXBlendPlaneMask` type see `G2S_SetBlendAlpha`.

## Arguments

`plane1` | Selects the plane where the brightness will be changed (result of a logical OR with the `GXBlendPlaneMask` type values)
`plane2` | Selects the plane for alpha-blending in the case of translucent OBJ, bit map OBJ, and 3D planes.
`ev1` | The alpha-blending coefficient for translucent OBJ, bit map OBJ, and 3D planes
`ev2` | The alpha-blending coefficient for `plane2`
`brightness` | Specifies the coefficient for brightness change for plane1 (-16 <= `brightness` <= 16)

## Return Values

None

## See Also

`G2S_BlendNone, G2S_SetBlendAlpha, G2S_SetBlendBrightness, G2S_ChangeBlendAlpha, G2S_ChangeBlendBrightness`

## Revision History

02/09/2004 Initial Version