M.leafcard - Revision history

Windwalkr at 05:24, 10 June 2024

2024-06-10T05:24:07Z

← Older revision		Revision as of 05:24, 10 June 2024
Line 5:		Line 5:


	This page describes [["Trainz-build" number\|Content Format v5.6]] and requires that the FBX file format is used as a data source for any meshes.		This page describes [["Trainz-build" number\|Content Format v5.6]] and requires that the [[FBX file format]] is used as a data source for any meshes.

	We recommend using the free PlantFactory software to create trees with this material type. Detailed tutorials are available on the [[Treez]] page.		We recommend using the free PlantFactory software to create trees with this material type. Detailed tutorials are available on the [[Treez]] page.

Windwalkr at 05:17, 10 June 2024

2024-06-10T05:17:44Z

← Older revision		Revision as of 05:17, 10 June 2024
Line 1:		Line 1:
	[[m.leafcard]] is a ~~variation on the [[m.pbrmetalmasked]]~~ material~~. Introduced with~~ the ~~new foliage system~~ "[[Treez]]"~~, it~~ is used when creating ~~transparent leaf~~ and~~/or~~ branches on trees and plants.		[[m.leafcard]] is a new material introduced as part of the "[[Treez]]" foliage system. It is used when creating leaves and minor branches for trees and plants, and is tuned to provide visual outcomes which are suitable for this usage. This may result in subtle rendering differences when compared to the standard materials such as [[m.pbrmetal]]. The exact nature of these differences may change in the future. These differences make [[m.leafcard]] unsuitable as a general-purpose material.


Line 5:		Line 5:


	This page describes ~~content format~~ v5.6 and ~~assumes~~ that the FBX file format is used as a data source for any meshes.		This page describes [["Trainz-build" number\|Content Format v5.6]] and requires that the FBX file format is used as a data source for any meshes.

	If using PlantFactory ~~you will want~~ to ~~get the example files~~ on the [[Treez]] page. You will also want to watch the PlantFactory video information on [[Treez]] page so you can understand how to use the program and also how to export from PlantFactory, setup your Trainz Asset and import into Trainz.		We recommend using the free PlantFactory software to create trees with this material type. Detailed tutorials are available on the [[Treez]] page.

	=Texture Slots=		=Texture Slots=
Line 15:		Line 15:
	RGB: The [[albedo map]] defines the base color of each texel. The sRGB color space is used.		RGB: The [[albedo map]] defines the base color of each texel. The sRGB color space is used.

	A: The alpha channel provides ~~a "black and white" [[masked alpha]]~~ channel. Black indicates full transparency, meaning that the [[fragment]] is discarded. White indicates full opacity, ~~meaning that rendering proceeds as per [[m~~.~~pbrmetal]]. If the~~ alpha channel is omitted, this material acts exactly as [[m.pbrmetal]] except with lower performance. Note that unlike legacy Trainz materials, PBR materials do not autodetect opacity mode based on the texture in use. The content creator must select the appropriate material for their desired outcome. Runtime texture replacement should not expect to replace an opaque texture with a blended or masked texture and have the material update automatically.		A: The alpha channel provides an opacity channel. Black indicates full transparency, meaning that the [[fragment]] is discarded. White indicates full opacity. Shades of gray are supported, which represent partial transparency. The alpha channel may be heavily quantised.

	~~You~~ may need to include an alpha-hint tag in your albedo texture.txt file. See [[.texture.txt_Files]]. If creating a double sided material using metadata you should also consider using a blend-mode tag. See [[Mesh_metadata_file]].

N3vpolsen at 07:47, 6 June 2024

2024-06-06T07:47:14Z

← Older revision		Revision as of 07:47, 6 June 2024
Line 6:		Line 6:

	This page describes content format v5.6 and assumes that the FBX file format is used as a data source for any meshes.		This page describes content format v5.6 and assumes that the FBX file format is used as a data source for any meshes.

			If using PlantFactory you will want to get the example files on the [[Treez]] page. You will also want to watch the PlantFactory video information on [[Treez]] page so you can understand how to use the program and also how to export from PlantFactory, setup your Trainz Asset and import into Trainz.

	=Texture Slots=		=Texture Slots=

N3vpolsen at 07:09, 6 June 2024

2024-06-06T07:09:42Z

← Older revision		Revision as of 07:09, 6 June 2024
Line 1:		Line 1:
	[[m.leafcard]] is a variation on the [[m.pbrmetalmasked]] material. Introduced with the new foliage system "[[Treez]]", it is used when creating leaf ~~cards~~ on trees and plants.		[[m.leafcard]] is a variation on the [[m.pbrmetalmasked]] material. Introduced with the new foliage system "[[Treez]]", it is used when creating transparent leaf and/or branches on trees and plants.

N3vpolsen at 07:06, 6 June 2024

2024-06-06T07:06:52Z

← Older revision		Revision as of 07:06, 6 June 2024
Line 29:		Line 29:

	[[File:m_leafcard_2b.jpg\|300px]]		[[File:m_leafcard_2b.jpg\|300px]]


	==Normal==		==Normal==

N3vpolsen at 07:01, 6 June 2024

2024-06-06T07:01:31Z

N3vpolsen at 05:29, 6 June 2024

2024-06-06T05:29:26Z

← Older revision		Revision as of 05:29, 6 June 2024
Line 1:		Line 1:
	[[m.leafcard]] is a variation on the [[m.pbrmetalmasked]] material. Introduced with the new foliage system "[[Treez]]", it is used when creating leaf cards on trees and plants.		[[m.leafcard]] is a variation on the [[m.pbrmetalmasked]] material. Introduced with the new foliage system "[[Treez]]", it is used when creating leaf cards on trees and plants.

	The blue channel of the parameters texture is used to modulate the strength of the directional lighting. This is intended to give the feel of individual leaves being deeper inside the tree and shadowed from all directions, even though the leaf card as a whole is not shadowed. (Note that this is the same channel used for Ambient Occlusion on m.pbrmetal; the leaf card materials do not support ambient occlusion.)

	~~Full brightness (100% blue channel) gives a standard lighting response, while darker values give a weaker response to directional lighting.~~

	~~Here is an example of what the blue (AO) channel could look like in the parameters texture.~~


Line 47:		Line 41:
	This texture is comprised of four separate channels which each form a separate data element. Linear color space (not sRGB) is used for these channels.		This texture is comprised of four separate channels which each form a separate data element. Linear color space (not sRGB) is used for these channels.

	[[File:m_leafcard_4.jpg\|border\|middle\|~~x700px~~]]		[[File:m_leafcard_4.jpg\|border\|middle\|x500px]]


Line 64:		Line 58:
	[[File:m_leafcard_6.jpg\|border\|middle\|x300px]]		[[File:m_leafcard_6.jpg\|border\|middle\|x300px]]

	B: Ambient Occlusion. ~~Defines whether~~ the ~~surface is exposed to~~ ambient ~~lighting conditions (1~~.0) ~~or affected only by direct lighting~~ (~~0.0~~).		B: The blue channel of the parameters texture is used to modulate the strength of the directional lighting. This is intended to give the feel of individual leaves being deeper inside the tree and shadowed from all directions, even though the leaf card as a whole is not shadowed. (Note that this is the same channel used for Ambient Occlusion on m.pbrmetal; the leaf card materials do not support ambient occlusion.)

			Full brightness (100% blue channel) gives a standard lighting response, while darker values give a weaker response to directional lighting.


	'''Parameters (~~Ambient Occlusion~~ - Blue Channel) Texture Example'''		'''Parameters (Directional Lighting Strength - Blue Channel) Texture Example'''

	[[File:m_leafcard_7.jpg\|border\|middle\|x300px]]		[[File:m_leafcard_7.jpg\|border\|middle\|x300px]]

N3vpolsen at 05:26, 6 June 2024

2024-06-06T05:26:59Z

← Older revision		Revision as of 05:26, 6 June 2024
Line 26:		Line 26:
	'''Albedo Texture Example'''		'''Albedo Texture Example'''

	[[File:m_leafcard_1.png\|~~500px~~]]		[[File:m_leafcard_1.png\|300px]]

	Color Channel Separated		Color Channel Separated

	[[File:m_leafcard_2.jpg\|~~500px~~]]		[[File:m_leafcard_2.jpg\|300px]]

	Alpha Channel Separated		Alpha Channel Separated

	[[File:m_leafcard_2b.jpg\|~~500px~~]]		[[File:m_leafcard_2b.jpg\|300px]]

	==Normal==		==Normal==
Line 41:		Line 41:
	'''Normal Texture Example with no Alpha Channel (Parallax)'''		'''Normal Texture Example with no Alpha Channel (Parallax)'''

	[[File:m_leafcard_3.jpg\|border\|middle\|~~x200px~~]]		[[File:m_leafcard_3.jpg\|border\|middle\|x300px]]


Line 47:		Line 47:
	This texture is comprised of four separate channels which each form a separate data element. Linear color space (not sRGB) is used for these channels.		This texture is comprised of four separate channels which each form a separate data element. Linear color space (not sRGB) is used for these channels.

	[[File:m_leafcard_4.jpg\|border\|middle\|~~x200px~~]]		[[File:m_leafcard_4.jpg\|border\|middle\|x700px]]


Line 55:		Line 55:
	'''Parameters (Emissive - Red Channel) Texture Example'''		'''Parameters (Emissive - Red Channel) Texture Example'''

	[[File:m_leafcard_5.jpg\|border\|middle\|~~x200px~~]]		[[File:m_leafcard_5.jpg\|border\|middle\|x300px]]

	G: Roughness. Defines whether the surface reflections are shiny (0.0) or matte (1.0). See the [[Physically Based Rendering\|PBR metal workflow]] for details.		G: Roughness. Defines whether the surface reflections are shiny (0.0) or matte (1.0). See the [[Physically Based Rendering\|PBR metal workflow]] for details.
Line 62:		Line 62:
	'''Parameters (Roughness - Green Channel) Texture Example'''		'''Parameters (Roughness - Green Channel) Texture Example'''

	[[File:m_leafcard_6.jpg\|border\|middle\|~~x200px~~]]		[[File:m_leafcard_6.jpg\|border\|middle\|x300px]]

	B: Ambient Occlusion. Defines whether the surface is exposed to ambient lighting conditions (1.0) or affected only by direct lighting (0.0).		B: Ambient Occlusion. Defines whether the surface is exposed to ambient lighting conditions (1.0) or affected only by direct lighting (0.0).
Line 69:		Line 69:
	'''Parameters (Ambient Occlusion - Blue Channel) Texture Example'''		'''Parameters (Ambient Occlusion - Blue Channel) Texture Example'''

	[[File:m_leafcard_7.jpg\|border\|middle\|~~x200px~~]]		[[File:m_leafcard_7.jpg\|border\|middle\|x300px]]

	A: Metallicity. Defines whether the surface is metallic (1.0) with the albedo used to colorize reflected light, or dielectric (0.0) with the albedo used to colorize the surface. While intermediate values are not physically accurate, they may be used to emulate subsurfaces which are partially metallic. See the [[Physically Based Rendering\|PBR metal workflow]] for details.		A: Metallicity. Defines whether the surface is metallic (1.0) with the albedo used to colorize reflected light, or dielectric (0.0) with the albedo used to colorize the surface. While intermediate values are not physically accurate, they may be used to emulate subsurfaces which are partially metallic. See the [[Physically Based Rendering\|PBR metal workflow]] for details.
Line 76:		Line 76:
	'''Parameters (Metallic - Alpha Channel) Texture Example'''		'''Parameters (Metallic - Alpha Channel) Texture Example'''

	[[File:m_leafcard_8.jpg\|border\|middle\|~~x200px~~]]		[[File:m_leafcard_8.jpg\|border\|middle\|x300px]]

	=Examples=		=Examples=

N3vpolsen at 05:14, 6 June 2024

2024-06-06T05:14:37Z

← Older revision		Revision as of 05:14, 6 June 2024
Line 26:		Line 26:
	'''Albedo Texture Example'''		'''Albedo Texture Example'''

	[[File:m_leafcard_1.~~jpg~~\|500px]]		[[File:m_leafcard_1.png\|500px]]

	Color Channel Separated		Color Channel Separated

N3vpolsen at 05:11, 6 June 2024

2024-06-06T05:11:30Z

← Older revision		Revision as of 05:11, 6 June 2024
Line 26:		Line 26:
	'''Albedo Texture Example'''		'''Albedo Texture Example'''

	[[File:m_leafcard_1.~~png~~\|500px]]		[[File:m_leafcard_1.jpg\|500px]]

	Color Channel Separated		Color Channel Separated

	[[File:m_leafcard_2.~~png~~\|500px]]		[[File:m_leafcard_2.jpg\|500px]]

	Alpha Channel Separated		Alpha Channel Separated

	[[File:~~PortalAlpha~~.~~png~~\|500px]]		[[File:m_leafcard_2b.jpg\|500px]]

	==Normal==		==Normal==

← Older revision		Revision as of 07:01, 6 June 2024
Line 41:		Line 41:
	This texture is comprised of four separate channels which each form a separate data element. Linear color space (not sRGB) is used for these channels.		This texture is comprised of four separate channels which each form a separate data element. Linear color space (not sRGB) is used for these channels.

	[[File:m_leafcard_4.jpg\|border\|middle\|~~x500px~~]]		[[File:m_leafcard_4.jpg\|border\|middle\|800px]]



	R: Emissive. This causes the texture to have an internal glow, even when no external light is present. Used for phosphors, permanently-lit markings, etc. The glow color is based on the albedo. Note that this glow does not cast light upon surrounding surfaces except via the Bloom post-processing effect.		R: Emissive. This causes the texture to have an internal glow, even when no external light is present. Used for phosphors, permanently-lit markings, etc. The glow color is based on the albedo. Note that this glow does not cast light upon surrounding surfaces except via the Bloom post-processing effect.


	'''Parameters (Emissive - Red Channel) Texture Example'''		'''Parameters (Emissive - Red Channel) Texture Example'''

	[[File:m_leafcard_5.jpg\|border\|middle\|x300px]]		[[File:m_leafcard_5.jpg\|border\|middle\|x300px]]



	G: Roughness. Defines whether the surface reflections are shiny (0.0) or matte (1.0). See the [[Physically Based Rendering\|PBR metal workflow]] for details.		G: Roughness. Defines whether the surface reflections are shiny (0.0) or matte (1.0). See the [[Physically Based Rendering\|PBR metal workflow]] for details.


	'''Parameters (Roughness - Green Channel) Texture Example'''		'''Parameters (Roughness - Green Channel) Texture Example'''

	[[File:m_leafcard_6.jpg\|border\|middle\|x300px]]		[[File:m_leafcard_6.jpg\|border\|middle\|x300px]]



	B: The blue channel of the parameters texture is used to modulate the strength of the directional lighting. This is intended to give the feel of individual leaves being deeper inside the tree and shadowed from all directions, even though the leaf card as a whole is not shadowed. (Note that this is the same channel used for Ambient Occlusion on m.pbrmetal; the leaf card materials do not support ambient occlusion.)		B: The blue channel of the parameters texture is used to modulate the strength of the directional lighting. This is intended to give the feel of individual leaves being deeper inside the tree and shadowed from all directions, even though the leaf card as a whole is not shadowed. (Note that this is the same channel used for Ambient Occlusion on m.pbrmetal; the leaf card materials do not support ambient occlusion.)

	Full brightness (100% blue channel) gives a standard lighting response, while darker values give a weaker response to directional lighting.		Full brightness (100% blue channel) gives a standard lighting response, while darker values give a weaker response to directional lighting.


	'''Parameters (Directional Lighting Strength - Blue Channel) Texture Example'''		'''Parameters (Directional Lighting Strength - Blue Channel) Texture Example'''

	[[File:m_leafcard_7.jpg\|border\|middle\|x300px]]		[[File:m_leafcard_7.jpg\|border\|middle\|x300px]]



	A: Metallicity. Defines whether the surface is metallic (1.0) with the albedo used to colorize reflected light, or dielectric (0.0) with the albedo used to colorize the surface. While intermediate values are not physically accurate, they may be used to emulate subsurfaces which are partially metallic. See the [[Physically Based Rendering\|PBR metal workflow]] for details.		A: Metallicity. Defines whether the surface is metallic (1.0) with the albedo used to colorize reflected light, or dielectric (0.0) with the albedo used to colorize the surface. While intermediate values are not physically accurate, they may be used to emulate subsurfaces which are partially metallic. See the [[Physically Based Rendering\|PBR metal workflow]] for details.


	'''Parameters (Metallic - Alpha Channel) Texture Example'''		'''Parameters (Metallic - Alpha Channel) Texture Example'''