# `regen.py`

Regenerates magma.in and magma.attrib using
[magma.json](https://fuchsia.googlesource.com/fuchsia/+/refs/heads/main/src/graphics/lib/magma/include/magma/magma.json)
using some basic heuristics. This will overwrite any existing modifications to
the output files. Subsequent verification is needed to ensure the interface and
type definitions accurately match the API.

# Regenerate encoder/decoder

To regen the encoder/decoder, build ../generic-apigen and run the following commands:

```
mkdir -p enc_new
mkdir -p dec_new
vulkan-cereal/build/gfxstream-generic-apigen -i . -E enc_new/ -D dec_new/ magma
```

Note that both the `-E` and `-D` flags should be used together, as some
definition errors are only visible during one of the two codegen phases. If
codegen succeeded, the files should be moved to replace their existing
counterparts:

Encoder path: `$GOLDFISH_OPENGL/system/magma_enc`

Decoder path: `$VULKAN_CEREAL/stream-servers/magma`