Metadata-Version: 2.4
Name: homm3data
Version: 0.1.9
Summary: Decoding of Heroes Might of Magic III files
Home-page: https://github.com/Laserlicht/homm3data
Author: Laserlicht
License: MIT
Keywords: homm3 heroes iii might magic def lod pak
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pillow>=10.3.0
Requires-Dist: numpy>=1.26.4
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# homm3data
Decoding of Heroes Might of Magic III files

## Installation

Library can be installed with PIP:
`pip install homm3data`

## Examples

Saving all frames from def file as png files:
```python
from homm3data import deffile

with deffile.open('path/to/deffile.def') as d:
    for group in d.get_groups():
        for frame in range(d.get_frame_count(group)):
            img = d.read_image('combined', group, frame)
            img.save('path/to/image_group%d_frame%d.png' % (group, frame))
```

Extracting image from pcx inside lod file:
```python
from homm3data import pcxfile, lodfile

with lodfile.open('path/to/h3bitmap.lod') as lod:
    data = lod.get_file("aishield.pcx")
    if pcxfile.is_pcx(data):
        pcxfile.read_pcx(data).save('path/to/image.png')
```

Extracting image from pak file (Heroes III HD):
```python
from homm3data import pakfile

with pakfile.open("path/to/sprite_DXT_com_x3.pak") as pak:
    img = pak.get_image("AVWIMPX0", "AVWIMPX1")
    img.save('path/to/image.png')
```

Extracting text from H3 demo:
```python
import urllib.request
import tarfile
from io import BytesIO
from homm3data import lodfile

url = "http://updates.lokigames.com/loki_demos/heroes3-demo.run"
contents = urllib.request.urlopen(url).read()
data = contents.split(b"END_OF_STUB\n", 1)[1]
with tarfile.open(fileobj=BytesIO(data), mode="r:gz") as tar:
    with lodfile.open(tar.extractfile("data/demos/heroes3_demo/data/h3bitmap.lod")) as lod:
        data = lod.get_file("GENRLTXT.TXT")
        print(data.decode())
```

## Tests
The tests needs `innoextract` installed on system (may needs to be inside PATH variable).

## API
The API for the library is described [here](https://laserlicht.github.io/homm3data).

## License
Library is released under MIT license.

Some parts of code are based on [lodextract](https://gitlab.mister-muffin.de/josch/lodextract) from josch. Originally published under GPL. Josch kindly gave me permission (via e-mail) to use the code under MIT as well. Thanks a lot!
