# `Cauldron3D.Formats.Wad2`
[🔗](https://github.com/jaman/cauldron/blob/v0.3.3/cauldron_3d_formats/lib/cauldron_3d/formats/wad2.ex#L1)

`WAD2` picture collections and loose `.lmp` pictures, read into `Cauldron3D.Texture`s
of palette indices.

    Cauldron3D.Formats.Wad2.pictures(File.read!("gfx.wad"), raw: %{"conchars" => {128, 128}})["num_0"]

A picture lump holds its width and height before its pixels; `:raw` names lumps that
are bare pixels and gives their `{width, height}`.

# `lmp`

```elixir
@spec lmp(binary() | nil) :: Cauldron3D.Texture.t() | nil
```

A loose `.lmp` picture: width, height and its pixels; `nil` when it is not one.

# `pictures`

```elixir
@spec pictures(binary() | nil, keyword()) :: %{
  required(String.t()) => Cauldron3D.Texture.t()
}
```

Every picture in a `WAD2`, by lower-case name.

---

*Consult [api-reference.md](api-reference.md) for complete listing*