Merge branch 'Development' of https://github.com/sideeffects/GameDevelopmentToolset into Development

Author: lkruel

Help/nodes/sop/gamedev--sop_terrain_layer_export.txt

@@ -0,0 +1,50 @@
+= GameDev Terrain Layer Export =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_terrain_layer_export
+#icon: terrainlayerexport
+#tags: tech, model
+
+""" The terrain layer export SOP exports a heightfield with the correct settings for Unreal. """
+
+The terrain layer export SOP exports a heightfield with the correct settings for Unreal. It does so by properly orienting the heightfield prior to export, and also remaps it into the expected range (0-256).
+This tool is designed to work together with Terrain Layer Import.
+
+@parameters
+    == Export ==
+    Save to Disk:
+        This will export the heightfield to disk.
+    Host:
+        This allows you to specify if the tool is being used to export a heightfield from Houdini, or Houdini Engine. This is important to have correct in order to prevent rotated heightmaps. The tool should automatically detect what the host is, but its recommended to confirm manually.
+    Layer Prefix:
+        This is the prefix used for exporting the heightfield maps.
+    Heightmap Name:
+        The name used for the heightmap.
+    Export Folder:
+        This is the folder on disk that the extracted maps will be exported to.
+    == Tiling ==
+    Divide into tiled maps:
+        This enables/disables the exporting of maps as tiled maps.
+    Tile Method:
+        This controls how the heightfield will be cut up into tiles. Either based on size, or on absolute number of chunks.
+    Tile Size:
+        When Tile Method is set to Tile Size, this controls the resolution used for cutting up the heightfield into tiles.
+    Number of Tiles:
+        When Tile Method is set to Number of Tiles, this controls the number of tiles the heightfield will be cut up into.
+    Tile Overlap:
+        This controls the number of shared voxels that will overlap on the tile borders.
+    File Naming:
+        Determines the file naming used for each tile. Either based on UDIM, UV Tile, Frames or XY Tile.
+    UDIM Stride:
+        Limits the maximum number of UDIM stride width used.
+    Pad Tile Numbers:
+        The padding used for tile numbers.
+    == Layers ==
+    Export All Layers:
+        Enables/Disabled the exporting of all maps as opposed to filtering them using the "Export Layers" multiparm.
+    Export Layers:
+        Allows you to manually specify which layers you want to export.
+    Name:
+	This allows you to specify the name used of the heightfield primitive that has to be exported.
+    

Help/nodes/sop/gamedev--sop_terrain_layer_import.txt

@@ -0,0 +1,25 @@
+= GameDev Terrain Layer Import =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_terrain_layer_import
+#icon: terrainlayerimport
+#tags: tech, model
+
+""" The terrain layer import SOP exports a heightfield with the correct settings from Unreal. """
+
+The terrain layer export SOP imports a heightfield with the correct settings from Unreal. It does so by properly orienting the heightmap prior to import, and also remaps it into the expected range (0-256).
+This tool is designed to work together with Terrain Layer Export.
+
+@parameters
+    Reimport from Disk:
+        This button triggers a reimport of the files from disk.
+    Heightmap:
+        This is a path pointing to the heightmap you want to import.
+    Import Layers:
+        This multiparm allows you to specify how many mask layers you want to import in addition to height. (Ex flowmap, debris, etc)
+    Name:
+        The name of the imported mask data. This will be used to name the generated heightfield primitive.
+    Image:
+       This points to the mask you want to import.
+    

Help/nodes/sop/gamedev--sop_unreal_pivotpainter.txt

@@ -0,0 +1,46 @@
+= GameDev Unreal Pivot Painter =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_unreal_pivotpainter
+#icon: pivotpainter
+#tags: tech, model, gamedev
+
+""" Pivot Painter is a SOP that stores model pivot and rotation information in the model's vertex data and additional UV channels. """
+
+Pivot Painter is a SOP that stores model pivot and rotation information in the model's vertex data and additional UV channels. That information can then be referenced inside of Unreal's shader system to create interactive effects.
+This tool is specifically built to work with the material functions provided by Epic Games in Unreal Engine. It is however possible to use this encoded information in other engines such as Unity, since it uses common attributes.
+[https://docs.unrealengine.com/en-US/Engine/Content/Tools/PivotPainter/index.html]
+
+@parameters
+    Data Packing Method:
+        This menu determines if the tool should encode PivotPainter information in the default way, or based on a custom configuration.
+    Layout Lightmap UVs:
+        This forces the tool to automatically generate Lightmap UVs based on the primary UVs.
+    UV Padding:
+        This controls the padding applied to the Lightmap UVs while they are laid out.
+    == Per Object ==
+    Pivot Position:
+        The attribute components used to encode Pivot Position.
+    Forward Axis:
+        The attribute components used to encode the Forward Axis.
+    Random Value:
+        The attribute component used to encode a random value.
+    Motion Mask:
+        The attribute component used to encode the Motion Mask.
+    == Hierarchical ==
+    Leaf Pivot Position:
+        The attribute components used to encode the Leaf Pivot Position.
+    Branch Pivot Position:
+        The attribute components used to encode the Branch Pivot Position.
+    Branch Angle:
+        The attribute components used to encode the Branch Angle.
+    Use Mask:
+        This toggle enables/disables the use of vertex colors for the motion mask of the object.
+    Input Data:
+        This menu allows you to control if you want the tool to try and generate pivot positions, or if you want to use your own.
+    Branches Group:
+        The primitive group containing the branches geometry.
+    Leaves Group:
+        The primitive group containing the leaves geometry.
+