db&w documentation wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Triplanar Mapper ======
{{:tools:triplanar_example.png?nolink|}}

This node maps a single image three times, along each of the major axes (just like cubic mapping) but blends between the three projections depending on the angle of the surface to hide the seams.

This can be used to quickly texture more organic or natural objects without requiring precise UV coordinates.

If you would like to mix arbitrary textures (including procedurals), please look at the [[tools:triplanar_mixer|]].

===== Controls =====

==== Background Colour / Blend Mode / Opacity ====

These are the standard compositing controls as provided by the native 2D mapping nodes as well.

==== Triplanar Blend ====

This controls how hard/soft the blend of the planar projections is as the normals point away from the major axes.

|{{:tools:triplanar_blending0.png?nolink&200|0% Blend}}|{{:tools:triplanar_blending20.png?nolink&200|20% Blend}}|{{:tools:triplanar_blending50.png?nolink&200|20% Blend}}| {{:tools:triplanar_blending100.png?nolink%200|100% Blend}}|
|0% Blend|20% Blend|50% Blend|100% Blend|

We recommend a value between 5% and 20% for most uses.
{{ :tools:triplanarmapper_gui.png?nolink|}}
==== Separate Images ====

By default, one image is projected on all axes. Enabling this options allows you to pick a separate image for the X,Y and Z axis separately.

==== World Space ====

This controls if the blending is computed in local or in world space. Please note, this only affects how the blending is computed, not how the images are projected.

==== Main / X Image, Y Image, Z Image ====

The following controls define how the image(s) are projected. The node uses planar mapping for them.

If **Separate Images** is enabled, the Y Image and Z Image tabs will be enabled as well, otherwise the **Main / X Image** is used for all axes.

The controls are identical to the ones used by LightWave3D to control the projection of an image, with one exception:

=== Flip Reverse Side ===

If this option is enabled, the projected image will be flipped on the U texture coordinate axis on the negative side of the projection. This can be used to make images containing text be readable on the back side of a mesh as well.




===== Node Connections =====
{{:tools:triplanarmapper_node.png?nolink |}}

==== Inputs ====

=== Background / Opacity ===

These inputs are identical to the ones provided by the native texture mapping nodes for compositing.

=== Blend ===

The triplanar blend strength.

=== Normal ===

This input overrides the normal used to compute the blending.

==== Outputs ====

=== Colour ===

Outputs the colour as computed by the projected images and composited onto the background colour.

=== Luma ===

This output only return the luminance of the projected images.

=== Alpha ===

This output returns the alpha of the projected images.

=== Bump ===

This output returns a bump value computed from the intensity of the image.

=== Normal ===

This output returns the surface normal perturbed by the bump map.
----
[[https://www.patreon.com/dbw|{{  ::become_a_patron_button.png?nolink|}}]]
This is the plugin of the month for November 2018, made possible by the finest patrons on [[https://www.patreon.com/dbw|Patreon]].

We'd like to thank Antti Järvelä from the LightWave 3D Group in helping us figure out the specifics of the bump mapping code in LightWave 3D.