Revision as of 15:24, 21 September 2017

KIND Groundtexture is an extension of KIND Texture. A ground texture is tiled in Surveyor to color and cover the base grid.

This page describes content format v4.6.

KIND Hierarchy

Parent Classes

KIND TrainzBaseSpec

Child Classes

none

Supported Tags

The KIND Groundtexture config.txt file supports the following tags. Each tag is show here with its default value.

season-selector
{
  ...
}
texture-variants
{
 0
 {
   diffuse-texture ""
   normal-texture ""
   parameters-texture ""
   albedo-detail-texture ""
   normal-detail-texture ""
   detailtexturescale 0.09
 }
 ...
}

season-selector

The "season-selector" container allows the ground texture asset to adapt its appearance based on the current environmental conditions. This container provides selection logic to determine which seasonal variant to display.

texture-variants

The "texture-variants" container supplies one or more numbered texture variants, which correspond to the seasons defined by the "season-selector" container.

diffuse-texture

The "diffuse-texture" tag specifies a texture file located within the asset folder. See the discussion on the ground material below for more information on how this image is utilized.

normal-texture

The "normal-texture" tag specifies a texture file located within the asset folder. See the discussion on the ground material below for more information on how this image is utilized.

parameters-texture

The "parameters-texture" tag specifies a texture file located within the asset folder. See the discussion on the ground material below for more information on how this image is utilized.

albedo-detail-texture

The "albedo-detail-texture" tag specifies a texture file located within the asset folder. See the discussion on the ground material below for more information on how this image is utilized.

normal-detail-texture

The "normal-detail-texture" tag specifies a texture file located within the asset folder. See the discussion on the ground material below for more information on how this image is utilized.

detailtexturescale

The detailtexturescale tag specifies a scaling value to use for the detail textures relative to the primary texture coordinates. 1.0 means that the detail texture uses the same mapping as the primary texture (which is basically pointless) while numbers below 1.0 mean that the detail texture is mapped over a larger area at lower texel resolution, and numbers above 1.0 mean that the detail texture is mapped over a smaller area with higher texel resolution. This tag is only relevant where detail textures are in use.

Material

Two variations of the ground material may be used. The selection is automatic based on the provided tags in the selected texture variant:

PBR

The PBR ground texture material is similar to m.pbrmetal. Only the following config tags should be supplied:

diffuse-texture - The albedo texture.

Albedo Texture Example

normal-texture - The normal texture.

Normal Texture Example with no Alpha Channel (Parallax)

Normal Texture Example with Alpha Channel (Parallax)

parameters-texture - The PBR parameters texture.

NOTE: If possible without losing visual quality, see what results in a smaller parameters texture. Try 512x512 or 256x256 and compare your results as usually there won't be a lot of difference when scaling down from 2048 or 1024 but this is on a case by case scenario so best to do your own comparison.

Parameters (Emissive - Red Channel) Texture Example

Parameters (Roughness - Green Channel) Texture Example

Parameters (Ambient Occlusion - Blue Channel) Texture Example

Parameters (Metallic - Alpha Channel) Texture Example

To read more detail about the functionality for each of the textures and their channels click here: m.pbrmetal

PBR Detail

The PBR Detail ground texture material is similar to m.pbrmetaldetail. All of the following config tags should be supplied:

diffuse-texture - The albedo texture.

Example, see above.

normal-texture - The normal texture.

Albedo Detail Texture

parameters-texture - The PBR parameters texture.

Example, see above.

albedo-detail-texture - The detail albedo texture.

NOTE: If possible without losing visual quality, see what results in a smaller detail texture. Try 512x512 or 256x256 and compare your results as usually there won't be a lot of difference when scaling down from 2048 or 1024 but this is on a case by case scenario so best to do your own comparison.

Detail Texture

normal-detail-texture - The detail normal texture.

Currently not used but must still be provided.

detailtexturescale - The detail texture scaling factor.

Explanation above.

Scale

When choosing your image, make sure it is the proper scale so details does not look too large or too small in game. The smallest scale setting in surveyor corresponds to an image 10 meters across, while the largest scale setting corresponds to 24 meters across.

Downloads

Attach sample files here?

Revision as of 15:24, 21 September 2017 (view source) N3vpolsen (Talk \| contribs) (→‎PBR) ← Older edit		Revision as of 15:24, 21 September 2017 (view source) N3vpolsen (Talk \| contribs) (→‎PBR) Newer edit →
Line 76:		Line 76:

	[[File:pbrnormalmap1.jpg]]		[[File:pbrnormalmap1.jpg]]
		+

	'''Normal Texture Example with Alpha Channel (Parallax)'''		'''Normal Texture Example with Alpha Channel (Parallax)'''

KIND Groundtexture