Material Tool: Difference between revisions

From Resonite Wiki
m Added special options of the material tool
m page was using a page title instead of heading
 
(3 intermediate revisions by 2 users not shown)
Line 3: Line 3:
The '''Material Tool''' is a [[Tools|Tool]] for manipulating [[Material|Materials]].
The '''Material Tool''' is a [[Tools|Tool]] for manipulating [[Material|Materials]].


= Usage =
== Usage ==
 
== Primary ==


=== Primary ===
With a material orb in the tool, pulling the trigger will apply the material to whatever you're pointing at. If the target has multiple materials, only the first material is affected.
With a material orb in the tool, pulling the trigger will apply the material to whatever you're pointing at. If the target has multiple materials, only the first material is affected.


== Secondary ==
=== Secondary ===
 
If the tool is empty, pressing secondary will create a material orb based on the first material of the target object and automatically place it into the tool.
If the tool is empty, pressing secondary will create a material orb based on the first material of the target object and automatically place it into the tool.


== Grab ==
=== Grab ===
 
Grabbing at the tool while it has a material orb in it will pull it out of the tool.
Grabbing at the tool while it has a material orb in it will pull it out of the tool.


Line 21: Line 18:
== Context Menu ==
== Context Menu ==
[[File:Material Tool Context Menu (Empty).png|thumb|400x400px|Context menu for the material tool without a material orb in it|alt=Context menu without any materials selected, only showing the "Create new" button for the tool, having a green orb and plus icon]]
[[File:Material Tool Context Menu (Empty).png|thumb|400x400px|Context menu for the material tool without a material orb in it|alt=Context menu without any materials selected, only showing the "Create new" button for the tool, having a green orb and plus icon]]
[[File:Material Tool Context Menu (Full).png|thumb|400x400px|Context menu for the material tool with a material orb in it|alt=Context menu with a material selected, showing new options such as "Conver to", having an orange orb and arrow icon; "Edit material" having a white orb in an inspector window icon and "Create copy" having a blue orb and green copy icon]]
[[File:Material Tool Context Menu (Full).png|thumb|400x400px|Context menu for the material tool with a material orb in it|alt=Context menu with a material selected, showing new options such as "Conver to", having an orange orb and arrow icon; "Edit material" having a white orb in an inspector window icon and "Create copy" having a blue orb and green copy icon]]
If the tool is empty, you can only create a new material.
If the tool is empty, you can only create a new material.


With a material orb stored in the tool, you can also duplicate the material or pull up an inspector window to edit it. You can also convert the material into another type of material, producing a new material orb in front of the tool and replacing all instances of the original material. There is also an eject orb button to clear the Material Tool's current material, useful for desktop users.
With a material orb stored in the tool, you can do the following actions in your [[Context menu|context menu]]:
* Duplicate the material (Create Copy)
* Pull up an inspector window to edit the material (Edit Material).
* Convert the material into another type of material, producing a new material orb in front of the tool and replacing all instances of the original material.
* There is an eject orb button to clear the Material Tool's current material, useful for desktop users.


== Advanced Features ==


== Special Actions ==
* <translate>You can pull materials out of fields by holding the contents of the field, then while holding it, pressing primary.</translate>


* <translate>While this tool is equipped, you can also pull materials out of fields by grabbing the field and then while holding it pressing secondary.</translate>
* <translate>While holding a slot with the material tool equipped, then pressing secondary, all referenced materials in the hierarchy will be spawned.</translate>


* <translate>If you grab a slot and then open the context menu while holding the slot reference, you will get an option to ''Convert All to...'' which allows you to convert every single material underneath that slot to a new type.</translate>
* <translate>If you grab a slot and then open the context menu while holding the slot reference, you will get an option to ''Convert All to...'' which allows you to convert every single material underneath that slot to a new type.</translate>

Latest revision as of 23:22, 5 July 2024

Material tool being a transparent orb on top of a small spray paint gun
The Material Tool

The Material Tool is a Tool for manipulating Materials.

Usage

Primary

With a material orb in the tool, pulling the trigger will apply the material to whatever you're pointing at. If the target has multiple materials, only the first material is affected.

Secondary

If the tool is empty, pressing secondary will create a material orb based on the first material of the target object and automatically place it into the tool.

Grab

Grabbing at the tool while it has a material orb in it will pull it out of the tool.

Releasing a material orb on top of an empty material tool will put it into the tool.

Context Menu

Context menu without any materials selected, only showing the "Create new" button for the tool, having a green orb and plus icon
Context menu for the material tool without a material orb in it
Context menu with a material selected, showing new options such as "Conver to", having an orange orb and arrow icon; "Edit material" having a white orb in an inspector window icon and "Create copy" having a blue orb and green copy icon
Context menu for the material tool with a material orb in it

If the tool is empty, you can only create a new material.

With a material orb stored in the tool, you can do the following actions in your context menu:

  • Duplicate the material (Create Copy)
  • Pull up an inspector window to edit the material (Edit Material).
  • Convert the material into another type of material, producing a new material orb in front of the tool and replacing all instances of the original material.
  • There is an eject orb button to clear the Material Tool's current material, useful for desktop users.

Advanced Features

  • You can pull materials out of fields by holding the contents of the field, then while holding it, pressing primary.
  • While holding a slot with the material tool equipped, then pressing secondary, all referenced materials in the hierarchy will be spawned.
  • If you grab a slot and then open the context menu while holding the slot reference, you will get an option to Convert All to... which allows you to convert every single material underneath that slot to a new type.