Painted mask node

• Adding a Painted mask node
• Editing the mask size
• Painting the mask
• Pen pressure
• Video tutorial
• Parameters

Adding a Painted mask node

With this node, you can paint mask directly in the Viewport and immediately see the results on the terrain. The Painted mask acts like all other masks, but you can edit it in real time as often as you want.

To add a Painted mask node, right-click in the Graph Editor and select Create Node  > Mask Generation  > Painted mask.

Double click on the node to open its parameters:

Editing the mask size

To begin editing the mask, check the Edit mask box:

• Mask size: The mask size is defined by the input mask. To change it, click Change Mask size.

In the dialog, edit the Width, Height, and Quad size of the mask.

• You can keep the current mask or clear it by checking:
  • Clear mask to reset the mask to the default parameters when you change the size.
  • Keep content to preserve the mask content when you change the size.
• Reset the mask by either clicking:
• • Set to black to clear the mask and fill it with zeroes
  • Set to white to clear the mask and fill it with ones
• Copy from mask: When the Painted mask node option connector is linked to an input mask, this option is activated. Clicking on Copy from Mask copies the input mask and displays it in the Viewport.

The input mask does not give its size to the painted mask: if it is not the same size, it is enlarged or reduced when it is copied.
If the input mask changes, the painted mask is not updated automatically. You must click Copy from mask to copy the new input mask. Any modifications that have been painted are lost.

Painting the mask

With the Edit mask button activated, use the brush sliders to change the brush size, intensity, and hardness and draw the mask directly in the Viewport. The mask is updated in real time.

• Select a brush profile. The current profile of the brush is displayed in the right of the window.

The profile is influenced by the hardness of the brush, but neither by size nor by intensity.

For the first profile, here is what we achieve for a low hardness, a medium hardness and a high hardness:

Here is what we achieve for the second profile:

Here is what we achieve for the third profile:

• Lighter allows you to draw the mask and Darker to erase the mask. Press the keyboard shortcut S to toggle between the modes if one of them is already selected.

• Selecting Constant value opens additional options:

• • Value: Enter a value between 0 and 1.
  • Pick: By clicking on the Pick button, you can pick anywhere on the screen, including outside the Instant Terra window.
    If the picked point is not a gray level color, the color is converted to gray level before being converted to a value between 0 and 1.
    The brush paints a value on the mask that corresponds to the selected value.
    For example, if a value of 0.5 is chosen, when painting on the mask, the value obtained is equal to 0.5, regardless of the previous value. If the intensity is equal to 1, the selected value is reached in one stroke of the brush. If the intensity is less than 1, it will take several brush strokes to reach the chosen value with each brush stroke getting closer to the selected value.
    
     
  • Up only and Down only: When the Up only option is checked, the brush only paints where it will make the mask lighter. Press the keyboard shortcut S to toggle between the options.
    
    
    
    Conversely, when the Down only option is checked, the brush only paints where it will make the mask darker.
    
    
  • Use the Size slider to set the size of the brush depending on the level of detail that your mask needs.
  
  • Use the Intensity slider to set the intensity of the color of the brush.
  
• Hardness creates the appearance of translucency. Use the slider to set the attenuation of the intensity of color from the center.

In the Painted mask node, pressing and holding the left mouse button paints the mask. To pan in the mask, you can press and hold the Shift key and the left mouse button, and move the mouse.

Some useful shortcuts:
- S: toggles between the different modes
- D and F: increases or decreases the size
- G and H: increases or decreases the intensity
- J and K: increases or decreases the hardness.

Show terrain / show mask

If a terrain is connected to the mask, the button "Show terrain" is displayed.
Use it to easily toggle between the terrain view and the mask view.