# screen_alternate_on

- **Language:** C
- **Kind:** function
- **Source:** https://github.com/tmux/tmux/blob/e476c1230b958df0cb12977517d24b3dc931375b/screen.c#L676
- **Page:** https://libtmux.org/en/tmux/latest/reference/c-function-screen_alternate_on/

```c
void screen_alternate_on(struct screen *s, struct grid_cell *gc, int cursor)
```

## Parameters

- `s` (`struct screen *`)
- `gc` (`struct grid_cell *`)
- `cursor` (`int`)

## Called by

- [`screen_write_alternateon`](/en/tmux/latest/reference/c-function-screen_write_alternateon/) (function) [Call site](https://github.com/tmux/tmux/blob/e476c1230b958df0cb12977517d24b3dc931375b/screen-write.c#L2963)

## Calls

- [`grid_create`](/en/tmux/latest/reference/c-function-grid_create/) (function) [Call site](https://github.com/tmux/tmux/blob/e476c1230b958df0cb12977517d24b3dc931375b/screen.c#L688)
- [`grid_view_clear`](/en/tmux/latest/reference/c-function-grid_view_clear/) (function) [Call site](https://github.com/tmux/tmux/blob/e476c1230b958df0cb12977517d24b3dc931375b/screen.c#L702)

## Other function references

- [`grid_duplicate_lines`](/en/tmux/latest/reference/c-function-grid_duplicate_lines/) (function)

## Referenced declarations

- [`screen.cx`](/en/tmux/latest/reference/c-struct-screen-cx/) (attribute)
- [`screen.cy`](/en/tmux/latest/reference/c-struct-screen-cy/) (attribute)
- [`grid.flags`](/en/tmux/latest/reference/c-struct-grid-flags/) (attribute)
- [`screen.grid`](/en/tmux/latest/reference/c-struct-screen-grid/) (attribute)
- [`grid_cell`](/en/tmux/latest/reference/c-struct-grid_cell/) (struct)
- [`GRID_HISTORY`](/en/tmux/latest/reference/c-define-tmux-h-grid_history/) (constant)
- [`screen.saved_cell`](/en/tmux/latest/reference/c-struct-screen-saved_cell/) (attribute)
- [`screen.saved_cx`](/en/tmux/latest/reference/c-struct-screen-saved_cx/) (attribute)
- [`screen.saved_cy`](/en/tmux/latest/reference/c-struct-screen-saved_cy/) (attribute)
- [`screen.saved_flags`](/en/tmux/latest/reference/c-struct-screen-saved_flags/) (attribute)
- [`screen.saved_grid`](/en/tmux/latest/reference/c-struct-screen-saved_grid/) (attribute)
- [`screen`](/en/tmux/latest/reference/c-struct-screen/) (struct)
- [`screen_hsize`](/en/tmux/latest/reference/c-define-tmux-h-screen_hsize/) (constant)
- [`SCREEN_IS_ALTERNATE`](/en/tmux/latest/reference/c-define-tmux-h-screen_is_alternate/) (constant)
- [`screen_size_x`](/en/tmux/latest/reference/c-define-tmux-h-screen_size_x/) (constant)
- [`screen_size_y`](/en/tmux/latest/reference/c-define-tmux-h-screen_size_y/) (constant)
- [`screen_sel.sx`](/en/tmux/latest/reference/c-struct-screen_sel-sx/) (attribute)
- [`screen_sel.sy`](/en/tmux/latest/reference/c-struct-screen_sel-sy/) (attribute)