Export Material User Data - Revision history

Hannah at 05:33, 19 January 2023

2023-01-19T05:33:34Z

← Older revision		Revision as of 22:33, 18 January 2023
Line 9:		Line 9:
	Because the workflows for the different textures are similar but entirely separate, The documentation for each texture is thusly separated.		Because the workflows for the different textures are similar but entirely separate, The documentation for each texture is thusly separated.

			Many of the parameters use the '''Combined Parameter Data''' type, which allows a group of parameters to be combined into one for export.
			*An exported material defaults to a colour and opacity of #FFFFFFFF. This is a hexadecimal colour of "White, and completely opaque."
			*If a vector or texture parameter is specified in the Colour Param or Diffuse Tex variables within the Export Material User Data, those variables will be used for the colour of the exported material.
			*If both are specified, they will be multiplied together.
			*The exported opacity is assumed to be 1 (completely opaque) if no Alpha Param is specified. if a Diffuse Tex variable is specified, then the opacity is defined by the alpha channel of the texture. If the texture is single-channel, it is assumed to be an alpha texture as well as a diffuse texture. If a texture is RGB without an alpha, the alpha is unaffected by the diffuse tex.
	== Add an Export Material User Data parameter to Your Material ==		== Add an Export Material User Data parameter to Your Material ==
	From the Details panel of the material, under the Material category, expand the parameters, and add, from the Asset User Data array, an Export Material User Data:		From the Details panel of the material, under the Material category, expand the parameters, and add, from the Asset User Data array, an Export Material User Data:

Hannah: /* Texture Parameter Data */

2023-01-19T05:21:36Z

Texture Parameter Data

← Older revision		Revision as of 22:21, 18 January 2023
Line 82:		Line 82:
	== Texture Parameter Data ==		== Texture Parameter Data ==
	This data allows the exporter to select a texture parameter, or texture parameter from a list, for export as a single texture.		This data allows the exporter to select a texture parameter, or texture parameter from a list, for export as a single texture.

			=== Mask Channel ===
			This setting is only visible for the greyscale texture outputs (Roughness, Metallic, Specular, Opacity). It is not visible for the Diffuse, or Normal texture parameters.

			It controls the channel of the texture that is used for the output texture. If your texture is a greyscale texture, the output channel is not so important, but should be set to the G (Green) channel simply because the textures in Automation are compressed, and this channel contains slightly more bit-depth than other channels and therefore results in a higher-quality output texture.

	=== Param Name ===		=== Param Name ===

Hannah: /* Material Type */

2023-01-19T05:16:40Z

Material Type

← Older revision		Revision as of 22:16, 18 January 2023
Line 15:		Line 15:
	===Material Type===		===Material Type===
	The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.		The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.
	[[~~File:Material_Type.png\|link=~~File:Material_Type.png\|frameless\|312x312px]]
			[[File:Material_Type.png\|frameless\|312x312px]]
	*'''Grille''' - The exporter will create a proper two layered material and generate a blend map. One layer is chrome, the other is black.		*'''Grille''' - The exporter will create a proper two layered material and generate a blend map. One layer is chrome, the other is black.
	*'''Glass''' - For transparent glass materials.		*'''Glass''' - For transparent glass materials.

Hannah: /* Material Type */

2023-01-19T05:16:21Z

Material Type

← Older revision		Revision as of 22:16, 18 January 2023
Line 15:		Line 15:
	===Material Type===		===Material Type===
	The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.		The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.
	[[~~index.php?title=~~File:Material_Type.png\|link=File:Material_Type.png\|frameless\|312x312px]]		[[File:Material_Type.png\|link=File:Material_Type.png\|frameless\|312x312px]]
	*'''Grille''' - The exporter will create a proper two layered material and generate a blend map. One layer is chrome, the other is black.		*'''Grille''' - The exporter will create a proper two layered material and generate a blend map. One layer is chrome, the other is black.
	*'''Glass''' - For transparent glass materials.		*'''Glass''' - For transparent glass materials.
Line 22:		Line 22:
	* '''Other''' - default behaviour. If in doubt, use this value.		* '''Other''' - default behaviour. If in doubt, use this value.
	* (removed) - These are older, legacy categories that no longer exist. They default to the '''Other''' behaviour.		* (removed) - These are older, legacy categories that no longer exist. They default to the '''Other''' behaviour.

	== Diffuse Parameter Info ==		== Diffuse Parameter Info ==
	The Diffuse EMUD is the only mandatory export parameter. All other parameters have defaults, but a material without a diffuse parameter set in the EMUD will not export correctly or at all.		The Diffuse EMUD is the only mandatory export parameter. All other parameters have defaults, but a material without a diffuse parameter set in the EMUD will not export correctly or at all.

Hannah: /* Add an Export Material User Data parameter to Your Material */

2023-01-19T05:14:04Z

Add an Export Material User Data parameter to Your Material

@@ Line 13: / Line 13: @@
 [[File:ExportParameters AddExportUserData.jpg|frameless]]
+===Material Type===
 == Diffuse Parameter Info ==
 The Diffuse EMUD is the only mandatory export parameter. All other parameters have defaults, but a material without a diffuse parameter set in the EMUD will not export correctly or at all.
@@ Line 44: / Line 52: @@
 ===Normals Param===
 This group of parameters controls the Normals of the material. It has two categories, the [[Export Material User Data#Combined Parameter Data|Combined Parameter Data]], and the [[Export Material User Data#Texture Parameter Data|Texture Parameter Data]]. If the Texture Parameter Data is left as default, it will use the default Normals value of <code>0.5</code>. If the Combined Parameter Data value is populated, the Normal texture will have its strength be adjusted by the value of the Combined Parameter Data.
 == Combined Parameter Data ==

Hannah: /* Diffuse Parameter Info */

2023-01-19T05:01:35Z

Diffuse Parameter Info

← Older revision		Revision as of 22:01, 18 January 2023
Line 27:		Line 27:
	At least one parameter within either the Colour Parameters, or the Diffuse Texture Param, is necessary. All else is optional, or adds on top of these parameters.		At least one parameter within either the Colour Parameters, or the Diffuse Texture Param, is necessary. All else is optional, or adds on top of these parameters.

			The categories within the Diffuse parameter info act as a lerp. The Colour Param and Diffuse Texture Param categories, along with the Diffuse Texture to Colour Lerp all combined are the A input for the lerp. The Colour Secondary Param is the B input, and the Colour Secondary Mask Param is the Alpha input of the lerp.

			Within the A input of the lerp, there exists a second lerp. The Diffuse Texture To Colour Lerp is the alpha input, and it must be a scalar. The colour Param is the A input, and the Diffuse Texture Param is the B input. The Diffuse Texture Param uses a [[Export Material User Data#Texture Parameter Data\|Texture Parameter Data]].

			If the Diffuse Texture To Colour Lerp is left as <code>none</code>, the lerp is disabled and the system tries to use the diffuse Texture Param. If this is also left as <code>none</code>, then the system will use the Colour Param sub-category. The colour Param sub-category uses a [[Export Material User Data#Combined Parameter Data\|Combined Parameter Data]] input.

			Within the B input of the lerp, there exists only the Colour Secondary Param sub-category. It uses a [[Export Material User Data#Combined Parameter Data\|Combined Parameter Data]] input. If the Colour Secondary Param sub-category is left as none, the lerp is disabled and the Colour Secondary Param and Colour Secondary Mask Param categories are not used.

			Within the Alpha input of the lerp, there exists the Colour Secondary Mask Param. It uses a [[Export Material User Data#Texture Parameter Data\|Texture Parameter Data]]. If it is left as none, the lerp is disabled and the Colour Secondary Param and Colour Secondary Mask Param categories are not used.
			===Roughness Param===
			This group of parameters controls the roughness of the material. It has two categories, the [[Export Material User Data#Combined Parameter Data\|Combined Parameter Data]], and the [[Export Material User Data#Texture Parameter Data\|Texture Parameter Data]]. If the Texture Parameter Data is left as default, it will use the Combined Parameter Data. If both categories are left as default, it will use the default roughness value of <code>0.5</code>.
			===Metallic Param===
			This group of parameters controls the Metallic of the material. It has two categories, the [[Export Material User Data#Combined Parameter Data\|Combined Parameter Data]], and the [[Export Material User Data#Texture Parameter Data\|Texture Parameter Data]]. If the Texture Parameter Data is left as default, it will use the Combined Parameter Data. If both categories are left as default, it will use the default Metallic value of <code>0</code>.
			===Specular Param===
			This group of parameters controls the Specular of the material. It has two categories, the [[Export Material User Data#Combined Parameter Data\|Combined Parameter Data]], and the [[Export Material User Data#Texture Parameter Data\|Texture Parameter Data]]. If the Texture Parameter Data is left as default, it will use the Combined Parameter Data. If both categories are left as default, it will use the default Specular value of <code>0.5</code>.
			===Normals Param===
			This group of parameters controls the Normals of the material. It has two categories, the [[Export Material User Data#Combined Parameter Data\|Combined Parameter Data]], and the [[Export Material User Data#Texture Parameter Data\|Texture Parameter Data]]. If the Texture Parameter Data is left as default, it will use the default Normals value of <code>0.5</code>. If the Combined Parameter Data value is populated, the Normal texture will have its strength be adjusted by the value of the Combined Parameter Data.

			== Combined Parameter Data ==
			This data allows for a group of parameters to be combined into one for export.
			===Override===
			If set to true, the above parameter names will be ignored in favour of the given override value.
			===Value Override===
			If Override is true, this value will be used for the parameter instead of the named material parameter.
			===Param Name===
			The main parameter for the value. If Param Name 2 is empty, this will be the only parameter used and its value will be exported as is.
			===Param Name 2===
			The second parameter for the value. Many Automation materials blend between colours or other values via a noise/bump map or via some other user or child driven value. Because BeamNG needs a single value, we need to do the blending once for the whole material.
			===Param Name Lerp===
			This parameter, if named, controls the blending between the values of Param Name and Param Name 2. If Param Name 2 is empty, this value has no effect. If this value is empty but Param Name 2 is not, the two values will be averaged.

			=== Param Name Lerp Power ===
			This parameter, if named, controls the strength of the Param Name Lerp. See [[Custom Paint Mods#MF CustomPaint Lerp Scalar\|Custom Paint Lerp Scalar]] for it's example usage.

			== Texture Parameter Data ==
			This data allows the exporter to select a texture parameter, or texture parameter from a list, for export as a single texture.

			=== Param Name ===
			The main parameter for the texture. If the Param Name List is empty, this is the only parameter used and its texture will be used.

			=== Param Name List ===
			If the Param Name Selector is also populated, this list will select a single texture to use based off the value of the Param Name Selector. Many Automation materials allow the player to select a texture using a slider, and this is the list of textures that are picked up for that by the exporter.

			=== Param Name Selector ===
			This scalar parameter value is used to select the texture from the Param Name List. It is only used if the Param Name List is also populated with textures.

			== Examples ==
	If you have a texture parameter, with no additional modification to it, leave all parameters within the Diffuse parameters list empty, except for the <code>Diffuse Texture Param > Param Name</code>:		If you have a texture parameter, with no additional modification to it, leave all parameters within the Diffuse parameters list empty, except for the <code>Diffuse Texture Param > Param Name</code>:

Hannah: /* Export Material User Data Diffuse Parameter Info */

2023-01-18T06:06:26Z

Export Material User Data Diffuse Parameter Info

← Older revision		Revision as of 23:06, 17 January 2023
Line 9:		Line 9:
	Because the workflows for the different textures are similar but entirely separate, The documentation for each texture is thusly separated.		Because the workflows for the different textures are similar but entirely separate, The documentation for each texture is thusly separated.

	== Export Material User Data Diffuse Parameter Info ==		== Add an Export Material User Data parameter to Your Material ==
			From the Details panel of the material, under the Material category, expand the parameters, and add, from the Asset User Data array, an Export Material User Data:

			[[File:ExportParameters AddExportUserData.jpg\|frameless]]

			== Diffuse Parameter Info ==
	The Diffuse EMUD is the only mandatory export parameter. All other parameters have defaults, but a material without a diffuse parameter set in the EMUD will not export correctly or at all.		The Diffuse EMUD is the only mandatory export parameter. All other parameters have defaults, but a material without a diffuse parameter set in the EMUD will not export correctly or at all.

Line 16:		Line 21:
	The diffuse parameters are split up into several sections that can be used or ignored as required. They are as such:		The diffuse parameters are split up into several sections that can be used or ignored as required. They are as such:

	* Colour Param		[[File:ExportParameters DiffuseParameters.jpg\|frameless]]
	** [Colour Parameters]
	** Diffuse Texture Param		The Colour Secondary Param is only necessary if you are doing a two-tone colour gradient using a texture as the alpha. That will be explained later.
	** Diffuse Texture ~~To Colour Lerp~~
	* Colour Secondary Param (Optional)		At least one parameter within either the Colour Parameters, or the Diffuse Texture Param, is necessary. All else is optional, or adds on top of these parameters.
	** [~~Secondary Colour Parameters~~]
	** Colour ~~Secondary Mask~~ Param		If you have a texture parameter, with no additional modification to it, leave all parameters within the Diffuse parameters list empty, except for the <code>Diffuse Texture Param > Param Name</code>:

			[[File:ExportParameters DiffuseParameterSet.jpg\|frameless]]

			If your diffuse value is instead a solid colour, leave all parameters within the diffuse parameters list empty, except for the <code>Colour Param > Param Name</code>:

			[[File:ExportParameters DiffuseParamName.jpg\|frameless]]

Hannah at 05:10, 9 January 2023

2023-01-09T05:10:57Z

@@ Line 1: / Line 1: @@
 The Export Material User Data is a translation layer for the Exporter. The exporter doesn't have access to the raw HLSL of the material in UE4, nor do most games or applications have a shader path that allows use of custom shaders. BeamNG.Drive, for example, has a static shader path, and as such, it is a constant struggle to get Automation's paints and materials to export nicely.
-The Export Material User Data contains the logic that the exporter can use for adjusting textures and the UVs of the exported meshes, in order to get a close approximation of Automation's materials, for use in other rendering engines.
+The Export Material User Data (or EMUD) contains the logic that the exporter can use for adjusting textures and the UVs of the exported meshes, in order to get a close approximation of Automation's materials, for use in other rendering engines.
-The layout and structure of the Export Material User Data must be kept in mind at all times during the creation of a Custom Paint or fixture material, as there are certain limitations that cannot be overcome.
+The layout and structure of the EMUD must be kept in mind at all times during the creation of a Custom Paint or fixture material, as there are certain limitations that cannot be overcome.

Hannah: Created page with "The Export Material User Data is a translation layer for the Exporter. The exporter doesn't have access to the raw HLSL of the material in UE4, nor do most games or applications have a shader path that allows use of custom shaders. BeamNG.Drive, for example, has a static shader path, and as such, it is a constant struggle to get Automation's paints and materials to export nicely. The Export Material User Data contains the logic that the exporter can use for adjusting te..."

2023-01-06T04:36:14Z

Created page with "The Export Material User Data is a translation layer for the Exporter. The exporter doesn't have access to the raw HLSL of the material in UE4, nor do most games or applications have a shader path that allows use of custom shaders. BeamNG.Drive, for example, has a static shader path, and as such, it is a constant struggle to get Automation's paints and materials to export nicely. The Export Material User Data contains the logic that the exporter can use for adjusting te..."

New page

The Export Material User Data is a translation layer for the Exporter. The exporter doesn't have access to the raw HLSL of the material in UE4, nor do most games or applications have a shader path that allows use of custom shaders. BeamNG.Drive, for example, has a static shader path, and as such, it is a constant struggle to get Automation's paints and materials to export nicely.

The Export Material User Data contains the logic that the exporter can use for adjusting textures and the UVs of the exported meshes, in order to get a close approximation of Automation's materials, for use in other rendering engines.

The layout and structure of the Export Material User Data must be kept in mind at all times during the creation of a Custom Paint or fixture material, as there are certain limitations that cannot be overcome.