These example textures can be used for any purpose and in any combination 
for static and animated displacement within Sansars material editor.

The displacement in Sansar uses "Red, Green, Blue" or "RGB" to define each direction in 3D space.


Displacement Map:
- Red = X axis direction
- Green = Y axis direction
- Blue = Z axis direction
- White = All directions in the positive
- Black = No displacement

Displacement Factor:
- functional as a black and white mask, black being full strength and white being no 
  displacement


While in world edit:


1.
- Right click the object you want to add displacement to.
- You should see a pop-up menu appear, choose "Materials..." 
  alternately you can use the short-cut "Ctrl + M" while your object is selected.

2.
- Select the shader you would like to use in the top right drop down menu.
- Make sure the shader you are using supports displacement by scrolling 
  down to see if it has the right texture map drop down menus:
- Displacement Map 
- Displacement Factor
- See "TextureSettings" screenshot that is provided in the folder for reference.

3.
- "Displacement Map menu"
- Add any texture you like into the "Displacement Map" menu to see your object displace.
- White in this Displacement Map menu acts as full strength, while black acts as zero strength.
- The displacement may initially be quite strong and distorted but can be adjusted further down
  the shader under "Displacement Scale".

- (Optional)
- "Displacement Factor menu"
- You can use the second menu "Displacement Factor" as a simple black and white mask.
- Black in this Displacement Factor menu acts as full strength, while white acts as zero strength, 
  the inverse to the Displacement Map menu. 
- Example: The gradient textures included in this pack will go from white (masked out) 
  to black (full strength displacement)

- All values in between black and white act as a sliding scale between the two values
  which determine the level of displacement strength. 

4.

- Scroll down until you see "Displacement Scale" 
- This is where you can have greater control over the strength and turn on or off each direction.
- To turn off a direction, type in 0 when using black and white texture maps.
- I recommend trying values like 0.5 or 0.05 to get more subtle or toned down results. 


5.

- Scroll down and find the "Displacement in LocalSpace" tick box, you toggle this on and off
  to see which result is preferable for your needs. 


6. (Optional)

- For simple UV scrolling displacement animations, check out "TextureSettings2" screenshot
  I have provided in the folder for reference.
- More advanced flipbook (sprite sheet) animation is also possible for those who are familiar
  with this functionality in sansar.