maps4fs 0.6.7__py3-none-any.whl → 0.6.8__py3-none-any.whl

maps4fs/generator/texture.py

@@ -16,134 +16,6 @@ from shapely.geometry.base import BaseGeometry  # type: ignore
 
 from maps4fs.generator.component import Component
 
-# region constants
-# texture = {
-#     "name": "concrete",
-#     "count": 4,
-#     "tags": {"building": True},
-#     "width": 8,
-#     "color": (130, 130, 130),
-# }
-
-# textures = [
-#     {
-#         "name": "animalMud",
-#         "count": 4,
-#     },
-#     {
-#         "name": "asphalt",
-#         "count": 4,
-#         "tags": {"highway": ["motorway", "trunk", "primary"]},
-#         "width": 8,
-#         "color": (70, 70, 70),
-#     },
-#     {
-#         "name": "cobbleStone",
-#         "count": 4,
-#     },
-#     {
-#         "name": "concrete",
-#         "count": 4,
-#         "tags": {"building": True},
-#         "width": 8,
-#         "color": (130, 130, 130),
-#     },
-#     {
-#         "name": "concreteRubble",
-#         "count": 4,
-#     },
-#     {
-#         "name": "concreteTiles",
-#         "count": 4,
-#     },
-#     {
-#         "name": "dirt",
-#         "count": 4,
-#     },
-#     {
-#         "name": "dirtDark",
-#         "count": 2,
-#         "tags": {"highway": ["unclassified", "residential", "track"]},
-#         "width": 2,
-#         "color": (33, 67, 101),
-#     },
-#     {
-#         "name": "forestGround",
-#         "count": 4,
-#         "tags": {"landuse": "farmland"},
-#         "color": (47, 107, 85),
-#     },
-#     {
-#         "name": "forestGroundLeaves",
-#         "count": 4,
-#     },
-#     {
-#         "name": "grass",
-#         "count": 4,
-#         "tags": {"natural": "grassland"},
-#         "color": (34, 255, 34),
-#     },
-#     {
-#         "name": "grassDirt",
-#         "count": 4,
-#         "tags": {"natural": ["wood", "tree_row"]},
-#         "width": 2,
-#         "color": (0, 252, 124),
-#     },
-#     {
-#         "name": "gravel",
-#         "count": 4,
-#         "tags": {"highway": ["secondary", "tertiary", "road"]},
-#         "width": 4,
-#         "color": (140, 180, 210),
-#     },
-#     {
-#         "name": "groundBricks",
-#         "count": 4,
-#     },
-#     {
-#         "name": "mountainRock",
-#         "count": 4,
-#     },
-#     {
-#         "name": "mountainRockDark",
-#         "count": 4,
-#     },
-#     {
-#         "name": "riverMud",
-#         "count": 4,
-#     },
-#     {
-#         "name": "waterPuddle",
-#         "count": 0,
-#         "tags": {"natural": "water", "waterway": True},
-#         "width": 10,
-#         "color": (255, 20, 20),
-#     },
-# ]
-
-# TEXTURES = {
-# ?     "animalMud": 4,
-# ?     "asphalt": 4,
-# ?     "cobbleStone": 4,
-# ?     "concrete": 4,
-#     "concreteRubble": 4,
-#     "concreteTiles": 4,
-#     "dirt": 4,
-#     "dirtDark": 2,
-#     "forestGround": 4,
-#     "forestGroundLeaves": 4,
-#     "grass": 4,
-#     "grassDirt": 4,
-#     "gravel": 4,
-#     "groundBricks": 4,
-#     "mountainRock": 4,
-#     "mountainRockDark": 4,
-#     "riverMud": 4,
-#     "waterPuddle": 0,
-# }
-# endregion
-
 
 # pylint: disable=R0902
 class Texture(Component):
@@ -365,6 +237,9 @@ class Texture(Component):
     def draw(self) -> None:
         """Iterates over layers and fills them with polygons from OSM data."""
         for layer in self.layers:
+            if not layer.tags:
+                self.logger.debug("Layer %s has no tags, there's nothing to draw.", layer.name)
+                continue
             layer_path = layer.path(self._weights_dir)
             self.logger.debug("Drawing layer %s.", layer_path)
 
@@ -372,7 +247,7 @@ class Texture(Component):
             for polygon in self.polygons(layer.tags, layer.width):  # type: ignore
                 cv2.fillPoly(img, [polygon], color=255)  # type: ignore
             cv2.imwrite(layer_path, img)
-            self.logger.debug("Texture %s saved.", layer.path)
+            self.logger.debug("Texture %s saved.", layer_path)
 
     def get_relative_x(self, x: float) -> int:
         """Converts UTM X coordinate to relative X coordinate in map image.

{maps4fs-0.6.7.dist-info → maps4fs-0.6.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: maps4fs
-Version: 0.6.7
+Version: 0.6.8
 Summary: Generate map templates for Farming Simulator from real places.
 Author-email: iwatkot <iwatkot@gmail.com>
 License: MIT License
@@ -34,6 +34,7 @@ Requires-Dist: tqdm
 
 
 [![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/iwatkot/maps4fs)](https://github.com/iwatkot/maps4fs/releases)
+[![PyPI - Version](https://img.shields.io/pypi/v/maps4fs)](https://pypi.org/project/maps4fs)
 [![Docker Pulls](https://img.shields.io/docker/pulls/iwatkot/maps4fs)](https://hub.docker.com/repository/docker/iwatkot/maps4fs/general)
 [![GitHub issues](https://img.shields.io/github/issues/iwatkot/maps4fs)](https://github.com/iwatkot/maps4fs/issues)
 [![Maintainability](https://api.codeclimate.com/v1/badges/b922fd0a7188d37e61de/maintainability)](https://codeclimate.com/github/iwatkot/maps4fs/maintainability)<br>
@@ -50,8 +51,11 @@ Requires-Dist: tqdm
 🔃 Farming Simulator 25 (changes in the library are ready, waiting for the Giants to release the Giants Editor v10)<br>
 
 ## Quick Start
-For those, who don't want to read anything, here you go:<br>
-**Option 1:** open the [maps4fs](https://maps4fs.streamlit.app) on StreamLit a map template in a few clicks.<br>
+There are several ways to use the tool. You obviously need the **first one**, but you can choose any of the others depending on your needs.<br>
+### 🚜 For most users
+**Option 1:** open the [maps4fs](https://maps4fs.streamlit.app) on StreamLit and generate a map template in a few clicks.<br>
+
+### 😎 For advanced users
 **Option 2:** run the Docker version in your browser. Launch the following command in your terminal:
 ```bash
 docker run -d -p 8501:8501 iwatkot/maps4fs
@@ -59,6 +63,13 @@ docker run -d -p 8501:8501 iwatkot/maps4fs
 And open [http://localhost:8501](http://localhost:8501) in your browser.<br>
 If you don't know how to use Docker, navigate to the [Docker version](#option-2-docker-version), it's really simple.<br>
 
+### 🤯 For developers
+**Option 3:** Python package. Install the package using the following command:
+```bash
+pip install maps4fs
+```
+And refer to the [Python package](#option-3-python-package) section to learn how to use it.<br>
+
 ## Overview
 The core idea is coming from the awesome [maps4cim](https://github.com/klamann/maps4cim) project.<br>
 
@@ -78,14 +89,14 @@ You'll find detailed instructions on how to run the project below. But if you pr
 ### Option 1: StreamLit
 **🗺️ Supported map sizes:** 2x2, 4x4, 8x8, 16x16 km.<br>
 🟢 Recommended for all users, you don't need to install anything.<br>
-Using Telegram bot [@maps4fs](https://t.me/maps4fsbot).<br>
+Using the [StreamLit](https://maps4fs.streamlit.app) version of the tool is the easiest way to generate a map template. Just open the link and follow the instructions.
 Note: due to CPU and RAM limitations of the hosting, the generation may take some time. If you need faster processing, use the [Docker version](#option-2-docker-version).<br>
 
 Using it is easy and doesn't require any guides. Enjoy!
 
 ### Option 2: Docker version
 **🗺️ Supported map sizes:** 2x2, 4x4, 8x8, 16x16 km.<br>
-🟢 Recommended for users who want faster processing, very simple installation.<br>
+🟠 Recommended for users who want faster processing, very simple installation.<br>
 You can launch the project with minimalistic UI in your browser using Docker. Follow these steps:
 
 1. Install [Docker](https://docs.docker.com/get-docker/) for your OS.
@@ -99,6 +110,53 @@ docker run -d -p 8501:8501 iwatkot/maps4fs
 
 ![WebUI](https://github.com/user-attachments/assets/e3b48c9d-7b87-4ce7-8ad7-98332a558a88)
 
+### Option 3: Python package
+**🗺️ Supported map sizes:** 2x2, 4x4, 8x8, 16x16 km (and ANY other you may add).<br>
+🔴 Recommended for developers.<br>
+You can use the Python package to generate maps. Follow these steps:
+
+1. Install the package from PyPI:
+```bash
+pip install maps4fs
+```
+2. Import the Game class and create an instance of it:
+```python
+import maps4fs as mfs
+
+game = mfs.Game.from_code("FS25")
+```
+In this case the library will use the default templates, which should be present in the `data` directory, which should be placed in the current working directory.<br>
+Structure example:<br>
+
+```text
+📁 data
+ ┣ 📄 fs22-map-template.zip
+ ┗ 📄 fs22-texture-schema.json
+```
+
+So it's recommended to download the `data` directory from the repository and place it in the root of your project.<br>
+
+3. Create an instance of the Map class:
+```python
+import maps4fs as mfs
+
+map = mfs.Map(
+  game,
+  (52.5200, 13.4050),  # Latitude and longitude of the map center.
+  distance=1024,  # The DISTANCE from the center to the edge of the map in meters. The map will be 2048x2048 meters.
+  map_directory="path/to/your/map/directory",  # The directory where the map will be saved.
+  blur_seed=5,  # The seed for the blur algorithm. The default value is 5, which means 5 meters.
+  max_height=400  # The maximum height of the map.
+)
+```
+
+4. Generate the map:
+```python
+map.generate()
+```
+
+The map will be saved in the `map_directory` directory.
+
 ## Settings
 Advanced settings are available in the tool's UI under the **Advanced Settings** tab. Here's the list of them:
 - `max_height` - the maximum height of the map. The default value is 400. Select smaller values for plain-like maps and bigger values for mountainous maps. You may need to experiment with this value to get the desired result.
@@ -143,4 +201,3 @@ You can use this information to adjust some other sources of data to the map, e.
 
 ## Bugs and feature requests
 If you find a bug or have an idea for a new feature, please create an issue [here](https://github.com/iwatkot/maps4fs/issues) or contact me directly on [Telegram](https://t.me/iwatkot).<br>
-ℹ️ Please, don't bother me if the Telegram bot is down. As I said before this is related to the hosting limitations, if you want you can always run the tool locally or support the project by donating, so maybe I'll be able to afford better hosting.

{maps4fs-0.6.7.dist-info → maps4fs-0.6.8.dist-info}/RECORD

@@ -6,9 +6,9 @@ maps4fs/generator/config.py,sha256=3X9E6luYh0dBlYcGvE4Exzp-ShAMCFjGB_8SK3qPBtM,1
 maps4fs/generator/dem.py,sha256=_1d_TPMOGBgl2-R_CRMbKumzxCbQyb-hcpqsElhYbQ4,8546
 maps4fs/generator/game.py,sha256=IyXjNEC5epJmDdqjsrl4wKL85T1F23km73pUkBiuDWU,4468
 maps4fs/generator/map.py,sha256=Y7ERUB6ivxJilDAjE9UD0-vl0SKtzj6J2f8QPXM6i48,3712
-maps4fs/generator/texture.py,sha256=BUDDYIASk7lhYhJpEjZUTccKUI1GIfJIcPRgIgiUHAE,17938
-maps4fs-0.6.7.dist-info/LICENSE.md,sha256=-JY0v7p3dwXze61EbYiK7YEJ2aKrjaFZ8y2xYEOrmRY,1068
-maps4fs-0.6.7.dist-info/METADATA,sha256=6LkFXz56KTpX5IbDAnDNMv00lhjFKhYb00n0yr8ATSA,8869
-maps4fs-0.6.7.dist-info/WHEEL,sha256=a7TGlA-5DaHMRrarXjVbQagU3Man_dCnGIWMJr5kRWo,91
-maps4fs-0.6.7.dist-info/top_level.txt,sha256=Ue9DSRlejRQRCaJueB0uLcKrWwsEq9zezfv5dI5mV1M,8
-maps4fs-0.6.7.dist-info/RECORD,,
+maps4fs/generator/texture.py,sha256=f5dPD5q17CTg8aY6G3i33vFk9ckbpndVb1W3hbT1wL4,15318
+maps4fs-0.6.8.dist-info/LICENSE.md,sha256=-JY0v7p3dwXze61EbYiK7YEJ2aKrjaFZ8y2xYEOrmRY,1068
+maps4fs-0.6.8.dist-info/METADATA,sha256=q6HMaXkmT1mkfskzOS9EQrTILUTfAIb_D5BJF4ObMKc,10652
+maps4fs-0.6.8.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+maps4fs-0.6.8.dist-info/top_level.txt,sha256=Ue9DSRlejRQRCaJueB0uLcKrWwsEq9zezfv5dI5mV1M,8
+maps4fs-0.6.8.dist-info/RECORD,,

{maps4fs-0.6.7.dist-info → maps4fs-0.6.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.4.0)
+Generator: setuptools (75.5.0)
 Root-Is-Purelib: true
 Tag: py3-none-any