From 116428f4c8f6fb57db9cdc18d3dc303cced91d8d Mon Sep 17 00:00:00 2001
From: Stan Soldatov <iwatkot@gmail.com>
Date: Sun, 22 Dec 2024 04:03:35 +0100
Subject: [PATCH] Generation of forests.

---
 data/fs25-map-template.zip   | Bin 2196054 -> 2196770 bytes
 data/fs25-tree-schema.json   | 338 +++++++++++++++++++++++++++++++++++
 maps4fs/generator/game.py    |  15 ++
 maps4fs/generator/grle.py    |   2 +
 maps4fs/generator/i3d.py     | 119 +++++++++++-
 maps4fs/generator/texture.py |   1 -
 6 files changed, 473 insertions(+), 2 deletions(-)
 create mode 100644 data/fs25-tree-schema.json

diff --git a/data/fs25-map-template.zip b/data/fs25-map-template.zip
index 16def5ed317d509925e40cfb32cd9c973b471d85..1c156d09b1bf1e5a62697387a9bffe53fcf93ac6 100644
GIT binary patch
delta 15420
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
ZoK_bIiY-mkP=At%z{q)%fxZp?{{RH9;z9rb

delta 14704
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

diff --git a/data/fs25-tree-schema.json b/data/fs25-tree-schema.json
new file mode 100644
index 00000000..597dc55a
--- /dev/null
+++ b/data/fs25-tree-schema.json
@@ -0,0 +1,338 @@
+[
+  {
+    "name": "americanElmRavaged",
+    "reference_id": 1000
+  },
+  {
+    "name": "americanElm_stage01",
+    "reference_id": 1001
+  },
+  {
+    "name": "americanElm_stage02",
+    "reference_id": 1002
+  },
+  {
+    "name": "americanElm_stage03",
+    "reference_id": 1003
+  },
+  {
+    "name": "americanElm_stage04",
+    "reference_id": 1004
+  },
+  {
+    "name": "americanElm_stage05",
+    "reference_id": 1005
+  },
+  {
+    "name": "apple_stage03",
+    "reference_id": 1006
+  },
+  {
+    "name": "aspen_stage01",
+    "reference_id": 1007
+  },
+  {
+    "name": "aspen_stage02",
+    "reference_id": 1008
+  },
+  {
+    "name": "aspen_stage03",
+    "reference_id": 1009
+  },
+  {
+    "name": "aspen_stage04",
+    "reference_id": 1010
+  },
+  {
+    "name": "aspen_stage05",
+    "reference_id": 1011
+  },
+  {
+    "name": "aspen_stage06_var01",
+    "reference_id": 1012
+  },
+  {
+    "name": "aspen_stage06_var02",
+    "reference_id": 1013
+  },
+  {
+    "name": "beech_stage01",
+    "reference_id": 1014
+  },
+  {
+    "name": "beech_stage02",
+    "reference_id": 1015
+  },
+  {
+    "name": "beech_stage02_var02",
+    "reference_id": 1016
+  },
+  {
+    "name": "beech_stage02_var03",
+    "reference_id": 1017
+  },
+  {
+    "name": "beech_stage03",
+    "reference_id": 1018
+  },
+  {
+    "name": "beech_stage04",
+    "reference_id": 1019
+  },
+  {
+    "name": "beech_stage05",
+    "reference_id": 1020
+  },
+  {
+    "name": "beech_stage06_var01",
+    "reference_id": 1021
+  },
+  {
+    "name": "beech_stage06_var02",
+    "reference_id": 1022
+  },
+  {
+    "name": "betulaErmanii_stage01",
+    "reference_id": 1023
+  },
+  {
+    "name": "betulaErmanii_stage02",
+    "reference_id": 1024
+  },
+  {
+    "name": "betulaErmanii_stage03",
+    "reference_id": 1025
+  },
+  {
+    "name": "betulaErmanii_stage04",
+    "reference_id": 1026
+  },
+  {
+    "name": "boxelder_stage01",
+    "reference_id": 1027
+  },
+  {
+    "name": "boxelder_stage02",
+    "reference_id": 1028
+  },
+  {
+    "name": "boxelder_stage03",
+    "reference_id": 1029
+  },
+  {
+    "name": "cherry_stage01",
+    "reference_id": 1030
+  },
+  {
+    "name": "cherry_stage02",
+    "reference_id": 1031
+  },
+  {
+    "name": "cherry_stage03",
+    "reference_id": 1032
+  },
+  {
+    "name": "cherry_stage04",
+    "reference_id": 1033
+  },
+  {
+    "name": "chineseElm_stage01",
+    "reference_id": 1034
+  },
+  {
+    "name": "chineseElm_stage02",
+    "reference_id": 1035
+  },
+  {
+    "name": "chineseElm_stage03",
+    "reference_id": 1036
+  },
+  {
+    "name": "chineseElm_stage04",
+    "reference_id": 1037
+  },
+  {
+    "name": "deadwood",
+    "reference_id": 1038
+  },
+  {
+    "name": "downyServiceBerry_stage01",
+    "reference_id": 1039
+  },
+  {
+    "name": "downyServiceBerry_stage02",
+    "reference_id": 1040
+  },
+  {
+    "name": "downyServiceBerry_stage03",
+    "reference_id": 1041
+  },
+  {
+    "name": "goldenRain_stage01",
+    "reference_id": 1042
+  },
+  {
+    "name": "goldenRain_stage02",
+    "reference_id": 1043
+  },
+  {
+    "name": "goldenRain_stage03",
+    "reference_id": 1044
+  },
+  {
+    "name": "goldenRain_stage04",
+    "reference_id": 1045
+  },
+  {
+    "name": "japaneseZelkova_stage01",
+    "reference_id": 1046
+  },
+  {
+    "name": "japaneseZelkova_stage02",
+    "reference_id": 1047
+  },
+  {
+    "name": "japaneseZelkova_stage03",
+    "reference_id": 1048
+  },
+  {
+    "name": "japaneseZelkova_stage04",
+    "reference_id": 1049
+  },
+  {
+    "name": "lodgepolePine_stage01",
+    "reference_id": 1050
+  },
+  {
+    "name": "lodgepolePine_stage02",
+    "reference_id": 1051
+  },
+  {
+    "name": "lodgepolePine_stage02Var2",
+    "reference_id": 1052
+  },
+  {
+    "name": "lodgepolePine_stage03",
+    "reference_id": 1053
+  },
+  {
+    "name": "lodgepolePine_stage03Var2",
+    "reference_id": 1054
+  },
+  {
+    "name": "northernCatalpa_stage01",
+    "reference_id": 1055
+  },
+  {
+    "name": "northernCatalpa_stage02",
+    "reference_id": 1056
+  },
+  {
+    "name": "northernCatalpa_stage03",
+    "reference_id": 1057
+  },
+  {
+    "name": "northernCatalpa_stage04",
+    "reference_id": 1058
+  },
+  {
+    "name": "oak_stage01",
+    "reference_id": 1059
+  },
+  {
+    "name": "oak_stage02",
+    "reference_id": 1060
+  },
+  {
+    "name": "oak_stage03",
+    "reference_id": 1061
+  },
+  {
+    "name": "oak_stage04",
+    "reference_id": 1062
+  },
+  {
+    "name": "oak_stage05",
+    "reference_id": 1063
+  },
+  {
+    "name": "pinusSylvestris_stage01",
+    "reference_id": 1064
+  },
+  {
+    "name": "pinusSylvestris_stage02",
+    "reference_id": 1065
+  },
+  {
+    "name": "pinusSylvestris_stage03",
+    "reference_id": 1066
+  },
+  {
+    "name": "pinusSylvestris_stage04",
+    "reference_id": 1067
+  },
+  {
+    "name": "pinusSylvestris_stage05",
+    "reference_id": 1068
+  },
+  {
+    "name": "pinusTabuliformis_stage01",
+    "reference_id": 1069
+  },
+  {
+    "name": "pinusTabuliformis_stage02",
+    "reference_id": 1070
+  },
+  {
+    "name": "pinusTabuliformis_stage03",
+    "reference_id": 1071
+  },
+  {
+    "name": "pinusTabuliformis_stage04",
+    "reference_id": 1072
+  },
+  {
+    "name": "pinusTabuliformis_stage05",
+    "reference_id": 1073
+  },
+  {
+    "name": "shagbarkHickory_stage01",
+    "reference_id": 1074
+  },
+  {
+    "name": "shagbarkHickory_stage02",
+    "reference_id": 1075
+  },
+  {
+    "name": "shagbarkHickory_stage03",
+    "reference_id": 1076
+  },
+  {
+    "name": "shagbarkHickory_stage04",
+    "reference_id": 1077
+  },
+  {
+    "name": "tiliaAmurensis_stage01",
+    "reference_id": 1078
+  },
+  {
+    "name": "tiliaAmurensis_stage02",
+    "reference_id": 1079
+  },
+  {
+    "name": "tiliaAmurensis_stage03",
+    "reference_id": 1080
+  },
+  {
+    "name": "tiliaAmurensis_stage04",
+    "reference_id": 1081
+  },
+  {
+    "name": "transportTree",
+    "reference_id": 1082
+  },
+  {
+    "name": "treesRavaged",
+    "reference_id": 1083
+  }
+]
diff --git a/maps4fs/generator/game.py b/maps4fs/generator/game.py
index e576a833..c4f362b2 100644
--- a/maps4fs/generator/game.py
+++ b/maps4fs/generator/game.py
@@ -36,6 +36,7 @@ class Game:
     _map_template_path: str | None = None
     _texture_schema: str | None = None
     _grle_schema: str | None = None
+    _tree_schema: str | None = None
 
     # Order matters! Some components depend on others.
     components = [Texture, I3d, GRLE, Background, Config]
@@ -109,6 +110,19 @@ def grle_schema(self) -> str:
             raise ValueError("GRLE layers schema path not set.")
         return self._grle_schema
 
+    @property
+    def tree_schema(self) -> str:
+        """Returns the path to the tree layers schema file.
+
+        Raises:
+            ValueError: If the tree layers schema path is not set.
+
+        Returns:
+            str: The path to the tree layers schema file."""
+        if not self._tree_schema:
+            raise ValueError("Tree layers schema path not set.")
+        return self._tree_schema
+
     def dem_file_path(self, map_directory: str) -> str:
         """Returns the path to the DEM file.
 
@@ -187,6 +201,7 @@ class FS25(Game):
     _map_template_path = os.path.join(working_directory, "data", "fs25-map-template.zip")
     _texture_schema = os.path.join(working_directory, "data", "fs25-texture-schema.json")
     _grle_schema = os.path.join(working_directory, "data", "fs25-grle-schema.json")
+    _tree_schema = os.path.join(working_directory, "data", "fs25-tree-schema.json")
 
     def dem_file_path(self, map_directory: str) -> str:
         """Returns the path to the DEM file.
diff --git a/maps4fs/generator/grle.py b/maps4fs/generator/grle.py
index c2c11fbe..2b0e61e3 100644
--- a/maps4fs/generator/grle.py
+++ b/maps4fs/generator/grle.py
@@ -218,6 +218,8 @@ def _add_plants(self) -> None:
         grass_image_path = grass_layer.get_preview_or_path(weights_directory)
         self.logger.debug("Grass image path: %s.", grass_image_path)
 
+        # TODO: Get the forest layer and combine it with the grass layer.
+
         if not grass_image_path or not os.path.isfile(grass_image_path):
             self.logger.warning("Base image not found in %s.", grass_image_path)
             return
diff --git a/maps4fs/generator/i3d.py b/maps4fs/generator/i3d.py
index 2bb750af..af2821aa 100644
--- a/maps4fs/generator/i3d.py
+++ b/maps4fs/generator/i3d.py
@@ -4,15 +4,22 @@
 
 import json
 import os
+from random import choice
+from typing import Generator
 from xml.etree import ElementTree as ET
 
+import cv2
+import numpy as np
+
 from maps4fs.generator.component import Component
+from maps4fs.generator.texture import Texture
 
 DEFAULT_HEIGHT_SCALE = 2000
 DISPLACEMENT_LAYER_SIZE_FOR_BIG_MAPS = 32768
 DEFAULT_MAX_LOD_DISTANCE = 10000
 DEFAULT_MAX_LOD_OCCLUDER_DISTANCE = 10000
-NODE_ID_STARTING_VALUE = 500
+NODE_ID_STARTING_VALUE = 2000
+TREE_NODE_ID_STARTING_VALUE = 4000
 
 
 # pylint: disable=R0903
@@ -48,6 +55,7 @@ def process(self) -> None:
         """Updates the map I3D file with the default settings."""
         self._update_i3d_file()
         self._add_fields()
+        self._add_forests()
 
     def _get_tree(self) -> ET.ElementTree | None:
         """Returns the ElementTree instance of the map I3D file."""
@@ -316,3 +324,112 @@ def create_attribute_node(name: str, attr_type: str, value: str) -> ET.Element:
         attribute_node.set("type", attr_type)
         attribute_node.set("value", value)
         return attribute_node
+
+    def _add_forests(self) -> None:
+        try:
+            tree_schema_path = self.game.tree_schema
+        except ValueError:
+            self.logger.warning("Tree schema path not set for the Game %s.", self.game.code)
+            return
+
+        if not os.path.isfile(tree_schema_path):
+            self.logger.warning("Tree schema file was not found: %s.", tree_schema_path)
+            return
+
+        try:
+            with open(tree_schema_path, "r", encoding="utf-8") as tree_schema_file:
+                tree_schema: list[dict[str, str | int]] = json.load(tree_schema_file)
+        except json.JSONDecodeError as e:
+            self.logger.warning(
+                "Could not load tree schema from %s with error: %s", tree_schema_path, e
+            )
+            return
+
+        texture_component: Texture | None = self.map.get_component("Texture")
+        if not texture_component:
+            self.logger.warning("Texture component not found.")
+            return
+
+        forest_layer = texture_component.get_layer_by_usage("forest")
+
+        if not forest_layer:
+            self.logger.warning("Forest layer not found.")
+            return
+
+        weights_directory = self.game.weights_dir_path(self.map_directory)
+        forest_image_path = forest_layer.get_preview_or_path(weights_directory)
+
+        if not forest_image_path or not os.path.isfile(forest_image_path):
+            self.logger.warning("Forest image not found.")
+            return
+
+        tree = self._get_tree()
+        if tree is None:
+            return
+
+        # Find the <Scene> element in the I3D file.
+        root = tree.getroot()
+        scene_node = root.find(".//Scene")
+        if scene_node is None:
+            self.logger.warning("Scene element not found in I3D file.")
+            return
+
+        self.logger.debug("Scene element found in I3D file, starting to add forests.")
+
+        node_id = TREE_NODE_ID_STARTING_VALUE
+
+        # Create <TransformGroup name="trees" translation="0 400 0" nodeId="{node_id}"> element.
+        trees_node = ET.Element("TransformGroup")
+        trees_node.set("name", "trees")
+        trees_node.set("translation", "0 400 0")
+        trees_node.set("nodeId", str(node_id))
+        node_id += 1
+
+        forest_image = cv2.imread(forest_image_path, cv2.IMREAD_UNCHANGED)
+
+        tree_count = 0
+        for x, y in self.non_empty_pixels(forest_image, step=2):
+            xcs, ycs = self.top_left_coordinates_to_center((x, y))
+            node_id += 1
+
+            # TODO: Randomize coordinates.
+
+            random_tree = choice(tree_schema)
+            tree_name = random_tree["name"]
+            tree_id = random_tree["reference_id"]
+
+            # <ReferenceNode name="oak_stage02" translation="{x} 0 {y}" rotation="0 -0 0" referenceId="658" nodeId="{node_id}"/>
+            reference_node = ET.Element("ReferenceNode")
+            reference_node.set("name", tree_name)
+            reference_node.set("translation", f"{xcs} 0 {ycs}")
+            reference_node.set("rotation", "0 -0 0")
+            reference_node.set("referenceId", str(tree_id))
+            reference_node.set("nodeId", str(node_id))
+
+            trees_node.append(reference_node)
+            tree_count += 1
+
+        scene_node.append(trees_node)
+        self.logger.info("Added %s trees to the I3D file.", tree_count)
+
+        tree.write(self._map_i3d_path)  # type: ignore
+        self.logger.info("Map I3D file saved to: %s.", self._map_i3d_path)
+
+    @staticmethod
+    def non_empty_pixels(
+        image: np.ndarray, step: int = 1
+    ) -> Generator[tuple[int, int], None, None]:
+        """Receives numpy array, which represents single-channeled image of uint8 type.
+        Yield coordinates of non-empty pixels (pixels with value greater than 0).
+
+        Arguments:
+            image (np.ndarray): The image to get non-empty pixels from.
+            step (int, optional): The step to iterate through the image. Defaults to 1.
+
+        Yields:
+            tuple[int, int]: The coordinates of non-empty pixels.
+        """
+        for y, row in enumerate(image[::step]):
+            for x, value in enumerate(row[::step]):
+                if value > 0:
+                    yield x * step, y * step
diff --git a/maps4fs/generator/texture.py b/maps4fs/generator/texture.py
index 9f7e5798..99351072 100644
--- a/maps4fs/generator/texture.py
+++ b/maps4fs/generator/texture.py
@@ -5,7 +5,6 @@
 import json
 import os
 import re
-import shutil
 from collections import defaultdict
 from typing import Any, Callable, Generator, Optional