Rasagar/Library/PackageCache/com.unity.probuilder/Documentation~/toolbar.md
2024-08-26 23:07:20 +03:00

63 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# The ProBuilder toolbar
You can open the **ProBuilder** toolbar from Unitys top menu: __Tools__ > __ProBuilder__ > __ProBuilder Window__.
![The ProBuilder toolbar, displaying text buttons in a dockable container](images/toolbar_main.png)
When you open the main **ProBuilder** toolbar, the [Edit mode toolbar](edit-mode-toolbar.md) also opens in the active Scene view, where you can see and change the [current editing mode](modes.md).
Use the **ProBuilder** toolbar to access Editor windows, selection, creation, and editing tools for Meshes.
<a name="category"></a>
## Tool categories
The ProBuilder toolbar is color-coded to help you quickly choose tools by type:
* **Orange** to access [tools and windows](tool-panels.md)
* **Blue** to access [selection actions](selection-tools.md)
* **Green** for [Object actions](object-actions.md)
* **Red** for Element actions (on [Vertex](vertex.md), [Edge](edge.md), and [Face](face.md) geometry)
![Toolbar Categories Example](images/ExampleImage_Toolbar_ColorCategories.png)
### Dynamic layout
The ProBuilder window dynamically changes to match your current edit mode and element selection:
* Buttons only appear if you can use them with your [current edit mode](modes.md).
* Buttons are disabled if you cannot use them on the current selection.
<a name="buttonmode"></a>
### Toolbar display modes
The ProBuilder toolbar displays buttons as either text or icons.
![Text mode and Icon mode](images/toolbar_text_v_icon.png)
> **Tip:** By default, the toolbar appears in Text mode, but you can switch to Icon mode instead. You can also resize the toolbar and switch between making it floating and dockable. See [Customizing ProBuilder](customizing.md#toolbar) for details.
<a name="pb_options"></a>
### Options for ProBuilder tools
Some actions (such as [Extrude](Face_Extrude.md), [Collapse](Vert_Collapse.md), and [Grow Selection](Selection_Grow.md)) also have extra options or custom settings, which can change how ProBuilder performs the action by default. If there are options available for an action, an indicator appears in the top-right corner of the button which allows you to access the **Options** window:
* In **Icon Mode**, the gear ![Options Icon](images/icons/Options.png) indicator appears next to an action button if there are options available. To open the **Options** window, **Alt+Click** anywhere on the button.
* In **Text Mode**, the `+` icon appears on the right side of an action button if there are options available. To open the **Options** window, click on the button's `+` icon.
> **Caution:** When you change one of these options, those changes become the default settings for that action in the scene until you change them again.
![Options for Select Material tool](images/pb_options.png)
For example, the [Select by Material](Selection_SelectByMaterial.md) action allows you to specify whether ProBuilder limits the new selection to match only faces on the currently selected object or faces on any object in the scene.
> **Note:** The documentation for each action includes information about any options.