[UPDATE] Gamedev Group SOP Documentation

Author: lkruel

Help/icons/group_corners.svg

@@ -0,0 +1,23 @@
+= GameDev Group Attribute Borders =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_attribute_borders
+#icon: SOP/groupcreate
+#tags: tech, model, gamedev
+
+""" Creates an Edge Group at the boundaries of an attribute """
+
+Creates an Edge Group at the boundaries of an attribute. 
+
+NOTE: 
+    This node will likely be deprecated in Houdini 18.0 due to built in functionality.
+
+@parameters
+    Attribute:
+        Attribute whose boundaries we want to detect    
+    Attribute Type:
+        What type of geometry component does this attribute reside in
+    Group Name:
+        Output name for the new group
+    

Help/icons/group_uv_border.svg

@@ -0,0 +1,29 @@
+= GameDev Group by Attribute =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_by_attribute
+#icon: SOP/groupcreate
+#tags: tech, model, gamedev
+
+""" Converts Attributes to Groups """
+
+Generated Groups based on Attribute Values. 
+
+Handy for grouping things based on materials, or other attributes. 
+
+NOTE: 
+    The generated Group Name is actually the value of the attribute, not the attribute name. 
+    
+    
+NOTE: 
+    This has similar functionality to the [Partition SOP|Node:SOP/partition] but without having to deal with expressions. 
+
+@parameters
+    Attribute Type:
+        Component Type for this attribute
+    Attribute Name:
+        Name of the Attribute that we would like to use to generate groups from
+    Group Prefix:
+        Prefix to cluster the group names together. Like mat_ or col_ 
+    

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

@@ -0,0 +1,22 @@
+= GameDev Group By Color =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_by_color
+#icon: VIEW/show_group_colors
+#tags: tech, model, gamedev
+
+""" Creates a group based on Point Colors """
+
+This node groups points based on Point Colors, with an interface similar to a colorkey, where you select your main color and a fuzzyness threshold. 
+
+@parameters
+    Group Type:
+        Where is the Cd Attribute?
+    Group Name:
+        What the output group should be called 
+    Color:
+        Key Color to select
+    Threshold:
+        Fuzzyness factor around the color 
+    

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

@@ -0,0 +1,22 @@
+= GameDev Group Curve Corners =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_curve_corners
+#icon: group_corners
+#tags: tech, model, gamedev
+
+""" Creates Groups for Inside and Outside corner points """
+
+Utility node to detect the angles on curves and isolate corners on a polyCurve. 
+
+Handy in worldbuilding use cases, where you might want to drop a different model for an inside angle vs an outside angle. 
+
+@parameters
+    Inside Group Name:
+        Generate a group for inside corners 
+    Outside Group Name:
+        Generate a group from outside corners
+    Add Direction Normal:
+        exports a Normal attribute which is the direction between 2 points. 
+    

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

@@ -0,0 +1,27 @@
+= GameDev Group Edge Loop =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_edge_loop
+#icon: SHELF/edgeloop
+#tags: tech, model
+
+""" Converts an Edge Group to the respective loops """
+
+This node takes in a mesh with an Edge group as an input, and expands the edge group into the respective edge loops. 
+
+The Edge Group should have at least *two edges*, to determine the direction of the loop. 
+
+TIP:
+    If *two parallel edges* are provided the SOP will return an edge ring instead. 
+
+@parameters
+    Group:
+        Edge Group to be modified   
+    Override Name:
+        Toggle if a new group should be created instead of modifying the input group
+    New Name:
+        If Override Name is toggled, this describes the name of the new group
+    Step:
+        This generates a pattern on the Loop. Number of edges to skip in between each selected edge. 
+    

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

@@ -0,0 +1,23 @@
+= GameDev Group Expand =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_expand
+#icon: CHOP/joystick
+#tags: tech, model, gamedev 
+
+""" Grows or Shrinks a Group Selection """
+
+This node will modify an input group by expanding or contracting it's size. 
+
+This is usually accomplished by converting the group to primitives and back to points, but the setup to do this on a loop is not trivial. 
+
+NOTE: 
+    This node will likely be deprecated in Houdini 18.0 due to built in functionality.
+
+@parameters
+    Group:
+        Group to modify
+    Iterations:
+        How many times to grow or shrink. Positive values expand, negative values contract. 
+    

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

@@ -0,0 +1,23 @@
+= GameDev Group UV Borders =
+
+#type: node
+#context: sop
+#internal: gamedev::sop_group_uv_borders
+#icon: group_uv_borders
+#tags: tech, model, gamedev
+
+""" Creates an Edge Group at the boundaries of the UV attribute """
+
+Creates an Edge Group based on the UV Seams. 
+
+NOTE: 
+    This node will likely be deprecated in Houdini 18.0 due to built in functionality.
+
+@parameters
+    UV Attribute:
+        UV Attribute name 
+    Group Name:
+        Generated group name 
+    Fast Mode:
+        Fast Mode ignores boundaries caused by folded UVs and only looks for disconnected UVs
+    

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

@@ -10,5 +10,5 @@ Inputs:       1 to 1
 Subnet:       true
 Python:       false
 Empty:        false
-Modified:     Thu Sep 20 14:46:19 2018
+Modified:     Tue Oct 22 11:06:26 2019