maps4fs 1.0.5__py3-none-any.whl → 1.0.8__py3-none-any.whl

maps4fs/generator/background.py

@@ -4,6 +4,7 @@ around the map."""
 from __future__ import annotations
 
 import os
+import shutil
 
 import cv2
 import numpy as np
@@ -15,13 +16,15 @@ from maps4fs.generator.dem import (
     DEFAULT_MULTIPLIER,
     DEFAULT_PLATEAU,
 )
-from maps4fs.generator.path_steps import PATH_FULL_NAME, get_steps
+from maps4fs.generator.path_steps import (
+    PATH_FULL_NAME,
+    PATH_FULL_PREVIEW_NAME,
+    get_steps,
+)
 from maps4fs.generator.tile import Tile
 
 RESIZE_FACTOR = 1 / 4
-SIMPLIFY_FACTOR = 10
 FULL_RESIZE_FACTOR = 1 / 8
-FULL_SIMPLIFY_FACTOR = 20
 
 
 class Background(Component):
@@ -42,8 +45,11 @@ class Background(Component):
         self.tiles: list[Tile] = []
         origin = self.coordinates
 
+        only_full_tiles = self.kwargs.get("only_full_tiles", True)
+        self.light_version = self.kwargs.get("light_version", False)
+
         # Getting a list of 8 tiles around the map starting from the N(North) tile.
-        for path_step in get_steps(self.map_height, self.map_width):
+        for path_step in get_steps(self.map_height, self.map_width, only_full_tiles):
             # Getting the destination coordinates for the current tile.
             if path_step.angle is None:
                 # For the case when generating the overview map, which has the same
@@ -52,6 +58,11 @@ class Background(Component):
             else:
                 tile_coordinates = path_step.get_destination(origin)
 
+            if path_step.code == PATH_FULL_PREVIEW_NAME:
+                auto_process = False
+            else:
+                auto_process = self.kwargs.get("auto_process", False)
+
             # Create a Tile component, which is needed to save the DEM image.
             tile = Tile(
                 game=self.game,
@@ -61,7 +72,7 @@ class Background(Component):
                 map_directory=self.map_directory,
                 logger=self.logger,
                 tile_code=path_step.code,
-                auto_process=False,
+                auto_process=auto_process,
                 blur_radius=self.kwargs.get("blur_radius", DEFAULT_BLUR_RADIUS),
                 multiplier=self.kwargs.get("multiplier", DEFAULT_MULTIPLIER),
                 plateau=self.kwargs.get("plateau", DEFAULT_PLATEAU),
@@ -83,8 +94,29 @@ class Background(Component):
         generated."""
         for tile in self.tiles:
             tile.process()
+            if tile.code == PATH_FULL_NAME:
+                cutted_dem_path = self.cutout(tile.dem_path)
+                if self.game.additional_dem_name is not None:
+                    self.make_copy(cutted_dem_path, self.game.additional_dem_name)
 
-        self.generate_obj_files()
+        if not self.light_version:
+            self.generate_obj_files()
+        else:
+            self.logger.info("Light version is enabled, obj files will not be generated.")
+
+    def make_copy(self, dem_path: str, dem_name: str) -> None:
+        """Copies DEM data to additional DEM file.
+
+        Arguments:
+            dem_path (str): Path to the DEM file.
+            dem_name (str): Name of the additional DEM file.
+        """
+        dem_directory = os.path.dirname(dem_path)
+
+        additional_dem_path = os.path.join(dem_directory, dem_name)
+
+        shutil.copyfile(dem_path, additional_dem_path)
+        self.logger.info("Additional DEM data was copied to %s.", additional_dem_path)
 
     def info_sequence(self) -> dict[str, dict[str, str | float | int]]:
         """Returns a dictionary with information about the tiles around the map.
@@ -152,6 +184,63 @@ class Background(Component):
             dem_data = cv2.imread(tile.dem_path, cv2.IMREAD_UNCHANGED)  # pylint: disable=no-member
             self.plane_from_np(tile.code, dem_data, save_path)  # type: ignore
 
+    # pylint: disable=too-many-locals
+    def cutout(self, dem_path: str) -> str:
+        """Cuts out the center of the DEM (the actual map) and saves it as a separate file.
+
+        Arguments:
+            dem_path (str): The path to the DEM file.
+
+        Returns:
+            str -- The path to the cutout DEM file.
+        """
+        dem_data = cv2.imread(dem_path, cv2.IMREAD_UNCHANGED)  # pylint: disable=no-member
+
+        center = (dem_data.shape[0] // 2, dem_data.shape[1] // 2)
+        half_size = self.map_height // 2
+        x1 = center[0] - half_size
+        x2 = center[0] + half_size
+        y1 = center[1] - half_size
+        y2 = center[1] + half_size
+        dem_data = dem_data[x1:x2, y1:y2]
+
+        output_size = self.map_height + 1
+
+        main_dem_path = self.game.dem_file_path(self.map_directory)
+        dem_directory = os.path.dirname(main_dem_path)
+
+        try:
+            os.remove(main_dem_path)
+        except FileNotFoundError:
+            pass
+
+        # pylint: disable=no-member
+        resized_dem_data = cv2.resize(
+            dem_data, (output_size, output_size), interpolation=cv2.INTER_LINEAR
+        )
+
+        # Giant Editor contains a bug for large maps, where the DEM should not match
+        # the UnitsPerPixel value. For example, for map 8192x8192, without bug
+        # the DEM image should be 8193x8193, but it does not work, so we need to
+        # resize the DEM to 4097x4097.
+        if self.map_height > 4096:
+            correct_dem_path = os.path.join(dem_directory, "correct_dem.png")
+            save_path = correct_dem_path
+
+            output_size = self.map_height // 2 + 1
+            bugged_dem_data = cv2.resize(
+                dem_data, (output_size, output_size), interpolation=cv2.INTER_LINEAR
+            )
+            # pylint: disable=no-member
+            cv2.imwrite(main_dem_path, bugged_dem_data)
+        else:
+            save_path = main_dem_path
+
+        cv2.imwrite(save_path, resized_dem_data)  # pylint: disable=no-member
+        self.logger.info("DEM cutout saved: %s", save_path)
+
+        return save_path
+
     # pylint: disable=too-many-locals
     def plane_from_np(self, tile_code: str, dem_data: np.ndarray, save_path: str) -> None:
         """Generates a 3D obj file based on DEM data.
@@ -163,10 +252,8 @@ class Background(Component):
         """
         if tile_code == PATH_FULL_NAME:
             resize_factor = FULL_RESIZE_FACTOR
-            simplify_factor = FULL_SIMPLIFY_FACTOR
         else:
             resize_factor = RESIZE_FACTOR
-            simplify_factor = SIMPLIFY_FACTOR
         dem_data = cv2.resize(  # pylint: disable=no-member
             dem_data, (0, 0), fx=resize_factor, fy=resize_factor
         )
@@ -213,14 +300,21 @@ class Background(Component):
         mesh.apply_transform(rotation_matrix_y)
         mesh.apply_transform(rotation_matrix_z)
 
-        self.logger.debug("Mesh generated with %s faces, will be simplified", len(mesh.faces))
+        if tile_code == PATH_FULL_PREVIEW_NAME:
+            # Simplify the preview mesh to reduce the size of the file.
+            mesh = mesh.simplify_quadric_decimation(face_count=len(mesh.faces) // 2**7)
 
-        # Simplify the mesh to reduce the number of faces.
-        mesh = mesh.simplify_quadric_decimation(face_count=len(faces) // simplify_factor)
-        self.logger.debug("Mesh simplified to %s faces", len(mesh.faces))
-
-        if tile_code == PATH_FULL_NAME:
+            # Apply scale to make the preview mesh smaller in the UI.
+            mesh.apply_scale([0.5, 0.5, 0.5])
             self.mesh_to_stl(mesh)
+        else:
+            multiplier = self.kwargs.get("multiplier", DEFAULT_MULTIPLIER)
+            if multiplier != 1:
+                z_scaling_factor = 1 / multiplier
+            else:
+                z_scaling_factor = 1 / 2**5
+            self.logger.debug("Z scaling factor: %s", z_scaling_factor)
+            mesh.apply_scale([1 / resize_factor, 1 / resize_factor, z_scaling_factor])
 
         mesh.export(save_path)
         self.logger.debug("Obj file saved: %s", save_path)
@@ -234,7 +328,6 @@ class Background(Component):
             mesh (trimesh.Trimesh) -- The mesh to convert to an STL file.
         """
         preview_path = os.path.join(self.previews_directory, "background_dem.stl")
-        mesh = mesh.simplify_quadric_decimation(percent=0.05)
         mesh.export(preview_path)
 
         self.logger.info("STL file saved: %s", preview_path)

maps4fs/generator/dem.py

@@ -225,22 +225,6 @@ class DEM(Component):
         cv2.imwrite(self._dem_path, resampled_data)
         self.logger.info("DEM data was saved to %s.", self._dem_path)
 
-        if self.game.additional_dem_name is not None:
-            self.make_copy(self.game.additional_dem_name)
-
-    def make_copy(self, dem_name: str) -> None:
-        """Copies DEM data to additional DEM file.
-
-        Arguments:
-            dem_name (str): Name of the additional DEM file.
-        """
-        dem_directory = os.path.dirname(self._dem_path)
-
-        additional_dem_path = os.path.join(dem_directory, dem_name)
-
-        shutil.copyfile(self._dem_path, additional_dem_path)
-        self.logger.info("Additional DEM data was copied to %s.", additional_dem_path)
-
     def _tile_info(self, lat: float, lon: float) -> tuple[str, str]:
         """Returns latitude band and tile name for SRTM tile from coordinates.
 

maps4fs/generator/game.py

@@ -39,7 +39,7 @@ class Game:
     _grle_schema: str | None = None
 
     # Order matters! Some components depend on others.
-    components = [Texture, I3d, DEM, Config, GRLE, Background]
+    components = [Texture, DEM, I3d, Config, GRLE, Background]
 
     def __init__(self, map_template_path: str | None = None):
         if map_template_path:

maps4fs/generator/i3d.py

@@ -34,6 +34,8 @@ class I3d(Component):
     def preprocess(self) -> None:
         """Gets the path to the map I3D file from the game instance and saves it to the instance
         attribute. If the game does not support I3D files, the attribute is set to None."""
+        self.auto_process = self.kwargs.get("auto_process", False)
+
         try:
             self._map_i3d_path = self.game.i3d_file_path(self.map_directory)
             self.logger.debug("Map I3D path: %s.", self._map_i3d_path)
@@ -69,22 +71,16 @@ class I3d(Component):
         root = tree.getroot()
         for map_elem in root.iter("Scene"):
             for terrain_elem in map_elem.iter("TerrainTransformGroup"):
-                terrain_elem.set("heightScale", str(DEFAULT_HEIGHT_SCALE))
-                self.logger.debug(
-                    "heightScale attribute set to %s in TerrainTransformGroup element.",
-                    DEFAULT_HEIGHT_SCALE,
-                )
-                terrain_elem.set("maxLODDistance", str(DEFAULT_MAX_LOD_DISTANCE))
-                self.logger.debug(
-                    "maxLODDistance attribute set to %s in TerrainTransformGroup element.",
-                    DEFAULT_MAX_LOD_DISTANCE,
-                )
-
-                terrain_elem.set("occMaxLODDistance", str(DEFAULT_MAX_LOD_OCCLUDER_DISTANCE))
-                self.logger.debug(
-                    "occMaxLODDistance attribute set to %s in TerrainTransformGroup element.",
-                    DEFAULT_MAX_LOD_OCCLUDER_DISTANCE,
-                )
+                if self.auto_process:
+                    terrain_elem.set("heightScale", str(DEFAULT_HEIGHT_SCALE))
+                    self.logger.debug(
+                        "heightScale attribute set to %s in TerrainTransformGroup element.",
+                        DEFAULT_HEIGHT_SCALE,
+                    )
+                else:
+                    self.logger.debug(
+                        "Auto process is disabled, skipping the heightScale attribute update."
+                    )
 
                 self.logger.debug("TerrainTransformGroup element updated in I3D file.")
 

maps4fs/generator/path_steps.py

@@ -6,6 +6,7 @@ from geopy.distance import distance  # type: ignore
 
 DEFAULT_DISTANCE = 2048
 PATH_FULL_NAME = "FULL"
+PATH_FULL_PREVIEW_NAME = "FULL_PREVIEW"
 
 
 class PathStep(NamedTuple):
@@ -40,13 +41,14 @@ class PathStep(NamedTuple):
         return destination.latitude, destination.longitude
 
 
-def get_steps(map_height: int, map_width: int) -> list[PathStep]:
+def get_steps(map_height: int, map_width: int, only_full_tiles: bool = True) -> list[PathStep]:
     """Return a list of PathStep objects for each tile, which represent a step in the path.
     Moving from the center of the map to North, then clockwise.
 
     Arguments:
         map_height {int} -- Height of the map in pixels
         map_width {int} -- Width of the map in pixels
+        only_full_tiles {bool} -- Whether to return only full tiles or all tiles
 
     Returns:
         list[PathStep] -- List of PathStep objects
@@ -57,7 +59,7 @@ def get_steps(map_height: int, map_width: int) -> list[PathStep]:
 
     half_default_distance = int(DEFAULT_DISTANCE / 2)
 
-    return [
+    tiles = [
         PathStep("N", 0, half_height + half_default_distance, (map_width, DEFAULT_DISTANCE)),
         PathStep(
             "NE", 90, half_width + half_default_distance, (DEFAULT_DISTANCE, DEFAULT_DISTANCE)
@@ -74,10 +76,22 @@ def get_steps(map_height: int, map_width: int) -> list[PathStep]:
         PathStep(
             "NW", 0, half_height + half_default_distance, (DEFAULT_DISTANCE, DEFAULT_DISTANCE)
         ),
+    ]
+    full_tiles = [
         PathStep(
             PATH_FULL_NAME,
             None,
             None,
             (map_width + DEFAULT_DISTANCE * 2, map_height + DEFAULT_DISTANCE * 2),
         ),
+        PathStep(
+            PATH_FULL_PREVIEW_NAME,
+            None,
+            None,
+            (map_width + DEFAULT_DISTANCE * 2, map_height + DEFAULT_DISTANCE * 2),
+        ),
     ]
+
+    if only_full_tiles:
+        return full_tiles
+    return tiles + full_tiles

maps4fs/generator/texture.py

@@ -159,6 +159,7 @@ class Texture(Component):
 
     def preprocess(self) -> None:
         self.light_version = self.kwargs.get("light_version", False)
+        self.fields_padding = self.kwargs.get("fields_padding", 0)
         self.logger.debug("Light version: %s.", self.light_version)
 
         if not os.path.isfile(self.game.texture_schema):
@@ -476,7 +477,9 @@ class Texture(Component):
         pairs = list(zip(xs, ys))
         return np.array(pairs, dtype=np.int32).reshape((-1, 1, 2))
 
-    def _to_polygon(self, obj: pd.core.series.Series, width: int | None) -> np.ndarray | None:
+    def _to_polygon(
+        self, obj: pd.core.series.Series, width: int | None
+    ) -> shapely.geometry.polygon.Polygon:
         """Converts OSM object to numpy array of polygon points.
 
         Arguments:
@@ -484,7 +487,7 @@ class Texture(Component):
             width (int | None): Width of the polygon in meters.
 
         Returns:
-            np.ndarray | None: Numpy array of polygon points.
+            shapely.geometry.polygon.Polygon: Polygon geometry.
         """
         geometry = obj["geometry"]
         geometry_type = geometry.geom_type
@@ -498,7 +501,7 @@ class Texture(Component):
         self,
         geometry: shapely.geometry.linestring.LineString | shapely.geometry.point.Point,
         width: int | None,
-    ) -> np.ndarray:
+    ) -> shapely.geometry.polygon.Polygon:
         """Converts LineString or Point geometry to numpy array of polygon points.
 
         Arguments:
@@ -507,10 +510,23 @@ class Texture(Component):
             width (int | None): Width of the polygon in meters.
 
         Returns:
-            np.ndarray: Numpy array of polygon points.
+            shapely.geometry.polygon.Polygon: Polygon geometry.
         """
         polygon = geometry.buffer(width)
-        return self._to_np(polygon)
+        return polygon
+
+    def _skip(
+        self, geometry: shapely.geometry.polygon.Polygon, *args, **kwargs
+    ) -> shapely.geometry.polygon.Polygon:
+        """Returns the same geometry.
+
+        Arguments:
+            geometry (shapely.geometry.polygon.Polygon): Polygon geometry.
+
+        Returns:
+            shapely.geometry.polygon.Polygon: Polygon geometry.
+        """
+        return geometry
 
     def _converters(
         self, geom_type: str
@@ -523,7 +539,7 @@ class Texture(Component):
         Returns:
             Callable[[shapely.geometry, int | None], np.ndarray]: Converter function.
         """
-        converters = {"Polygon": self._to_np, "LineString": self._sequence, "Point": self._sequence}
+        converters = {"Polygon": self._skip, "LineString": self._sequence, "Point": self._sequence}
         return converters.get(geom_type)  # type: ignore
 
     def polygons(
@@ -538,6 +554,7 @@ class Texture(Component):
         Yields:
             Generator[np.ndarray, None, None]: Numpy array of polygon points.
         """
+        is_fieds = "farmland" in tags.values()
         try:
             objects = ox.features_from_bbox(bbox=self.new_bbox, tags=tags)
         except Exception as e:  # pylint: disable=W0718
@@ -551,7 +568,17 @@ class Texture(Component):
             polygon = self._to_polygon(obj, width)
             if polygon is None:
                 continue
-            yield polygon
+
+            if is_fieds and self.fields_padding > 0:
+                padded_polygon = polygon.buffer(-self.fields_padding)
+
+                if not isinstance(padded_polygon, shapely.geometry.polygon.Polygon):
+                    self.logger.warning("The padding value is too high, field will not padded.")
+                else:
+                    polygon = padded_polygon
+
+            polygon_np = self._to_np(polygon)
+            yield polygon_np
 
     def previews(self) -> list[str]:
         """Invokes methods to generate previews. Returns list of paths to previews.

maps4fs/generator/tile.py

@@ -49,7 +49,3 @@ class Tile(DEM):
             tuple[int, int]: The width and height of the output image.
         """
         return self.map_width, self.map_height
-
-    def make_copy(self, *args, **kwargs) -> None:
-        """Override the method to prevent copying the tile."""
-        pass  # pylint: disable=unnecessary-pass

{maps4fs-1.0.5.dist-info → maps4fs-1.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: maps4fs
-Version: 1.0.5
+Version: 1.0.8
 Summary: Generate map templates for Farming Simulator from real places.
 Author-email: iwatkot <iwatkot@gmail.com>
 License: MIT License
@@ -31,7 +31,7 @@ Requires-Dist: pympler
 <p align="center">
   <a href="#Quick-Start">Quick Start</a> •
   <a href="#Overview">Overview</a> • 
-  <a href="#Step-by-step">Create a map in 10 steps</a> •
+  <a href="docs/step_by_step.md">Create a map in 10 steps</a> •
   <a href="#How-To-Run">How-To-Run</a><br>
   <a href="docs/FAQ.md">FAQ</a> •
   <a href="docs/map_structure.md">Map Structure</a> •
@@ -69,12 +69,12 @@ Requires-Dist: pympler
 🚜 Supports Farming Simulator 22 and 25<br>
 🔷 Generates *.obj files for background terrain based on the real-world height map<br>
 📄 Generates scripts to download high-resolution satellite images from [QGIS](https://qgis.org/download/) in one click<br>
-🧰 Modder Toolbox to help you with various of tasks 🆕<br>
+🧰 Modder Toolbox to help you with various tasks 🆕<br>
 🌾 Automatically generates fields 🆕<br>
 
 <p align="center">
 <img src="https://github.com/user-attachments/assets/cf8f5752-9c69-4018-bead-290f59ba6976"><br>
-🌎 Detailed terrain based on real world data.<br><br>
+🌎 Detailed terrain based on real-world data.<br><br>
 <img src="https://github.com/user-attachments/assets/7f238ab4-9ff4-4c6e-ba07-5796be012baa"><br>
 🛰️ Realistic background terrain objects with satellite images.<br><br>
 <img src="https://github.com/user-attachments/assets/80e5923c-22c7-4dc0-8906-680902511f3a"><br>
@@ -85,14 +85,18 @@ Requires-Dist: pympler
 📏 Almost any possible map sizes.
 </p>
 
+📹 A complete step-by-step video tutorial is here!  
+<a href="https://www.youtube.com/watch?v=Nl_aqXJ5nAk" target="_blank"><img src="https://github.com/user-attachments/assets/4845e030-0e73-47ab-a5a3-430308913060"/></a>
+<i>How to Generate a Map for Farming Simulator 25 and 22 from a real place using maps4FS</i>
+
 ## Quick Start
 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>
+**Option 1:** Open the [maps4fs](https://maps4fs.streamlit.app) on StreamLit and generate a map template in a few clicks.<br>
 <i>Note, that StreamLit community hosting has some limitations, such as:  <br>
 1. Maximum map size is 4096x4096 meters.  <br>
 2. Advanced settings are disabled.  <br>
-3. Texure dissolving is disabled (they will look worse).  </i><br>
+3. Texture dissolving is disabled (they will look worse).  </i><br>
 
 If you run the application locally, you won't have any of these limitations and will be able to generate maps of any size with any settings you want and nice looking textures.<br>
 So, jump to [Docker version](#option-2-docker-version) to launch the tool with one command and get the full experience.<br>
@@ -100,7 +104,7 @@ So, jump to [Docker version](#option-2-docker-version) to launch the tool with o
 ![Basic WebUI](https://github.com/user-attachments/assets/52f499cc-f28a-4da3-abef-0e818abe8dbe)
 
 ### 😎 For advanced users
-**Option 2:** run the Docker version in your browser. Launch the following command in your terminal:
+**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
 ```
@@ -126,7 +130,7 @@ So, if you're new to map making, here's a quick overview of the process:
 
 ### Previews
 
-The generator also creates a multiple previews of the map. Here's the list of them:
+The generator also creates multiple previews of the map. Here's the list of them:
 1. General preview - merging all the layers into one image with different colors.
 2. Grayscale DEM preview - a grayscale image of the height map (as it is).
 3. Colored DEM preview - a colored image of the height map (from blue to red). The blue color represents the lowest point, and the red color represents the highest point.
@@ -143,10 +147,6 @@ Don't know where to start? Don't worry, just follow this [step-by-step guide](do
 
 ## How-To-Run
 
-You'll find detailed instructions on how to run the project below. But if you prefer video tutorials, here's one for you:
-<a href="https://www.youtube.com/watch?v=ujwWKHVKsw8" target="_blank"><img src="https://github.com/user-attachments/assets/6dbbbc71-d04f-40b2-9fba-81e5e4857407"/></a>
-<i>Video tutorial: How to generate a Farming Simulator 22 map from real-world data.</i>
-
 ### Option 1: StreamLit
 🟢 Recommended for all users.
 🛠️ Don't need to install anything.  
@@ -159,7 +159,7 @@ Note: due to CPU and RAM limitations of the hosting, the generation may take som
 Using it is easy and doesn't require any guides. Enjoy!
 
 ### Option 2: Docker version
-🟠 Recommended for users who want bigger maps, fast generation, nice looking textures and advanced settings.  
+🟠 Recommended for users who want bigger maps, fast generation, nice-looking textures, and advanced settings.  
 🛠️ Launch with one single command.  
 🗺️ Supported map sizes: 2x2, 4x4, 8x8, 16x16 km and any custom size.  
 ⚙️ Advanced settings: enabled.   
@@ -192,7 +192,7 @@ 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>
+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
@@ -230,12 +230,12 @@ The tool now has a Modder Toolbox, which is a set of tools to help you with vari
 
 ![Modder Toolbox](https://github.com/user-attachments/assets/dffb252f-f5c0-4021-9d45-31e5bccc0d9b)
 
-### Tool categories
+### Tool Categories
 Tools are divided into categories, which are listed below.
-#### Textures and DEM
-- **GeoTIFF windowing** - allows you to upload your GeoTIFF file and select the region of interest to extract it from the image. It's useful when you have high-resolution DEM data and want to create the height map using it.
+#### For Textures and DEM
+- **GeoTIFF windowing** - allows you to upload your GeoTIFF file and select the region of interest to extract it from the image. It's useful when you have high-resolution DEM data and want to create a height map using it.
 
-#### Background terrain
+#### For Background terrain
 - **Convert image to obj model** - allows you to convert the image to the obj model. You can use this tool to create the background terrain for your map. It can be extremely useful if you have access to the sources of high-resolution DEM data and want to create the background terrain using it.
 
 ## Supported objects
@@ -254,13 +254,13 @@ The project is based on the [OpenStreetMap](https://www.openstreetmap.org/) data
 The list will be updated as the project develops.
 
 ## Generation info
-The script will generate the `generation_info.json` file in the `output` folder. It splitted to the different sections, which represents the components of the map generator. You may need this information to use some other tools and services to obtain additional data for your map.<br>
+The script will generate the `generation_info.json` file in the `output` folder. It is split into different sections, which represent the components of the map generator. You may need this information to use some other tools and services to obtain additional data for your map.<br>
 
 List of components:
 - `Config` - this component handles the `map.xml` file, where the basic description of the map is stored.
 - `Texture` -  this component describes the textures, that were used to generate the map.
 - `DEM` - this component describes the Digital Elevation Model (the one which creates terrain on your map), which was used to generate the height map and related to the `dem.png` file.
-- `I3d` - this component describes the i3d file, where some specific attributes properties and path to the files are stored.
+- `I3d` - this component describes the i3d file, where some specific attributes properties, and paths to the files are stored.
 - `Background` - this component describes the 8 tiles, that surround the map.
 
 Below you'll find descriptions of the components and the fields that they contain.<br>
@@ -281,9 +281,9 @@ Example of the `Config` component:
     }
 },
 ```
-The `Overview` section contains information to create an overview image, which represents the in-game map. You can use the `epsg3857_string` to obtain the satellite images in the QGIS. So this section describes the region of the map plus the borders. Usually, it's exact 2X the size of the map.<br>
+The `Overview` section contains information to create an overview image, which represents the in-game map. You can use the `epsg3857_string` to obtain the satellite images in the QGIS. So this section describes the region of the map plus the borders. Usually, it's exactly 2X the size of the map.<br>
 And here's the list of the fields:
-- `"epsg3857_string"` - the string representation of the bounding box in the EPSG:3857 projection, it's required to obtain the satellite images in the QGIS,<br>
+- `"epsg3857_string"` - the string representation of the bounding box in the EPSG:3857 projection, it is required to obtain the satellite images in the QGIS,<br>
 - `"south"` - the southern border of overview region,<br>
 - `"west"` - the western border of overview region,<br>
 - `"north"` - the northern border of overview region,<br>
@@ -328,7 +328,7 @@ And here's the list of the fields:
 
 ### Background
 
-The background component consist of the 8 tiles, each one represents the tile, that surrounds the map. The tiles are named as the cardinal points, e.g. "N", "NE", "E" and so on.<br>
+The background component consists of the 8 tiles, each one representing the tile, that surrounds the map. The tiles are named as the cardinal points, e.g. "N", "NE", "E" and so on.<br>
 Example of the `Background` component:
 
 ```json
@@ -350,7 +350,7 @@ Example of the `Background` component:
 And here's the list of the fields:
 - `"center_latitude"` - the latitude of the center of the tile,<br>
 - `"center_longitude"` - the longitude of the center of the tile,<br>
-- `"epsg3857_string"` - the string representation of the bounding box in the EPSG:3857 projection, it's required to obtain the satellite images in the QGIS,<br>
+- `"epsg3857_string"` - the string representation of the bounding box in the EPSG:3857 projection, it is required to obtain the satellite images in the QGIS,<br>
 - `"height"` - the height of the tile in meters,<br>
 - `"width"` - the width of the tile in meters,<br>
 - `"north"` - the northern border of the tile,<br>
@@ -359,7 +359,7 @@ And here's the list of the fields:
 - `"west"` - the western border of the tile,<br>
 
 ## Texture schema
-maps4fs uses a simple JSON file to define the texture schema. For each of supported games this file has unique entries, but the structure is the same. Here's an example of the schema for Farming Simulator 25:
+maps4fs uses a simple JSON file to define the texture schema. For each ofthe  supported games, this file has unique entries, but the structure is the same. Here's an example of the schema for Farming Simulator 25:
 
 ```json
 [
@@ -395,39 +395,39 @@ maps4fs uses a simple JSON file to define the texture schema. For each of suppor
 Let's have a closer look at the fields:
 - `name` - the name of the texture. Just the way the file will be named.
 - `count` - the number of textures of this type. For example, for the **dirtMedium** texture there will be two textures: **dirtMedium01_weight.png** and **dirtMedium02_weight.png**.
-ℹ️ There's one texture that have count `0`, it's the waterPuddle texture from FS22, which not present in FS25.
+ℹ️ There's one texture that has count `0`, it's the waterPuddle texture from FS22, which is not present in FS25.
 - `tags` - the tags from the OpenStreetMap data. Refer to the section [Supported objects](#supported-objects) to see the list of supported tags. If there are no tags, the texture file will be generated empty and no objects will be placed on it.
 - `width` - the width of the texture in meters. Some of the objects from OSM (roads, for example) are lines, not areas. So, to draw them correctly, the tool needs to know the width of the line.
-- `color` - the color of the texture. It's used only in the preview images and have no effect on the map itself. But remember that previews are crucial for the map making process, so it's better to set the color to something that represents the texture.
+- `color` - the color of the texture. It's used only in the preview images and has no effect on the map itself. But remember that previews are crucial for the map-making process, so it's better to set the color to something that represents the texture.
 - `priority` - the priority of the texture for overlapping. Textures with higher priorities will be drawn over the textures with lower priorities.
 ℹ️ The texture with 0 priority considers the base layer, which means that all empty areas will be filled with this texture.
-- `exclude_weight` - this only used for the forestRockRoots texture from FS25. It's just means that this texture has no `weight` postfix, that's all.
+- `exclude_weight` - this is only used for the forestRockRoots texture from FS25. It just means that this texture has no `weight` postfix, that's all.
 
 ## Background terrain
-The tool now supports the generation of the background terrain. If you don't know what it is, here's a brief explanation. The background terrain is the world around the map. It's important to create it, because if you don't, the map will look like it's floating in the void. The background terrain is a simple plane which can (and should) be texture to look fine.<br>
-So, the tool generates the background terrain in the form of the 8 tiles, which surround the map. The tiles are named as the cardinal points, e.g. "N", "NE", "E" and so on. All those tiles will be saved in the `background` directory with corresponding names: `N.obj`, `NE.obj`, `E.obj` and so on.<br>
-If you don't want to work with separate tiles, the tool also generates the `FULL.obj` file, which includes everything around the map and the map itself. It may be a convinient approach to work with one file, one texture and then just cut the map from it.<br>
+The tool now supports the generation of the background terrain. If you don't know what it is, here's a brief explanation. The background terrain is the world around the map. It's important to create it because if you don't, the map will look like it's floating in the void. The background terrain is a simple plane that can (and should) be textured to look fine.<br>
+So, the tool generates the background terrain in the form of the 8 tiles, which surround the map. The tiles are named as the cardinal points, e.g. "N", "NE", "E" and so on. All those tiles will be saved in the `background` directory with corresponding names: `N.obj`, `NE.obj`, `E.obj`, and so on.<br>
+If you don't want to work with separate tiles, the tool also generates the `FULL.obj` file, which includes everything around the map and the map itself. It may be a convenient approach to work with one file, one texture, and then just cut the map from it.<br>
 
 ![Complete background terrain in Blender](https://github.com/user-attachments/assets/7266b8f1-bfa2-4c14-a740-1c84b1030a66)
 
-➡️ *No matter which approach you choose, you still need to adjust the background terrain to connect it to the map without any gaps. But with a sinlge file it's much easier to do.*
+➡️ *No matter which approach you choose, you still need to adjust the background terrain to connect it to the map without any gaps. But with a single file, it's much easier to do.*
 
-If you're willing to create a background terrain, you will need: Blender, the Blender Exporter Plugins and the QGIS. You'll find the download links in the [Resources](#resources) section.<br>
+If you're willing to create a background terrain, you will need Blender, the Blender Exporter Plugins, and the QGIS. You'll find the download links in the [Resources](#resources) section.<br>
 
-If you're afraid of this task, please don't be. It's really simple and I've prepaired detailed step-by-step instructions for you, you'll find them in the separate README files. Here are the steps you need to follow:
+If you're afraid of this task, please don't be. It's really simple and I've prepared detailed step-by-step instructions for you, you'll find them in the separate README files. Here are the steps you need to follow:
 
 1. [Download high-resolution satellite images](docs/download_satellite_images.md).
 2. [Prepare the i3d files](docs/create_background_terrain.md).
 3. [Import the i3d files to Giants Editor](docs/import_to_giants_editor.md).
 
 ## Overview image
-The overview image is an image that is used as in-game map. No matter what the size of the map, this file is always `4096x4096 pixels`, while the region of your map is `2048x2048 pixels` in center of this file. The rest of the image is just here for nice view, but you still may add satellite pictures to this region.<br>
+The overview image is an image that is used as an in-game map. No matter what the size of the map, this file is always `4096x4096 pixels`, while the region of your map is `2048x2048 pixels` in the center of this file. The rest of the image is just here for a nice view, but you still may add satellite pictures to this region.<br>
 
 <img width="400" src="https://github.com/user-attachments/assets/ede9ea81-ef97-4914-9dbf-9761ef1eb7ca">
 
 Cool image by [@ZenJakey](https://github.com/ZenJakey).
 
-So, the same way you've downloaded the satellite images for the background terrain, you can download them for the overview image. Just use the `epsg3857_string` from the `generation_info.json` file. You'll find the needed string in the `Config` component in the `Overview` section:
+So, in the same way, you've downloaded the satellite images for the background terrain, you can download them for the overview image. Just use the `epsg3857_string` from the `generation_info.json` file. You'll find the needed string in the `Config` component in the `Overview` section:
 
 ```json
 "Config": {
@@ -437,35 +437,43 @@ So, the same way you've downloaded the satellite images for the background terra
 },
 ```
 
-After it you need to resize the image to 4096x4096 pixels and convert it to the `.dds` format.
+After that, you need to resize the image to 4096x4096 pixels and convert it to the `.dds` format.
 
 ## DDS conversion
-The `.dds` format is the format used in the Farming Simulator for the textures, icons, overview and preview images. There's a plenty of options to convert the images to the `.dds` format, you can just google something like `png to dds` and the first link probably will help you with it.<br>
+The `.dds` format is the format used in the Farming Simulator for the textures, icons, overview, and preview images. There a plenty of options to convert the images to the `.dds` format, you can just google something like `png to dds`, and the first link probably will help you with it.<br>
 
 List of the important DDS files:
 - `icon.dds` - 256x256 pixels, the icon of the map,
-- `preview.dds` - 2048x2048 pixels, the preview image of the map on loading screen,
+- `preview.dds` - 2048x2048 pixels, the preview image of the map on the loading screen,
 - `mapsUS/overview.dds` - 4096x4096 pixels, the overview image of the map (in-game map)
 
 ## For advanced users
 The tool supports the custom size of the map. To use this feature select `Custom` in the `Map size` dropdown and enter the desired size. The tool will generate a map with the size you entered.<br>
 
-⛔️ Do not use this feature, if you don't know what you're doing. In most cases the Giants Editor will just crash on opening the file, because you need to enter a specific values for the map size.<br><br>
+⛔️ Do not use this feature, if you don't know what you're doing. In most cases, the Giants Editor will just crash on opening the file, because you need to enter specific values for the map size.<br><br>
 
-![Advanced settings](https://github.com/user-attachments/assets/e7406adf-6b82-41a0-838a-13dd8877bebf)
+![Advanced settings](https://github.com/user-attachments/assets/9e8e178a-58d9-4aa6-aefd-4ed53408701d)
 
 You can also apply some advanced settings to the map generation process. Note that they're ADVANCED, so you don't need to use them if you're not sure what they do.<br>
 
-Here's the list of the advanced settings:
+### DEM Advanced settings
+
+- Multiplier: the height of the map is multiplied by this value. So the DEM map is just a 16-bit grayscale image, which means that the maximum available value there is 65535, while the actual difference between the deepest and the highest point on Earth is about 20 km. Just note that this setting mostly does not matter, because you can always adjust it in the Giants Editor, learn more about the DEM file and the heightScale parameter in [docs](docs/dem.md). By default, it's set to 1.
+
+- Blur radius: the radius of the Gaussian blur filter applied to the DEM map. By default, it's set to 21. This filter just makes the DEM map smoother, so the height transitions will be more natural. You can set it to 1 to disable the filter, but it will result in a Minecraft-like map.
+
+- Plateau height: this value will be added to each pixel of the DEM image, making it "higher". It's useful when you want to add some negative heights on the map, that appear to be in a "low" place. By default, it's set to 0.
+
+### Background Terrain Advanced settings
 
-- DEM multiplier: the height of the map is multiplied by this value. So the DEM map is just a 16-bit grayscale image, which means that the maximum avaiable value there is 65535, while the actual difference between the deepest and the highest point on Earth is about 20 km. Just note that this setting mostly does not matter, because you can always adjust it in the Giants Editor, learn more about the DEM file and the heightScale paramter in [docs](docs/dem.md). By default, it's set to 1.
+- Background Terrain Generate only full tiles: if checked (by default) the small tiles (N, NE, E, and so on) will not be generated, only the full tile will be created. It's useful when you don't want to work with separate tiles, but with one big file. Since the new method of cutting the map from the background terrain added to the documentation, and now it's possible to perfectly align the map with the background terrain, this option will remain just as a legacy one.
 
-- DEM Blur radius: the radius of the Gaussian blur filter applied to the DEM map. By default, it's set to 21. This filter just makes the DEM map smoother, so the height transitions will be more natural. You can set it to 1 to disable the filter, but it will result as a Minecraft-like map.
+### Texture Advanced settings
 
-- DEM Plateau height: this value will be added to each pixel of the DEM image, making it "higher". It's useful when you want to add some negative heights on the map, which appears to be in a "low" place. By default, it's set to 0.
+- Fields padding - this value (in meters) will be applied to each field, making it smaller. It's useful when the fields are too close to each other and you want to make them smaller. By default, it's set to 0.
 
 ## Resources
-In this section you'll find a list of the resources that you need to create a map for the Farming Simulator.<br>
+In this section, you'll find a list of the resources that you need to create a map for the Farming Simulator.<br>
 To create a basic map, you only need the Giants Editor. But if you want to create a background terrain - the world around the map, so it won't look like it's floating in the void - you also need Blender and the Blender Exporter Plugins. To create realistic textures for the background terrain, the QGIS is required to obtain high-resolution satellite images.<br>
 
 1. [Giants Editor](https://gdn.giants-software.com/downloads.php) - the official tool for creating maps for the Farming Simulator.
@@ -473,7 +481,7 @@ To create a basic map, you only need the Giants Editor. But if you want to creat
 3. [Blender Exporter Plugins](https://gdn.giants-software.com/downloads.php) - the official plugins for exporting models from Blender to i3d format (the format used in the Farming Simulator).
 4. [QGIS](https://qgis.org/download/) - the open-source GIS software that you can use to obtain high-resolution satellite images for your map.
 5. [CompressPngCom](https://www.compresspng.com/) - the online tool to compress the PNG images. May be useful to reduce the size of the satellite images.
-6. [AnyConv](https://anyconv.com/png-to-dds-converter/) - the online tool to convert the PNG images to the DDS format. You'll need this format for the textures, icons, overview and preview images.
+6. [AnyConv](https://anyconv.com/png-to-dds-converter/) - the online tool to convert the PNG images to the DDS format. You'll need this format for the textures, icons, overview, and preview images.
 
 ## Bugs and feature requests
 ➡️ Please, before creating an issue or asking some questions, check the [FAQ](docs/FAQ.md) section.<br>

{maps4fs-1.0.5.dist-info → maps4fs-1.0.8.dist-info}/RECORD

@@ -1,23 +1,23 @@
 maps4fs/__init__.py,sha256=da4jmND2Ths9AffnkAKgzLHNkvKFOc_l21gJisPXqWY,155
 maps4fs/logger.py,sha256=B-NEYpMjPAAqlV4VpfTi6nbBFnEABVtQOaYe6nMpidg,1489
 maps4fs/generator/__init__.py,sha256=zZMLEkGzb4z0xql650gOtGSvcgX58DnJ2yN3vC2daRk,43
-maps4fs/generator/background.py,sha256=7Mzny2dgb60PtRnb_ar_ea_3W8LU1K45kr_pe9fA0ms,10458
+maps4fs/generator/background.py,sha256=ogd5TmAWL5zhZtTCOH8YHGKqc0SGQqOsWuVg3AaZO0I,14015
 maps4fs/generator/component.py,sha256=swOocaEOP3XtZgHfgDJ0ROALWoLgCJwMq8ubl0d2WrI,11085
 maps4fs/generator/config.py,sha256=kspXIT2o-_28EU0RQsROHCjkgQdqQnvreAKP5QAC5Ws,4279
-maps4fs/generator/dem.py,sha256=Z4MwXqJMmzIQJ4kNGvsj-zc_4YOzzyev3JPAbegL9P0,17039
-maps4fs/generator/game.py,sha256=3Y65K-XQDKxfMRSrjsmE8qX0tQSd0aDzMUT6yGIhzXg,7450
+maps4fs/generator/dem.py,sha256=cCJLE20-XKaQx5lwIFNEgmQ5kfhE24QmVrAyMVwsU_A,16459
+maps4fs/generator/game.py,sha256=4I6edxTeZf41Vgvx6BaucEflMEHomRRvdMZRJAPm0d4,7450
 maps4fs/generator/grle.py,sha256=qy1tGxDNCBql1dxYBwN2Iu0g4XFFPCDvlvx9bEUoXWM,3090
-maps4fs/generator/i3d.py,sha256=1z1SuFCg2lmfJl10CuhWstflm44hjL6ldQ7nwbMndZc,14219
+maps4fs/generator/i3d.py,sha256=0rZyVLQBn1R0orIOfVvZewGMVWR-mAoqwqa6vebypZQ,13952
 maps4fs/generator/map.py,sha256=gDZUZ2wimoeA8mHVOCnZvrIBeK7b99OIWFd_LjruqBc,4677
-maps4fs/generator/path_steps.py,sha256=yeN6hmOD8O2LMozUf4HcQMIy8WJ5sHF5pGQT_s2FfOw,3147
+maps4fs/generator/path_steps.py,sha256=twhoP0KOYWOpOJfYrSWPHygtIeM-r5cIlePg1SHVyHk,3589
 maps4fs/generator/qgis.py,sha256=Es8hLuqN_KH8lDfnJE6He2rWYbAKJ3RGPn-o87S6CPI,6116
-maps4fs/generator/texture.py,sha256=BZjJIHwGEQMoRULAhvTPyKx8k7jlot5voVk82_TsXgg,23668
-maps4fs/generator/tile.py,sha256=_UZ-iHGPghUfpYcG0OboquNczpZ1FaCVYpBgNLd72eo,2160
+maps4fs/generator/texture.py,sha256=2c2x99xnqKZoXDB4fdQBESFMPMiGrbx_fADFTdx4ZGY,24638
+maps4fs/generator/tile.py,sha256=z1-xEVjgFNf2WzLkgwoGGq8nREJpjPljeC9lmb5xPKA,1997
 maps4fs/toolbox/__init__.py,sha256=zZMLEkGzb4z0xql650gOtGSvcgX58DnJ2yN3vC2daRk,43
 maps4fs/toolbox/background.py,sha256=9BXWNqs_n3HgqDiPztWylgYk_QM4YgBpe6_ZNQAWtSc,2154
 maps4fs/toolbox/dem.py,sha256=z9IPFNmYbjiigb3t02ZenI3Mo8odd19c5MZbjDEovTo,3525
-maps4fs-1.0.5.dist-info/LICENSE.md,sha256=pTKD_oUexcn-yccFCTrMeLkZy0ifLRa-VNcDLqLZaIw,10749
-maps4fs-1.0.5.dist-info/METADATA,sha256=hA3GpLHjHxWsKQsUEdtA0DDR-QcgBk6CYSO_hnZkbug,27123
-maps4fs-1.0.5.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-maps4fs-1.0.5.dist-info/top_level.txt,sha256=Ue9DSRlejRQRCaJueB0uLcKrWwsEq9zezfv5dI5mV1M,8
-maps4fs-1.0.5.dist-info/RECORD,,
+maps4fs-1.0.8.dist-info/LICENSE.md,sha256=pTKD_oUexcn-yccFCTrMeLkZy0ifLRa-VNcDLqLZaIw,10749
+maps4fs-1.0.8.dist-info/METADATA,sha256=IOBr8g1SaorXmDjL1DR33Lm431WpWb8j5PLCUfxXNUk,27836
+maps4fs-1.0.8.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+maps4fs-1.0.8.dist-info/top_level.txt,sha256=Ue9DSRlejRQRCaJueB0uLcKrWwsEq9zezfv5dI5mV1M,8
+maps4fs-1.0.8.dist-info/RECORD,,