# GX_SetVisiblePlane

## C Specification

  `#include <nitro/gx/gx.h>`
  `void GX_SetVisiblePlane(int plane);`

## Arguments

plane | Specifies display plane with logical sum of `GXPlaneMask` types

## Return Values

None.

## Description

This function selects a plane to display. The argument is the logical sum of the `GXPlaneMask` type values.

`GX_PLANEMASK_NONE` | Indicates that nothing is visible.
`GX_PLANEMASK_BG0` | Indicates that BG0 is visible.
`GX_PLANEMASK_BG1` | Indicates that BG1 is visible.
`GX_PLANEMASK_BG2` | Indicates that BG2 is visible.
`GX_PLANEMASK_BG3` | Indicates that BG3 is visible.
`GX_PLANEMASK_OBJ` | Indicates that OBJs are visible.

The type definition of `GXPlaneMask` type is shown below.

    typedef enum
    {
    GX_PLANEMASK_NONE = 0x00,
    GX_PLANEMASK_BG0 = 0x01,
    GX_PLANEMASK_BG1 = 0x02,
    GX_PLANEMASK_BG2 = 0x04,
    GX_PLANEMASK_BG3 = 0x08,
    GX_PLANEMASK_OBJ = 0x10
    }
    GXPlaneMask;

## See Also

`GX_SetVisibleWnd, GX_GetVisiblePlane`

## Revision History

01/19/2004 Initial version