---
name: "al_store_state"
section: "3"
platform: "linux"
package: "allegro"
version: "5.2.11.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/al_store_state"
---

# al\_store\_state(3)

Allegro 5 API

## NAME

al\_store\_state - Allegro 5 API

## SYNOPSIS

-

  ```
  void al_store_state(ALLEGRO_STATE *state, int flags)
  ```

## DESCRIPTION

Stores part of the state of the current thread in the given [ALLEGRO\_STATE(3)](/ALLEGRO_STATE/3.md) object. The flags parameter can take any bit-combination of these flags:

- •

  ALLEGRO\_STATE\_NEW\_DISPLAY\_PARAMETERS - new\_display\_format, new\_display\_refresh\_rate, new\_display\_flags

- •

  ALLEGRO\_STATE\_NEW\_BITMAP\_PARAMETERS - new\_bitmap\_format, new\_bitmap\_flags

- •

  ALLEGRO\_STATE\_DISPLAY - current\_display

- •

  ALLEGRO\_STATE\_TARGET\_BITMAP - target\_bitmap

- •

  ALLEGRO\_STATE\_BLENDER - blender

- •

  ALLEGRO\_STATE\_TRANSFORM - current\_transformation

- •

  ALLEGRO\_STATE\_PROJECTION\_TRANSFORM - current\_projection\_transformation

- •

  ALLEGRO\_STATE\_NEW\_FILE\_INTERFACE - new\_file\_interface

- •

  ALLEGRO\_STATE\_BITMAP - same as ALLEGRO\_STATE\_NEW\_BITMAP\_PARAMETERS and ALLEGRO\_STATE\_TARGET\_BITMAP

- •

  ALLEGRO\_STATE\_ALL - all of the above

## SEE ALSO

[al\_restore\_state(3)](/al_restore_state/3.md), [ALLEGRO\_STATE(3)](/ALLEGRO_STATE/3.md)