db&w documentation wiki

finest software | finest docs

User Tools

Site Tools


tools:polygon-picker

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
tools:polygon-picker [2020/07/20 13:14]
lightwolf [Left Mouse Button]
tools:polygon-picker [2020/07/20 18:02] (current)
lightwolf [Polygon Picker]
Line 1: Line 1:
 ====== Polygon Picker ====== ====== Polygon Picker ======
  
-Polygon picker allows you to pick a polygon in any of the views in Layout (regardless of the view mode) and then perform actions based on that selection, such as opening the Surface Editor or the Node Graph editor for the surface used by that polygon.+Polygon picker allows you to pick a polygon in any of the views that display meshes in Layout (regardless of the view mode) and then perform actions based on that selection, such as opening the Surface Editor or the Node Graph editor for the surface used by that polygon.
  
 Advanced options allow you to customise is just the first polygon is selected, or all polygons underneath the mouse cursor. Advanced options allow you to customise is just the first polygon is selected, or all polygons underneath the mouse cursor.
Line 15: Line 15:
  
 As with all tools, it has to be **dropped** once you're done with it (the easiest way is to press the space bar). As with all tools, it has to be **dropped** once you're done with it (the easiest way is to press the space bar).
 +
 +<WRAP center round important 80%>
 +**Limitations:** The Polygon Picker can only work on "real" meshes. This excludes any procedural shapes as well as lights, bones, nulls or instances.
 +The Polygon Picker will use the frozen (subdivided) mesh to pick polygons.
 +</WRAP>
 +<WRAP center round alert 80%>
 +**Known issues:** The polygon will currently not be picked properly on items that have their pivot transformed in Layout. This should be fixed for the final release.
 +</WRAP>
  
 ===== Settings ===== ===== Settings =====
Line 34: Line 42:
   * **Open Selection Menu** Only display the item selection options.   * **Open Selection Menu** Only display the item selection options.
 ==== First Polygon Only ==== ==== First Polygon Only ====
 +
 +If this is enabled, only the first polygon that's intersected is displayed in the menu.
 +
 +Combined with the **Open Surface Editor** or **Open Node Graph** option for the left mouse buttons, this allows for performing either of these actions directly, without a pop-up menu opening.
 ==== Deep Mesh Inspection ==== ==== Deep Mesh Inspection ====
  
 This open is only available if **First Polygon Only** is disabled. This open is only available if **First Polygon Only** is disabled.
 +
 +Polygon Picker traces a ray into the scene using the current mouse location. By default, only the first hit polygon per item/mesh is collected.
 +Enabling this option will probe for further polygons within that item/mesh, behind the initial first polygon. 
 ==== Preselection Highlight ==== ==== Preselection Highlight ====
  
 +If this option is enabled, the Polygon Picker will perform as follows:
 +   - The mouse button is pressed in a view.
 +   - As the mouse is dragged over the view, the current front most polygon is highlighted in all views. A crosshair is drawn on the active view.
 +   - Once the mouse button is released, a menu is displayed to perform an action (or the action is performed directly, depending on the settings).
  
 +If it is disabled, the Polygon Picker will perform in a simpler manner:
 +   - When a mouse button is pressed over a view, the scene is probed at that position and a menu is displayed to perform an action (or the action is performed directly, depending on the settings).
  
 +----
 +[[https://www.patreon.com/dbw|{{  ::become_a_patron_button.png?nolink|}}]]
 +This is the plugin of the month for July 2020, made possible by the finest patrons on [[https://www.patreon.com/dbw|Patreon]].
tools/polygon-picker.1595243646.txt.gz · Last modified: 2020/07/20 13:14 by lightwolf