UNI-9224: Updates before next build

amylouise@unity3d.com · amylouise@unity3d.com · commit d435362e16f3 · 2021-03-08T15:52:40.000-05:00
- Added SelectPath documentation
- Added a warning about the lag for Experimental Features preference
- Added a warning about the Show Handle Info getting occluded by the Component Editor Tools panel
diff --git a/Documentation~/SelectPath.md b/Documentation~/SelectPath.md
@@ -0,0 +1,15 @@
+# Select Path
+
+Use Select Path to show and select a path from the face underneath the cursor to the selected face on the surface of a Mesh.
+
+![Test various a path to the selected face and then select the path you like.](images/SelectPath.png)
+
+You can move your mouse to test different paths to the selected face and then click to select the path you want to select.
+
+To select a path of faces:
+
+1. In [Face mode](modes.md), select the face you want to build a path to.
+2. Hold both **Ctrl/Cmd** and **Shift** while you move your cursor around to see options for which faces ProBuilder might select. As you move, ProBuilder shows a preview of which faces you can select.
+3. When you see the pattern of faces that you want to select, click in place. ProBuilder grows the selection to include all the faces in that path.
+
+> **Note**: This action is only available with the **Ctrl/Cmd**+**Shift**+**click** shortcut when the [UV Editor window](uv-editor.md) is closed. No menu or toolbar button activates this action, and you can't remap the shortcut.
diff --git a/Documentation~/TableOfContents.md b/Documentation~/TableOfContents.md
@@ -86,6 +86,7 @@
 	* [Select Smoothing Group](Selection_SmoothingGroup)
 	* [Select Hidden](Selection_SelectHidden)
 	* [Select Holes](Selection_SelectHole)
+	* [Select Path](SelectPath)
 	* [Set Collider](Entity_Trigger#Collider)
 	* [Set Pivot - Edges](Edge_SetPivot)
 	* [Set Pivot - Faces](Face_SetPivot)
diff --git a/Documentation~/hotkeys.md b/Documentation~/hotkeys.md
@@ -34,6 +34,7 @@ This page gives an overview of the default ProBuilder keyboard shortcuts. Where
 | **H**                                                        | Cycle through Vertex, Edge, and Face edit modes.             |
 | **Ctrl+Click**                                               | [Align an adjacent face's UV coordinates](manual-uvs-actions.md#continue) to the current selection in the [UV Editor window](uv-editor.md). This action is often called "auto-stitching".<br /><br />**Note**: You cannot remap this shortcut. It is only available while the [UV Editor window](uv-editor.md) is open, even though you can use it in the Scene view.<br /><br />**Important:** Unlike many other shortcut combinations involving the **Ctrl** key in Windows and the **Cmd** key in macOS, this action works with only the **Ctrl** key for both platforms. |
 | **Ctrl+Shift+Click**                                         | [Copy one face's UVs to the other faces](manual-uvs-actions.md#copy-uvs) in the current selection.<br /><br />**Note**: You cannot remap this shortcut. It is only available while the [UV Editor window](uv-editor.md) is open, even though you can use it in the Scene view.<br /><br />**Important:** Unlike many other shortcut combinations involving the **Ctrl** key in Windows and the **Cmd** key in macOS, this action works with only the **Ctrl** key for both platforms. |
+| **Ctrl/Cmd+Shift+Click**                                     | [Select all faces in a path](SelectPath.md) between the current cursor position and the selected face(s).<br /><br />**Note**: You cannot remap this shortcut, and it is only available in the Scene view when the [UV Editor window](uv-editor.md) is closed. |
 | <a name="uv-snap"></a>**Ctrl/Cmd+Drag** (while moving, rotating, or scaling) | Snap to UV increments in the [UV Editor window](uv-editor.md). |
 | **Ctrl/Cmd+E**                                               | Extrude [edges](Edge_Extrude.md) and [faces](Face_Extrude.md) using the default options. |
 | **Ctrl/Cmd+J**                                               | Move the pivot to the center of the currently selected elements: <br /> - [Vertices](Vert_SetPivot.md)<br /> - [Edges](Edge_SetPivot.md)<br /> - [Faces](Face_SetPivot.md) |
diff --git a/Documentation~/images/SelectPath.png b/Documentation~/images/SelectPath.png
diff --git a/Documentation~/preferences.md b/Documentation~/preferences.md
@@ -54,11 +54,9 @@ Use these settings to enable and disable ProBuilder experimental features.
 | __Experimental Features Enabled__ | Enable this option to access the [New Bezier Shape](bezier.md) experimental feature in the ProBuilder toolbar, and the __Store Mesh as Asset__ option. <br /><br />**Note:** This setting has no affect on access to the [Boolean (CSG) Tool](boolean.md), which is always available from the [Experimental menu](menu-experimental.md). |
 | __Meshes Are Assets__             | Enable this option to store Mesh information in the Project instead of in each separate Scene level. |
 
-<!--
+> **Note**: When you toggle Experimental Features on or off, Unity has to recompile scripts because the changes add or remove functionality in Unity. This means that there is a delay before this option appears to change.
 
-<span style="color:red"> @TODO: Follow up with this... Turning on and off the __Experimental Features Enabled__ option is an odd experience: it seems like you have to click twice to get it to work, but that's just because it's very "laggy". It often doesn't seem like it's turning on, but then after 20+ sec it works, but in the meantime I've tried again so sometimes the net result is just turning it off. </span>
 
--->
 
 
 
@@ -75,7 +73,7 @@ Use these properties to set some basic options for ProBuilder.
 |__Show Action Notifications__ |Enable this option if you want ProBuilder to notify you when performing actions. |
 |<a name="autouvs"></a>__Auto Lightmap UVs__ |Enable this option to generate the UV2 channel after every geometry edit. This means you don't have to manually generate them every time the Mesh changes.<br/><br/>UV2 channel generation for Meshes is necessary for lighting, but can be time-consuming. If you are editing objects with large numbers of vertices, disable this to save resources. |
 |__Show Missing Lightmap UVs Warning__ |Enable this option to show a warning in the console if ProBuilder shapes are missing a valid UV2 channel when Unity performs a lightmap bake. |
-|__Show Handle Info__ |Enable this option to show the information for moving, rotating, and scaling deltas. <br /><br /><!-- <span style="color:red">@TODO: Follow up with where this information is supposed to app.?</span> --> |
+|__Show Handle Info__ |Enable this option to display the information for moving, rotating, and scaling deltas in the bottom right of the Scene view. <br /><br />**Note**: If you have the [Component Editor **Tools** panel](https://docs.unity3d.com/Manual/UsingCustomEditorTools.html#ToolModesAccessSceneViewPanel) open in the Scene view, it covers this information. Close the panel to display the information. |
 |<a name="info_overlay"></a>__Show Scene Info__ |Enable this option to display the Mesh information overlay in the top left of the Scene view. These details include overall face, vertex and triangle counts, and the number of elements currently selected:<br />![Scene information overlay](images/info_overlay.png) |
 |__Script Stripping__ |Enable this option to automatically remove the extra data ProBuilder stores in a Scene. This includes all ProBuilder scripts, so if you are using the runtime API you should disable this feature. |
 
diff --git a/Documentation~/whats-new.md b/Documentation~/whats-new.md
@@ -9,6 +9,7 @@ The main updates in this release include:
 * ProBuilder now supports a special modal "tool" mode for some features (the new [Cut tool](cut-tool.md), and the refactored [Shape](shape-tool.md) and [Poly Shape](polyshape.md) tools). Because of these changes, the other features that have a more immediate effect haven been rebranded "actions". For more information, see [Tools vs. actions](tools.md).
 * Added a new [Cut](cut-tool.md) tool which allows you to add points on an existing face to define a new sub-face.
 * Added a new [Selection X-Ray](preferences.md#sel-xray) option to highlight hidden element selections with a muted color. The default shortcut is **Ctrl/Alt+Shift+X** (modifiable in the Shortcuts Manager), and you can also access it through the ProBuilder menu (**Tools** > **ProBuilder** > **Interaction** > **Toggle X Ray**).
+* Added a new preview selection for the [Select Path](SelectPath.md) action.
 
 ### Updated
 
@@ -22,8 +23,3 @@ The main updates in this release include:
 
 For a full list of changes and updates in this version, see the [ProBuilder package changelog](../changelog/CHANGELOG.html).
 
-<!-- 
-
-<span style="color:red">@TODO: SelectPath documentation </span> 
-
--->
