> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/foundational-knowledge/gem-rts-binary-file-formats/convex-polyhedron-format-.vol.md).

# Convex Polyhedron format .vol

## Overview

Chunk-based binary format for storing convex volume data.

**File structure**

```
EVLM

VERT
    vertices_count
    vertices[vertices_count]

INDX
    indices_count
    indices[indices_count]

SIDE
    sides_count
    sides[sides_count]

MARK
    marks_count
    marks[marks_count]
```

## File header

Format identifier

<table><thead><tr><th width="79.46484375">File</th><th width="102.13671875">FourCC</th><th>Description</th></tr></thead><tbody><tr><td>.vol</td><td><code>EVLM</code></td><td>Chunk-based binary file containing a convex polyhedron</td></tr></tbody></table>

## Chunk `VERT`

<table><thead><tr><th width="137.37109375">Name</th><th width="212.26953125">Type</th><th width="78.64453125">Size</th><th>Description</th></tr></thead><tbody><tr><td>FourCC</td><td>uint8[4]</td><td>4</td><td><code>VERT</code></td></tr><tr><td>vertices_count</td><td>int32</td><td>4</td><td>Number of vertices</td></tr><tr><td>vertices</td><td>float[3][vertices_count]</td><td></td><td>Vertex data</td></tr></tbody></table>

## Chunk `INDX`

Indices

<table><thead><tr><th width="137.75390625">Name</th><th width="184.5625">Type</th><th width="76.12890625">Size</th><th>Description</th></tr></thead><tbody><tr><td>FourCC</td><td>uint8[4]</td><td>4</td><td><code>INDX</code></td></tr><tr><td>indices_count</td><td>int32</td><td>4</td><td>Number of indices</td></tr><tr><td>indices</td><td>uint16[indices_count]</td><td></td><td>Index data</td></tr></tbody></table>

## Chunk `SIDE`

Face classification for armor

<table><thead><tr><th width="122.55078125">Name</th><th width="169.8828125">Type</th><th width="84.8984375">Size</th><th>Description</th></tr></thead><tbody><tr><td>FourCC</td><td>uint8[4]</td><td>4</td><td><code>SIDE</code></td></tr><tr><td>sides_count</td><td>int32</td><td>4</td><td>Number of faces</td></tr><tr><td>sides</td><td>uint8[sides_count]</td><td></td><td><p>Side code:</p><p>1: front</p><p>2: top</p><p>3: left</p><p>4: right</p><p>5: rear</p><p>6: bottom</p></td></tr></tbody></table>

## Chunk MARK

Face marking

\*) Not used in GEM RTS

<table><thead><tr><th>Name</th><th width="172.9140625">Type</th><th width="78.29296875">Size</th><th>Description</th></tr></thead><tbody><tr><td>FourCC</td><td>uint8[4]</td><td>4</td><td><code>MARK</code></td></tr><tr><td>marks_count</td><td>int32</td><td>4</td><td>Number of faces</td></tr><tr><td>marks</td><td>uint8[marks_count]</td><td></td><td>Data for each face</td></tr></tbody></table>
