db&w documentation wiki

finest software | finest docs

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 revisionPrevious revision
Next revision
Previous revision
tools:polygon-picker [2020/07/20 13:10] – [Settings] lightwolftools:polygon-picker [2020/07/20 18:02] (current) – [Polygon Picker] lightwolf
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 24: Line 32:
 The panel exposing the settings can be opened using the **n** key any time the tool is active. The settings are stored in the LightWave 3D config directory for the LightWave 3D version you're running. The panel exposing the settings can be opened using the **n** key any time the tool is active. The settings are stored in the LightWave 3D config directory for the LightWave 3D version you're running.
 ==== Left Mouse Button ==== ==== Left Mouse Button ====
 +
 +The tool differentiates between using the left or the right mouse button to select polygon. Using the right mouse button will *always* open the menu featuring all options.
 +
 +The action for the left mouse button can be configured using this setting.
 +
 +  * **Open Menu** Opens the complete menu, just like the right mouse button does.
 +  * **Open Surface Editor** Only display the options to open the Surface Editor using the current selection. If only one surface is selected, the Surface Editor is opened directly.
 +  * **Open Node Graph** Only display the options to open the Node Editor using the current selection. If only one surface is selected, the NodeEditor is opened directly.
 +  * **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.txt · Last modified: 2020/07/20 18:02 by lightwolf