Arma Reforger:Enfusion Blender Tools: Materials Preview - Revision history

Lou Montana: Text replacement - "\{\{GameCategory\|armaR\|Modding\|(Guidelines|Tutorials)\|([^=↵]*)\}\}" to "{{GameCategory|armaR|Modding|$2|$1}}"

2025-02-26T12:31:57Z

Text replacement - "\{\{GameCategory\|armaR\|Modding\|(Guidelines|Tutorials)\|([^=↵]*)\}\}" to "{{GameCategory|armaR|Modding|$2|$1}}"

← Older revision		Revision as of 14:31, 26 February 2025
Line 140:		Line 140:


	{{GameCategory\|armaR\|Modding~~\|Tutorials~~\|Official Tools\|Enfusion Blender Tools}}		{{GameCategory\|armaR\|Modding\|Official Tools\|Enfusion Blender Tools\|Tutorials}}

Lou Montana: Add FBX/Material export

2023-11-09T15:17:13Z

Add FBX/Material export

@@ Line 11: / Line 11: @@
 * PBR implementation in Blender and Enfusion is different
-* there's currently no Shader API in Blender (EEVEE) that could be used to write Enfusion shader "twin", instead Shader Editor has to be used to manually build up a material by connecting various nodes together<!--
+* there's currently no Shader API in Blender (EEVEE) that could be used to write Enfusion shader "twin", instead Shader Editor has to be used to manually build up a material by connecting various nodes together<br><!--
 -->[[File:armareforger-ebt_materialspreview_shadereditor_1.png|500px]]<!--
 -->[[File:armareforger-ebt_materialspreview_shadereditor_2.png|469px]]
@@ Line 42: / Line 42: @@
 Logs provides valuable information in case some materials or textures could not be loaded.
 [[File:armareforger-ebt_materialspreview_material_sync.png|thumb]]
 === Materials Synchronisation ===
@@ Line 77: / Line 117: @@
 === Debug Channels ===
-{|
+{| class="valign-top"
 | style="width: 33%" |
 Users can take advantage of debug channels like in Workbench.

Lou Montana: Fix some data

2023-03-20T09:55:45Z

Fix some data

← Older revision		Revision as of 11:55, 20 March 2023
Line 29:		Line 29:

	* FBX is registered in Workbench (xob and xob.meta files already exists)		* FBX is registered in Workbench (xob and xob.meta files already exists)
	* path to your addon (mod) folder is properly set in EBT addon preferences (EBT will search for source textures there)<br><!--
	~~-->[[File:armareforger-ebt_materialspreview_fbximport_path.png]]~~
	* meshes have materials assigned		* meshes have materials assigned

Line 71:		Line 69:
	{{Feature\|important\|		{{Feature\|important\|
	Do not manually edit text field in texture slots widgets!		Do not manually edit text field in texture slots widgets!

	[[File:armareforger-ebt_materialspreview_textureslot_field.png]]		[[File:armareforger-ebt_materialspreview_textureslot_field.png]]

	User ~~has to use~~ only ~~textures from one of the addon folders defined in Enfusion Tools preferences, in other words,~~ texture ~~must be~~ already registered (~~have~~ meta file).		User can only set a texture that has been already registered (has meta file).
	}}		}}

Line 82:		Line 81:
	\| style="width: 33%" \|		\| style="width: 33%" \|
	Users can take advantage of debug channels like in Workbench.		Users can take advantage of debug channels like in Workbench.

	[[File:armareforger-ebt_materialspreview_debugchannels.png]]		[[File:armareforger-ebt_materialspreview_debugchannels.png]]

	Supported channels:		Supported channels:
	* None		* None

Lou Montana: Remove TODO

2022-06-13T10:01:46Z

Remove TODO

← Older revision		Revision as of 12:01, 13 June 2022
Line 1:		Line 1:
	{{TOC\|side}}		{{TOC\|side}}
	~~{{Wiki\|TODO\|add images}}~~
	'''Materials Preview''' (referenced as MP in this document) feature allows to mimic Enfusion shaders in Blender to visually assist users while creating a model from scratch, to help creating additional data like baking textures for last LODs and more.		'''Materials Preview''' (referenced as MP in this document) feature allows to mimic Enfusion shaders in Blender to visually assist users while creating a model from scratch, to help creating additional data like baking textures for last LODs and more.
	MP feature currently supports loading of '''MatPBRBasic, MatPBRMulti, MatPBRDecal, MatPBRBasicGlass''' shader classes.		MP feature currently supports loading of '''MatPBRBasic, MatPBRMulti, MatPBRDecal, MatPBRBasicGlass''' shader classes.

Lou Montana: Add more images

2022-06-13T10:00:30Z

Add more images

← Older revision		Revision as of 12:00, 13 June 2022
Line 65:		Line 65:
	User can edit material's properties by selecting one of the material slots and panels change according to selected Enfusion shader type (PBRBasic, PBRMulti, etc.).		User can edit material's properties by selecting one of the material slots and panels change according to selected Enfusion shader type (PBRBasic, PBRMulti, etc.).

	{{Feature\|informative\|User can leave any UV source widget blank in case first UV set supposed to be used.}}		{{Feature\|informative\|User can leave any UV source widget blank in case first UV set supposed to be used.<br>
			[[File:armareforger-ebt_materialspreview_uv_1.png]]
			[[File:armareforger-ebt_materialspreview_uv_2.png]]
			}}

	{{Feature\|important\|		{{Feature\|important\|
	Do not manually edit text field in texture slots widgets!		Do not manually edit text field in texture slots widgets!
			[[File:armareforger-ebt_materialspreview_textureslot_field.png]]

	User has to use only textures from one of the addon folders defined in Enfusion Tools preferences, in other words, texture must be already registered (have meta file).		User has to use only textures from one of the addon folders defined in Enfusion Tools preferences, in other words, texture must be already registered (have meta file).
Line 79:		Line 83:
	\| style="width: 33%" \|		\| style="width: 33%" \|
	Users can take advantage of debug channels like in Workbench.		Users can take advantage of debug channels like in Workbench.
	~~See the feature's location and list of supported debug~~ channels ~~below~~:		[[File:armareforger-ebt_materialspreview_debugchannels.png]]
			Supported channels:
	* None		* None
	* Albedo		* Albedo

Lou Montana: Add more images

2022-06-13T09:51:40Z

Add more images

← Older revision		Revision as of 11:51, 13 June 2022
Line 3:		Line 3:
	'''Materials Preview''' (referenced as MP in this document) feature allows to mimic Enfusion shaders in Blender to visually assist users while creating a model from scratch, to help creating additional data like baking textures for last LODs and more.		'''Materials Preview''' (referenced as MP in this document) feature allows to mimic Enfusion shaders in Blender to visually assist users while creating a model from scratch, to help creating additional data like baking textures for last LODs and more.
	MP feature currently supports loading of '''MatPBRBasic, MatPBRMulti, MatPBRDecal, MatPBRBasicGlass''' shader classes.		MP feature currently supports loading of '''MatPBRBasic, MatPBRMulti, MatPBRDecal, MatPBRBasicGlass''' shader classes.
	MP feature focuses mainly to support(mimic) core functionality of particular shaders wherever possible, good example is PBRMulti shader, its core functionality is based on layering several materials and textures on top of each other by using various masks.		MP feature focuses mainly to support (mimic) core functionality of particular shaders wherever possible, good example is PBRMulti shader, its core functionality is based on layering several materials and textures on top of each other by using various masks.

	[[File:armareforger-ebt_materialspreview_comparison1.jpg\|400px]] [[File:armareforger-ebt_materialspreview_comparison2.jpg\|500px]]		[[File:armareforger-ebt_materialspreview_comparison1.jpg\|400px]] [[File:armareforger-ebt_materialspreview_comparison2.jpg\|500px]]
Line 9:		Line 9:

	[[File:armareforger-ebt_materialpreview_compression_difference.png\|thumb\|because of compression there may be visual differences spotted for example when playing with Alpha Test/Alpha Mul parameters]]		[[File:armareforger-ebt_materialpreview_compression_difference.png\|thumb\|because of compression there may be visual differences spotted for example when playing with Alpha Test/Alpha Mul parameters]]
	Please be aware that even though both Blender and Enfusion uses PBR pipeline, it's necessary to point out few facts that makes delivery of exactly the same visual experience in Blender(EEVEE renderer) impossible:		Please be aware that even though both Blender and Enfusion uses PBR pipeline, it's necessary to point out few facts that makes delivery of exactly the same visual experience in Blender (EEVEE renderer) impossible:

	* PBR implementation in Blender and Enfusion is different		* PBR implementation in Blender and Enfusion is different
	* there's currently no Shader API in Blender(EEVEE) that could be used to write Enfusion shader "twin", instead Shader Editor has to be used to manually build up a material by connecting various nodes together		* there's currently no Shader API in Blender (EEVEE) that could be used to write Enfusion shader "twin", instead Shader Editor has to be used to manually build up a material by connecting various nodes together<!--
			-->[[File:armareforger-ebt_materialspreview_shadereditor_1.png\|500px]]<!--
			-->[[File:armareforger-ebt_materialspreview_shadereditor_2.png\|469px]]
	* nodes provided by Shader Editor doesn't allow to access things like GBuffer or scene lighting information therefore some specific material's properties can't be supported via MP feature		* nodes provided by Shader Editor doesn't allow to access things like GBuffer or scene lighting information therefore some specific material's properties can't be supported via MP feature
	* PP effects implementation in Blender is different, some PP effects aren't implemented at all		* PP effects implementation in Blender is different, some PP effects aren't implemented at all
	* shaders in Blender use source texture formats(tif,png...) whereas shaders in Enfusion use compressed edds textures		* shaders in Blender use source texture formats (tif, png...) whereas shaders in Enfusion use compressed edds textures


Line 22:		Line 24:
	=== Materials Import ===		=== Materials Import ===

	EBT provides custom FBX Import via '''EnfusionTools''' menu, that imports meshes with Enfusion materials.		EBT provides custom FBX Import via '''EnfusionTools''' menu, that imports meshes with Enfusion materials.<br>
			[[File:armareforger-ebt_materialspreview_fbximport_menu.png]]

	In order to successfully import meshes with Enfusion materials, it's expected that:		In order to successfully import meshes with Enfusion materials, it's expected that:

	* FBX is registered in Workbench(xob and xob.meta files already exists)		* FBX is registered in Workbench (xob and xob.meta files already exists)
	* path to your addon(mod) folder is properly set in EBT addon preferences(EBT will search for source textures there)		* path to your addon (mod) folder is properly set in EBT addon preferences (EBT will search for source textures there)<br><!--
			-->[[File:armareforger-ebt_materialspreview_fbximport_path.png]]
	* meshes have materials assigned		* meshes have materials assigned

	{{Feature\|important\|Materials Preview feature can only import materials/textures from within your own addon(expects source textures to be in PNG,TIFF... format), in other words you cannot import materials inherited from Vanilla Reforger.}}		{{Feature\|important\|Materials Preview feature can only import materials/textures from within your own addon (expects source textures to be in PNG, TIFF... format), in other words you cannot import materials inherited from Vanilla Reforger.}}

	Loading time depends on model's complexity as well as total number of unique materials/textures that need to be loaded.		Loading time depends on model's complexity as well as total number of unique materials/textures that need to be loaded.

	Once loading is done, a log of issues(in case there are any) is provided. You can access the log by changing one of the editors to '''INFO''' editor.		Once loading is done, a log of issues (in case there are any) is provided. You can access the log by changing one of the editors to '''INFO''' editor.
			[[File:armareforger-ebt_materialspreview_fbximport_infowindow_menu.png]]

	~~Log provides valuable information in case some materials or textures could not be loaded~~.		[[File:armareforger-ebt_materialspreview_fbximport_infowindow_example.png\|800px]]<br>Example of an issue

	<!-~~- Example of an issue -->~~		Logs provides valuable information in case some materials or textures could not be loaded.

			[[File:armareforger-ebt_materialspreview_material_sync.png\|thumb]]
	=== Materials Synchronisation ===		=== Materials Synchronisation ===

Line 45:		Line 52:
	Valid (absolute) path to xob.meta file has to be provided, note that during EBT custom FBX Import this path gets filled automatically if such file exists.		Valid (absolute) path to xob.meta file has to be provided, note that during EBT custom FBX Import this path gets filled automatically if such file exists.

	In case user creates an asset from scratch, before using '''Update Materials''' for the first time, FBX must be exported and registered in Workbench, this creates xob.meta file that holds materials mapping, material's name(in Blender) → Enfusion material(emat).		In case user creates an asset from scratch, before using '''Update Materials''' for the first time, FBX must be exported and registered in Workbench, this creates xob.meta file that holds materials mapping, material's name (in Blender) → Enfusion material (emat).

	Make sure that changes made to a material in Workbench get saved before '''Update Materials''' button is pressed.		Make sure that changes made to a material in Workbench get saved before '''Update Materials''' button is pressed.
			{{Clear}}

			[[File:armareforger-ebt_materialspreview_materialsediting_ui.png\|right\|300px]]
	=== Materials Editing ===		=== Materials Editing ===

Line 61:		Line 70:
	Do not manually edit text field in texture slots widgets!		Do not manually edit text field in texture slots widgets!

	User has to use only textures from one of the addon folders defined in Enfusion Tools preferences, in other words, texture must be already registered(~~has~~ meta file).		User has to use only textures from one of the addon folders defined in Enfusion Tools preferences, in other words, texture must be already registered (have meta file).
	}}		}}

Lou Montana: Add main images

2022-06-06T15:29:21Z

Add main images

← Older revision		Revision as of 17:29, 6 June 2022
Line 5:		Line 5:
	MP feature focuses mainly to support(mimic) core functionality of particular shaders wherever possible, good example is PBRMulti shader, its core functionality is based on layering several materials and textures on top of each other by using various masks.		MP feature focuses mainly to support(mimic) core functionality of particular shaders wherever possible, good example is PBRMulti shader, its core functionality is based on layering several materials and textures on top of each other by using various masks.

			[[File:armareforger-ebt_materialspreview_comparison1.jpg\|400px]] [[File:armareforger-ebt_materialspreview_comparison2.jpg\|500px]]


			[[File:armareforger-ebt_materialpreview_compression_difference.png\|thumb\|because of compression there may be visual differences spotted for example when playing with Alpha Test/Alpha Mul parameters]]
	Please be aware that even though both Blender and Enfusion uses PBR pipeline, it's necessary to point out few facts that makes delivery of exactly the same visual experience in Blender(EEVEE renderer) impossible:		Please be aware that even though both Blender and Enfusion uses PBR pipeline, it's necessary to point out few facts that makes delivery of exactly the same visual experience in Blender(EEVEE renderer) impossible:

Line 12:		Line 16:
	* PP effects implementation in Blender is different, some PP effects aren't implemented at all		* PP effects implementation in Blender is different, some PP effects aren't implemented at all
	* shaders in Blender use source texture formats(tif,png...) whereas shaders in Enfusion use compressed edds textures		* shaders in Blender use source texture formats(tif,png...) whereas shaders in Enfusion use compressed edds textures
	** because of compression there may be visual differences spotted for example when playing with Alpha Test/Alpha Mul parameters


Line 63:		Line 66:
	=== Debug Channels ===		=== Debug Channels ===

			{\|
			\|- style="vertical-align: top"
			\| style="width: 33%" \|
	Users can take advantage of debug channels like in Workbench.		Users can take advantage of debug channels like in Workbench.
	See the feature's location and list of supported debug channels below:		See the feature's location and list of supported debug channels below:
Line 71:		Line 77:
	* World Normals		* World Normals
	* Mask		* Mask
			\| style="min-width: 600px" \|
	<!-- ~~Examples~~: -->		<gallery mode="slideshow" showthumbnails style="margin-top: 0">
			File:armareforger-ebt_materialspreview_debugchannel_normals.jpg\|Normals
			File:armareforger-ebt_materialspreview_debugchannel_roughness.jpg\|Roughness
			File:armareforger-ebt_materialspreview_debugchannel_mask.jpg\|Mask
			File:armareforger-ebt_materialspreview_debugchannel_albedo.jpg\|Albedo
			</gallery>
			\|}


	{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}		{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}

Lou Montana: Page creation

2022-06-06T09:33:20Z

Page creation

New page

{{TOC|side}}
{{Wiki|TODO|add images}}
'''Materials Preview''' (referenced as MP in this document) feature allows to mimic Enfusion shaders in Blender to visually assist users while creating a model from scratch, to help creating additional data like baking textures for last LODs and more.
MP feature currently supports loading of '''MatPBRBasic, MatPBRMulti, MatPBRDecal, MatPBRBasicGlass''' shader classes.
MP feature focuses mainly to support(mimic) core functionality of particular shaders wherever possible, good example is PBRMulti shader, its core functionality is based on layering several materials and textures on top of each other by using various masks.

Please be aware that even though both Blender and Enfusion uses PBR pipeline, it's necessary to point out few facts that makes delivery of exactly the same visual experience in Blender(EEVEE renderer) impossible:

* PBR implementation in Blender and Enfusion is different
* there's currently no Shader API in Blender(EEVEE) that could be used to write Enfusion shader "twin", instead Shader Editor has to be used to manually build up a material by connecting various nodes together
* nodes provided by Shader Editor doesn't allow to access things like GBuffer or scene lighting information therefore some specific material's properties can't be supported via MP feature
* PP effects implementation in Blender is different, some PP effects aren't implemented at all
* shaders in Blender use source texture formats(tif,png...) whereas shaders in Enfusion use compressed edds textures
** because of compression there may be visual differences spotted for example when playing with Alpha Test/Alpha Mul parameters

== Features ==

=== Materials Import ===

EBT provides custom FBX Import via '''EnfusionTools''' menu, that imports meshes with Enfusion materials.

In order to successfully import meshes with Enfusion materials, it's expected that:

* FBX is registered in Workbench(xob and xob.meta files already exists)
* path to your addon(mod) folder is properly set in EBT addon preferences(EBT will search for source textures there)
* meshes have materials assigned

{{Feature|important|Materials Preview feature can only import materials/textures from within your own addon(expects source textures to be in PNG,TIFF... format), in other words you cannot import materials inherited from Vanilla Reforger.}}

Loading time depends on model's complexity as well as total number of unique materials/textures that need to be loaded.

Once loading is done, a log of issues(in case there are any) is provided. You can access the log by changing one of the editors to '''INFO''' editor.

Log provides valuable information in case some materials or textures could not be loaded.


=== Materials Synchronisation ===

The feature let user to keep materials synced with Enfusion after FBX Import, in case user makes a change to material in Workbench (changing texture or value), pressing '''Update Materials''' button will reflect these changes in Blender.

Valid (absolute) path to xob.meta file has to be provided, note that during EBT custom FBX Import this path gets filled automatically if such file exists.

In case user creates an asset from scratch, before using '''Update Materials''' for the first time, FBX must be exported and registered in Workbench, this creates xob.meta file that holds materials mapping, material's name(in Blender) → Enfusion material(emat).

Make sure that changes made to a material in Workbench get saved before '''Update Materials''' button is pressed.

=== Materials Editing ===

Along with Materials import, EBT also allows users to edit supported Enfusion materials. For this, custom panels were added to '''Material Properties'''.
Note that editing material's properties is local right now, it means that changes can't be exported to Workbench.

User can edit material's properties by selecting one of the material slots and panels change according to selected Enfusion shader type (PBRBasic, PBRMulti, etc.).

{{Feature|informative|User can leave any UV source widget blank in case first UV set supposed to be used.}}

{{Feature|important|
Do not manually edit text field in texture slots widgets!

User has to use only textures from one of the addon folders defined in Enfusion Tools preferences, in other words, texture must be already registered(has meta file).
}}

=== Debug Channels ===

Users can take advantage of debug channels like in Workbench.
See the feature's location and list of supported debug channels below:
* None
* Albedo
* Roughness
* Metallic
* World Normals
* Mask



{{GameCategory|armaR|Modding|Tutorials|Official Tools|Enfusion Blender Tools}}