Surface Mapping

From RealMotion Wiki

Surface Mapping/Surface Mapping

Maps texture of a Surface to another Surface. ​

Description

The Surface Mapping box maps Surfaces created in the Surface Editor. Using the Surface Editor allows a better visualization and control of the Surface used in a project.

For each inputted Texture, the Surface Mapping box assigns a Crop Surface and a Draw Surface. Each texture may be mirrored, rotated and blended independently. The rendering order is set in the row order of the Surface Maps table.

General Use Case: The box is mainly used at the end of the texture pipeline to assemble content into one outputted texture.

Per Column information:
- The Input Pin column sets the Texture to map from the inputted texture.
- The Crop Surface column select the Crop Surface among the Surfaces created in the Surface Editor. The Crop Surface selects a sub-part of the inputted texture.
- The Draw Surface column selects the Draw Surface among the Surfaces created in the Surface Editor. The Draw Surface indicates where to draw the cropped Texture on the Render texture.
- The Mirror X column inverts the cropped Texture horizontally.
- The Mirror Y column inverts the cropped Texture vertically.
- The Rotate column rotates clockwise the cropped Texture.
- And finally, the Blend Mode column selects the blend mode used to blend the surfaces. Surfaces are blended in the row order of the Surface Maps table.

Inputs

Render 2D Render Target Receives the texture to draw on.
Texture-[N] 2D Texture Receives the texture to map.

Outputs

Texture 2D Render Target Outputs the mapping result.

Parameters

Surfaces

Number of Input Pin: Texture Int Sets the number of Texture Input Pins.
Surface Maps Surface Mapping Vector Manages the Surfaces Mapping. See the box description for per column information.

See Also

Boxes related

Blending Mask, Warp Grid, Blend, Crop, Add, Draw Surface, Surface, Surface Components, ​​

Version Information

Current documentation version: 2.1.4. ​ ​