Difference between revisions of "Decal painter panel"

From Divinity Engine Wiki
Jump to: navigation, search
(Components)
m (Protected "Decal painter panel" ([Edit=⧼protect-level-larianeditonly⧽] (indefinite) [Move=⧼protect-level-larianeditonly⧽] (indefinite)))
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[File:DecalPainterPanel_Example.png|center]]
 +
 
__FORCETOC__
 
__FORCETOC__
 
== Description ==
 
== Description ==
Line 5: Line 7:
  
 
The Decal Painter Panel is a panel which allows you to paint decals. <br />
 
The Decal Painter Panel is a panel which allows you to paint decals. <br />
Look at it like placing sticker in the world, except that any material is allowed. Ranging from blood to rainbows.<br />
+
Look at it like placing stickers in the world, except that any material is allowed. Ranging from blood to rainbows.<br />
 
Painted decals are most commonly used for making common things like walls and floors unique by painting blood, graffiti, broken tiles,...<br />
 
Painted decals are most commonly used for making common things like walls and floors unique by painting blood, graffiti, broken tiles,...<br />
  
  
 
To use the Decal Painter Panel:
 
To use the Decal Painter Panel:
# [[#Import New Visual|Import a visual]]
+
# [[#Materials|Import a material]]
# Select it in the [[#Visual List|Visual List]]
+
# Select it in the from the set list
# Enable the [[#Paint|Paint]] interaction mode
+
# Enable the paint interaction mode
 
# Begin painting!
 
# Begin painting!
  
Line 24: Line 26:
 
The Instance Painter Panel consists of the following components:
 
The Instance Painter Panel consists of the following components:
 
# Save/Load
 
# Save/Load
# [[#Menu|Menu]]
+
# Show/Hide painted decals
# [[#Visual List|Visual list]]
+
# Paint interaction mode
# [[#Interaction Modes|Interaction modes]]
+
# Set of currently loaded decal materials
# [[#Visual Properties|Visual properties]]
+
# [[#Materials|Material options]]
# [[#Tools|Tools]]
+
# [[#Material set|Material set options]]
 +
# [[#Painter settings|Painter settings]]
 +
# [[#Material replacing tool|Material replacing tool]]
 +
# Memory statistics
  
 
<br />
 
<br />
=== Menu ===
+
=== Materials===
[[File:InstancePainterPanel_Menu_StepByStep.png|none]]
 
<sub>The menu with each button numbered</sub>
 
  
 +
Use the [[File:Import.png|30px]] button to import the currently selected material from the resource browser.<br />
 +
Use the delete button ([[File:Delete.png|30px]]) to remove the current selection from the panel.
  
The Menu , left to right, consists of:
+
=== Material sets ===
# [[#Import New Visual|Import New Visual]]
 
# [[#Delete Visual|Delete Visual]]
 
# [[#Swap Visual|Swap Visual]]
 
# Set Burn Visual
 
# Set Destroy Visual
 
# Toggle Shadow on Visual (turns shadows on the selected visual on/off)
 
# Toggle Visibility of Visual (turns visibility of the selected visual on/off)
 
  
<br />
+
You can store the current set of loaded materials as a decal material set.<br />
==== Import New Visual ====
+
This way, you can easily load the same set again when you often work with the same materials.<br />
<sub>This article refers to the image linked under [[#Menu|Menu]]
+
Use the [[File:Import.png|30px]] button to import a material set from the resource browser.
  
 +
{| class="wikitable"
 +
|-
 +
|More info on resources can be found here: [[Resources explanation]]
 +
|-
 +
|}
  
To import a new visual to the Instance Painter panel:
+
{| class="wikitable"
# Open the [[Content browser|Content Browser]]
+
|-
# (Optional) Filter by visuals
+
|For more on the content browser, look here: [[Content browser]]
# Select the visual you want to import to the Instance Painter
+
|-
# Click the "Import New Visual" button <span style="color:#FCFF27">(1)</span>
+
|}
  
<br />
+
=== Painter settings ===
==== Delete Visual ====
 
<sub>This article refers to the image linked under [[#Menu|Menu]]
 
  
 +
The following settings can be changed for the painter:
 +
* '''Random size''': Enable to randomly change the decal size after every paint. (Size limited between the set minimum/maximum)
 +
* '''Random rotation''': Enable to randomly change the decal rotation after every paint. (Rotation limited between the set minimum/maximum)
 +
* '''Rotation stepsize''': Size of change when using the shortcuts to rotate the painter. The default shortcuts for this are '-' and '+'.
 +
* '''Size stepsize''': Size of change when using the shortcuts to scale the painter. The default shortcuts for this are '[' and ']'.
 +
* '''Decal oriantation''': Choose the orientation of the decal while painting
 +
** '''Surface average''': Place the decal according to the average orientation of the target surface
 +
** '''Decal center''': Place the decal according to the target surface orientation at the decal center
 +
** '''Camera''': While painting, the decal will be facing the camera.
  
To delete a visual from the Instance Painter panel:
+
=== Material replacing tool ===
# Select the visual in the [[#Visual List|Visual List]]
 
# Click the "Delete Visual" button <span style="color:#FCFF27">(2)</span> <sup>[1]</sup>
 
 
 
 
 
<sup>[1] Note when deleting a visual from the Instance Painter, all the painted visuals of that type in your level will disappear</sup>
 
 
 
<br />
 
==== Swap Visual ====
 
<sub>This article refers to the image linked under [[#Menu|Menu]]
 
 
 
 
 
To swap a visual in the Instance Painter panel:
 
# Select the visual you want to replace in the [[#Visual List|Visual List]]
 
# Open the [[Content browser|Content Browser]]
 
# (Optional) Filter by visuals
 
# Select the visual you want to replace your old visual with
 
# Click the "Swap Visual" button <span style="color:#FCFF27">(3)</span> <sup>[1]</sup>
 
 
 
 
 
<sup>[1] Note when swapping a visual in the Instance Painter, all the painted visuals of that type in your level will be replaced as well</sup>
 
 
 
<br />
 
=== Visual List ===
 
[[File:InstancePainterPanel_VisualList_StepByStep.png|none]]
 
<sub>The visual list with each component numbered</sub>
 
 
 
 
 
The Visual List shows all visuals that are currently imported into the Instance Painter.
 
 
 
The Visual List is also used to select visuals to paint or modify.
 
 
 
The Visual List consists of:
 
# Show Visual toggle, will show or hide all instance visuals of this type (see [[#Menu|Menu #6]])
 
# Shadow Visibility toggle, will show or hide the shadows of all instance visuals of this type (see [[#Menu|Menu #5]])
 
# The name of the visual
 
 
 
<br />
 
=== Interaction Modes ===
 
[[File:InstancePainterPanel_InteractionModes_StepByStep.png|none]]
 
<sub>The instaction modes with each component numbered</sub>
 
 
 
 
 
The [[Interaction Modes|interaction modes]], from left to right, consist of:
 
# Checkout Cells
 
# [[#Paint|Paint]]
 
# Align
 
# Update
 
# A toggle to turn on terrain-only picking
 
#* When turned on, your paint brush will paint only on the terrain
 
#* When turned off, your paint brush will paint on [[Scenery|scenery]] as well
 
# A slider to set the radius of your paint brush
 
 
 
<br />
 
==== Paint ====
 
<sub>This article refers to the image linked under [[#Interaction Modes|Interaction Modes]]
 
 
 
 
 
The paint [[Interaction Modes|interaction mode]] works the same as other brush-based interaction modes (such as the terrain- and ai grid paint tools). To activate it, toggle the Paint button. Then, with a visual selected in the [[#Visual List|visual list]], start painting in the Game Render View (default LMB).
 
 
 
To resize the paint brush, use the slider <span style="color:#FCFF27>(6)</span> or use the '[' and ']' (default) keybinds.
 
 
 
<br />
 
=== Visual Properties ===
 
[[File:InstancePainterPanel_Properties_StepByStep.png|none]]
 
<sub>The properties section with each component numbered</sub>
 
 
 
 
 
The instance visual property grid consists of the following:
 
# Instance Visual Group, which contains all the visual Ids and the FileId (which is used as the file name)
 
# The Paint Properties, which contains:
 
## AlignNormal
 
## Flow
 
## RandomRotX, whether to rotate painted visuals randomly around the X axis when painting with "Randomize Rotation" toggled (see [[#Tools|Tools]])
 
## RandomRotY, whether to rotate painted visuals randomly around the Y Axis when painting with "Randomize Rotation" toggled (see [[#Tools|Tools]])
 
## RandomRotZ, whether to rotate painted visuals randomly around the Z Axis when painting with "Randomize Rotation" toggled (see [[#Tools|Tools]])
 
## ScaleMax, the maximum scale when painting with "Randomize Scale" toggled (see [[#Tools|Tools]])
 
## ScaleMin, the minumum scale when painting with "Randomize Scale" toggled (see [[#Tools|Tools]])
 
 
 
<br />
 
=== Tools ===
 
[[File:InstancePainterPanel_Tools_StepByStep.png|none]]
 
<sub>The tools section with each component numbered</sub>
 
 
 
  
The Tools section consists of:
+
Use this to replace all decals of a certain material in the level with another material.<br />
# "Remove Floating", will automatically remove all floating visuals up to a certain height
+
Simply import both materials into the designated field with the [[File:Import.png|30px]] button and press "Replace".
# "Remove Duplicated", will automatically remove all visuals within a certain distance of each other
 
# ReAlign, when toggled the [[#Interaction Modes|"Align" interaction mode]] will realign instances in accordance to the [[#Visual Properties|paint properties]]
 
# Randomize Rotation, when toggled will randomize the rotation of instances painted with [[#Paint|the paint interaction mode]] in accordance to the [[#Visual Properties|paint properties]]
 
# Randomize Scale, when toggled will randomize the scale of instances painted with the [[#Paint|the paint interaction mode]] in accordance to the [[#Visual Properties|paint properties]]
 
# Visualize Batches, will outline boxes around each batch in the grid (a batch is a set of instances in a 64x64 meter grid cell)
 
  
 
<br />
 
<br />

Latest revision as of 12:39, 2 October 2017

DecalPainterPanel Example.png


Description

This article refers to the image linked under Components


The Decal Painter Panel is a panel which allows you to paint decals.
Look at it like placing stickers in the world, except that any material is allowed. Ranging from blood to rainbows.
Painted decals are most commonly used for making common things like walls and floors unique by painting blood, graffiti, broken tiles,...


To use the Decal Painter Panel:

  1. Import a material
  2. Select it in the from the set list
  3. Enable the paint interaction mode
  4. Begin painting!


Components

DecalPainterPanel StepByStep.png

The Decal Painter Panel with each component numbered


The Instance Painter Panel consists of the following components:

  1. Save/Load
  2. Show/Hide painted decals
  3. Paint interaction mode
  4. Set of currently loaded decal materials
  5. Material options
  6. Material set options
  7. Painter settings
  8. Material replacing tool
  9. Memory statistics


Materials

Use the Import.png button to import the currently selected material from the resource browser.
Use the delete button (Delete.png) to remove the current selection from the panel.

Material sets

You can store the current set of loaded materials as a decal material set.
This way, you can easily load the same set again when you often work with the same materials.
Use the Import.png button to import a material set from the resource browser.

More info on resources can be found here: Resources explanation
For more on the content browser, look here: Content browser

Painter settings

The following settings can be changed for the painter:

  • Random size: Enable to randomly change the decal size after every paint. (Size limited between the set minimum/maximum)
  • Random rotation: Enable to randomly change the decal rotation after every paint. (Rotation limited between the set minimum/maximum)
  • Rotation stepsize: Size of change when using the shortcuts to rotate the painter. The default shortcuts for this are '-' and '+'.
  • Size stepsize: Size of change when using the shortcuts to scale the painter. The default shortcuts for this are '[' and ']'.
  • Decal oriantation: Choose the orientation of the decal while painting
    • Surface average: Place the decal according to the average orientation of the target surface
    • Decal center: Place the decal according to the target surface orientation at the decal center
    • Camera: While painting, the decal will be facing the camera.

Material replacing tool

Use this to replace all decals of a certain material in the level with another material.
Simply import both materials into the designated field with the Import.png button and press "Replace".