TextureDecal

Description

sealed class Tinman.Engine.Scenes.Entities.TextureDecal

Derived from

SceneEntityBase abstract
ILightingProperty
IRenderPriority

A scene entity that puts a decal onto the terrain.

The following figured shows the mapping between decal vertex coordinates and decal texture coordinates.

(A)---------(B)            Vertex          Texture
 |           |             coordinates:    coordinates:
 |           |     A :=    (-0.5, -0.5)    (0, 0)
 |           |     B :=    (+0.5, -0.5)    (1, 0)
 |           |     C :=    (+0.5, +0.5)    (1, 1)
 |           |     D :=    (-0.5, +0.5)    (0, 1)
(D)---------(C)

The decal vertex transformation is defined as follows:

  1. The input decal vertex coordinates v_in are translated according to the decal texture center (see Center), so that subsequent scaling and rotation is relative to the decal texture center.
    v := v_in - Center + (0.5, 0.5)

  2. The decal vertex coordinates v are scaled, according to Scale:
    v := v * Scale

  3. The decal vertex coordinates v are rotated, according to Yaw:
    v := RotateClockwiseRightHanded(v, Yaw)

  4. The output decal vertex coordinates v_out result from applying the final offset translation, according to Offset:
    v_out := v + Offset

The resulting vertex coordinates are used as map coordinates with respect to the specified coordinate system (see Coordinates). From there, the decal texture is put onto the terrain at the corresponding position.

The default value for the ILightingProperty.Lighting property is false.

See also

TerrainDecal

Public / Constructors

Texture​Decal

public constructor TextureDecal → (1)

entityViewMask opt : int64 = ~0

The value for IEntityViewMask.EntityViewMask.

Creates a new instance of TextureDecal.

Public / Attributes

Center

public attribute Center → (get,set)

value : Vec2D

The texture coordinates of the decal center.

The texture coordinates that represent the center of the decal texture.

The scaling (see Scale) and rotation (see Yaw) of the decal texture is applied relative to this center.

Defaults to (0.5, 0.5).

See also

TextureDecal.Matrix

Content

public attribute Content → (get,set)

value : IModelTexture

The texture content or null.

The decal texture content.

Defaults to null.

Coordinates

public attribute Coordinates → (get,set)

value : CoordinateSystem

The coordinate system or null.

The coordinate system of the transformed decal vertices.

Defaults to null.

Matrix

public attribute Matrix → (get)

value : Mat3D

The transformation matrix.

Returns the homogeneous transformation matrix from input decal vertex coordinates to output decal vertex coordinates.

See also

TextureDecal.Center
TextureDecal.Scale
TextureDecal.Yaw
TextureDecal.Offset

Offset

public attribute Offset → (get,set)

value : Vec2D

The translation offset, in map-space.

The translation offset of the decal vertex transformation.

The translation offset is added to the vertex coordinates of the decal texture, after applying scaling (see Scale) and rotation (see Yaw). Use it to move the decal texture center (see Center) to a desired point in map-space.

Defaults to Vec2D.Zero.

See also

TextureDecal.Matrix

Scale

public attribute Scale → (get,set)

value : Vec2D

The scale values.

The scale factors per axis of the decal vertex transformation.

Scaling is applied relative to the decal texture center (see Center).

The texture coordinates for the horizontal U and vertical V axis of the given decal texture (see Content) are within the range [0..1], where 0 represents the left resp. top edge and 1 represents the right resp. bottom edge. The Vec2D.X resp. Vec2D.Y scale factor transforms the range [0..1] to map space, as defined by the specified coordinate system (see Coordinates).

Defaults to Vec2D.Zero.

See also

TextureDecal.Matrix

Sort​Index

public attribute SortIndex → (get,set)

value : int32

The sort index, see TerrainDecal.SortIndex.

The terrain layer sort index of this texture decal.

Yaw

public attribute Yaw → (get,set)

value : float64

The rotation angle, in degrees.

The rotation angle of the decal vertex transformation.

The rotation is applied relative to the decal texture center (see Center). Positive angles rotate clockwise for right-handed map-space and counter-clockwise for left-handed map-space.

Defaults to 0.

See also

TextureDecal.Matrix