Arma Reforger:Enfusion Blender Tools: Import/Export Animation - Revision history

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

2025-02-26T12:31:56Z

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

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

	If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in '''Resource Manager'''.		If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in '''Resource Manager'''.
	Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding~~\|Tutorials~~\|Official Tools\|Enfusion Blender Tools}}ymbolic links and won't be able to automatically register files in such cases. If such files		Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding\|Official Tools\|Enfusion Blender Tools\|Tutorials}}ymbolic links and won't be able to automatically register files in such cases. If such files

Reyhard: /* Troubleshooting */

2025-01-22T09:21:28Z

Troubleshooting

← Older revision		Revision as of 11:21, 22 January 2025
Line 85:		Line 85:
	If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in '''Resource Manager'''.		If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in '''Resource Manager'''.
	Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}ymbolic links and won't be able to automatically register files in such cases. If such files		Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}ymbolic links and won't be able to automatically register files in such cases. If such files


			====Unable to create metafile====
			If you get error like<syntaxhighlight lang="c">
			Enfusion Tools - TXA Export WARNING - TXA exported to ... but Workbench couldn't create metafile! Check the export path.
			</syntaxhighlight>


			It means selected file location is outside of any loaded by Workbench addons. Manual registration and import of file might be necessary afterwards.

Reyhard: /* TXA couldn't be registered */

2024-09-03T11:20:35Z

TXA couldn't be registered

← Older revision		Revision as of 13:20, 3 September 2024
Line 77:		Line 77:
	* Make sure that relative path option is disabled if you are trying to save TXA file on different drive than blend file is located		* Make sure that relative path option is disabled if you are trying to save TXA file on different drive than blend file is located

	==== TXA ~~couldn't be registered~~ ====		==== TXA registration failed (Unable to translate to relative path) ====
	If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in Resource Manager.		Possible causes:

			* Save location is outside of loaded projects in Workbench
			* Symbolic links are used

			If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in '''Resource Manager'''.
	Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}ymbolic links and won't be able to automatically register files in such cases. If such files		Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}ymbolic links and won't be able to automatically register files in such cases. If such files

Reyhard at 15:13, 2 September 2024

2024-09-02T15:13:48Z

← Older revision		Revision as of 17:13, 2 September 2024
Line 67:		Line 67:
	* Click on TXA with Right Mouse Button and select '''"Register and Import"''' option from the Context Menu.		* Click on TXA with Right Mouse Button and select '''"Register and Import"''' option from the Context Menu.

	Once animation is imported, .ANM file will be automatically regenerated every time Workbench detects change in .TXA. If TXA was modified when Workbench was closed, manual reimport might be necessary.{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}		Once animation is imported, .ANM file will be automatically regenerated every time Workbench detects change in .TXA. If TXA was modified when Workbench was closed, manual reimport might be necessary.

			=== Troubleshooting ===

			==== Incorrect save location ====

			* Make sure that location exist
			* Make sure that correct type of slashes are used when copy pasting path
			* Make sure that relative path option is disabled if you are trying to save TXA file on different drive than blend file is located

			==== TXA couldn't be registered ====
			If you see this warning, then be aware that automatic registration of txa animation is not going to work and you might need to manually register & import such file in Resource Manager.
			Currently tool is not able to resolve s{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}ymbolic links and won't be able to automatically register files in such cases. If such files

Reyhard: Updated EBT TXA documentation

2024-07-26T14:37:55Z

Updated EBT TXA documentation

← Older revision		Revision as of 16:37, 26 July 2024
Line 23:		Line 23:

	*'''Save location''' - folder where the exported actions will be stored. You can either type in the location or use '''Change save location''' button located on the right side		*'''Save location''' - folder where the exported actions will be stored. You can either type in the location or use '''Change save location''' button located on the right side
			**When changing location, it is possible to use '''relative path''' for saving the TXA - this is useful feature when collaborating with multiple people
	*'''Folder with export profiles -''' folder with animation export profiles which should be currently used. This list populated through '''Export Profile Folder''' parameter located in '''Enfusion Blender Tools settings.'''		*'''Folder with export profiles -''' folder with animation export profiles which should be currently used. This list populated through '''Export Profile Folder''' parameter located in '''Enfusion Blender Tools settings.'''
	*'''Armature name -''' name of the armature which will be used for export. Bone transformations from this armature are processed by the exporter and stored in exported TXA file. This parameter is only visible if you have more than one armature in the scene		*'''Armature name -''' name of the armature which will be used for export. Bone transformations from this armature are processed by the exporter and stored in exported TXA file. This parameter is only visible if you have more than one armature in the scene
	*'''Secondary armature name''' ''(optional)'' '''-''' name of the secondary armature which will be used during export . This is parameter is useful when armature which you want to export, is constrained to another armature and doesn't have any motion itself and you want to export multiple actions at once. In case of Rigify rig, in this field should be selected name of the Rigify control rig. This parameter is only visible if you have more than one armature in the scene		*'''Secondary armature name''' ''(optional)'' '''-''' name of the secondary armature which will be used during export . This is parameter is useful when armature which you want to export, is constrained to another armature and doesn't have any motion itself and you want to export multiple actions at once. In case of Rigify rig, in this field should be selected name of the Rigify control rig. This parameter is only visible if you have more than one armature in the scene
			*'''Hide -''' Collapses export profiles in all actions
			*'''Show''' - Expands export profiles in all actions
			*'''Disable''' - Disables export profiles in all '''visible''' (''expanded)'' actions
			*'''Enable''' - Disables export profiles in all '''visible''' (''expanded)'' actions
			*'''Search''' [[File:armareforger-blender-txa-search-icon.png\|22x22px]] - Filter visible actions. '''Confirm filtering by pressing enter.''' Only '''visible''' and '''expanded''' export profiles will be exported
			*'''Toggle Compact View''' [[File:armareforger-blender-txa-toggle-compact-view.png]] - Toggles between regular and more compact list of all actions

	====Action list====		====Action list====
	[[File:armareforger-blender-txa-export-animation-list.png]]		[[File:armareforger-blender-txa-export-animation-list.png]]

	'''Action list''' contains '''actions''' (marked in orange) found in the scene. [https://docs.blender.org/manual/en/latest/files/asset_libraries/introduction.html#bpy-ops-asset-mark Actions marked as assets] are hidden from this list. Each individual action has '''~~Show exports~~''' ~~checkbox~~, which controls the visibility of '''Action ~~export list~~''' - this option is quite useful when dealing with large amount of actions like on example picture above.{{Feature\|important\|If you '''don't see any action in the action list''', make sure your action is not marked as asset. See above description for more details}}		'''Action list''' contains '''actions''' (marked in orange) found in the scene. [https://docs.blender.org/manual/en/latest/files/asset_libraries/introduction.html#bpy-ops-asset-mark Actions marked as assets] are hidden from this list. Each individual action has an '''arrow''', which controls the visibility of '''Action Export List''' - this option is quite useful when dealing with large amount of actions like on example picture above.

			Please note that only '''expanded & visible''' actions are exported{{Feature\|important\|If you '''don't see any action in the action list''', make sure your action is not marked as asset. See above description for more details}}

	====Action export list====		====Action export list====
	[[File:armareforger-blender-txa-export-export-list.png]]		[[File:armareforger-blender-txa-export-export-list.png]]

	Action export list is the ~~heart~~ of TXA exporter. Over there it is possible to '''add exports ~~profiles~~''' & define '''how those actions will be processed'''. New entries in that list can be added by clicking on '''+''' button located on the right side.		Action export list is the hear of TXA exporter. Over there it is possible to '''add exports''' & define '''how those actions will be processed'''. New entries in that list can be added by clicking on '''+ Add''' button located on the right side. Removal of exports can be done in similar way by pressing '''X''' button on the right side.

	*'''Enable checkbox -''' control if this export is active or not. In inactive state '''no txa''' will be generated		*'''Enable checkbox -''' control if this export is active or not. In inactive state '''no txa''' will be generated
Line 42:		Line 51:
	*'''Diff pose''' ''(optional)'' - name of the action which will be used as difference target for additive transformations. If you are using animation profile which doesn't have any additive transformations, you can leave that field empty		*'''Diff pose''' ''(optional)'' - name of the action which will be used as difference target for additive transformations. If you are using animation profile which doesn't have any additive transformations, you can leave that field empty
	*'''Diff pose frame''' ''(optional)'' - frame of '''diff pose''' which will be used as a base for additive animations export		*'''Diff pose frame''' ''(optional)'' - frame of '''diff pose''' which will be used as a base for additive animations export
			*'''Additional armature''' ''(''optional'')'' - Bones from this armature will be considered during the export. It can be used in export of vehicle animation, where you have door & character movement keyframed in single action - this way you don't have to switch between main Armature names
	{{Feature\|warning\|Selecting proper '''export profile''' is crucial for correct export of animation! In case of custom rig, it might be necessary to create '''custom animation export profiles'''}}		{{Feature\|warning\|Selecting proper '''export profile''' is crucial for correct export of animation! In case of custom rig, it might be necessary to create '''custom animation export profiles'''}}


	Once all desired animation actions are selected and properly configured for export (meaning they have '''correct animation export profile''' selected), it is now possible to finally perform export to TXA. To do so, press '''OK''' button in bottom section of the export window.		Once all desired animation actions are selected and properly configured for export (meaning they have '''correct animation export profile''' selected), it is now possible to finally perform export to TXA. To do so, press '''OK''' button in bottom section of the export window.
	~~====Default Profile====~~

	===Import animation to Enfusion===		===Import animation to Enfusion===
	~~Once TXA~~ is ~~generated~~, there are two ways how to ~~convert TXA into .ANM file~~:
	*Drag and drop the TXA file into the [[Arma Reforger:Resource Manager\|Resource Browser]].
	*Click on TXA with Right Mouse Button and select '''"Register and Import"''' option from the Context Menu.		By default, '''Enfusion Blender Tools''' will try to '''automatically register & import animation''' if save location is located in one of the currently loaded addons.
	Once animation is imported, .ANM file will be automatically regenerated every time Workbench detects change in .TXA. If TXA was modified when Workbench was closed, manual reimport might be necessary.
	{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}		If you are using '''symbolic links''', then it might be necessary to manually register and import TXA animation - there are two ways how to do it:

			* Drag and drop the TXA file into the [[Arma Reforger:Resource Manager\|Resource Browser]].
			* Click on TXA with Right Mouse Button and select '''"Register and Import"''' option from the Context Menu.

			Once animation is imported, .ANM file will be automatically regenerated every time Workbench detects change in .TXA. If TXA was modified when Workbench was closed, manual reimport might be necessary.{{GameCategory\|armaR\|Modding\|Tutorials\|Official Tools\|Enfusion Blender Tools}}

Reyhard: removed segment about exporting FBX

2024-03-07T11:59:41Z

removed segment about exporting FBX

@@ Line 1: / Line 1: @@
-{{TOC|side}}Animations for Enfusion are exported into an intermediate human-readable format TXA. This format needs to be further compiled by the Enfusion engine into ANM - a binary format used during the runtime.<!--
+{{TOC|side}}Animations for Enfusion are exported into an intermediate human-readable format TXA. This format needs to be further compiled by the Enfusion engine into ANM - a binary format used during the runtime.
 ==Animation==
 ===Export animations from Blender===

Reyhard at 17:56, 15 May 2023

2023-05-15T17:56:01Z

← Older revision		Revision as of 19:56, 15 May 2023
Line 55:		Line 55:
	[[File:armareforger-blender-txa-export-animation-list.png]]		[[File:armareforger-blender-txa-export-animation-list.png]]

	'''Action list''' contains '''actions''' (marked in orange) found in the scene. [https://docs.blender.org/manual/en/latest/files/asset_libraries/introduction.html#bpy-ops-asset-mark Actions marked as assets] are hidden from this list. Each individual action has '''Show exports''' checkbox, which controls the visibility of '''Action export list''' - this option is quite useful when dealing with large amount of actions like on example picture above.		'''Action list''' contains '''actions''' (marked in orange) found in the scene. [https://docs.blender.org/manual/en/latest/files/asset_libraries/introduction.html#bpy-ops-asset-mark Actions marked as assets] are hidden from this list. Each individual action has '''Show exports''' checkbox, which controls the visibility of '''Action export list''' - this option is quite useful when dealing with large amount of actions like on example picture above.{{Feature\|important\|If you '''don't see any action in the action list''', make sure your action is not marked as asset. See above description for more details}}

	====Action export list====		====Action export list====

Reyhard: /* Export animations from Blender */

2023-05-09T12:44:01Z

Export animations from Blender

← Older revision		Revision as of 14:44, 9 May 2023
Line 30:		Line 30:

	*at least one '''Armature''' & '''Action''' present in the current scene		*at least one '''Armature''' & '''Action''' present in the current scene
	*at least one folder is defined in '''Export Profile Folder''' with some valid animation export profiles (see [[Arma_Reforger:Enfusion_Blender_Tools#Installation\|'''Enfusion Blender Tools''']] page for instructions)		*at least one folder is defined in '''Export Profile Folder''' with some valid animation export profiles ''(see [[Arma_Reforger:Enfusion_Blender_Tools#Installation\|'''Enfusion Blender Tools''']] page for instructions)''
	*		*
	*running '''Workbench''' with '''net API enabled'''		*running '''Workbench''' with '''net API enabled''' ''(see '''[[Arma_Reforger:Enfusion_Blender_Tools#Installation\|Enfusion Blender Tools]]''' page for instructions)''

	If all above conditions are meet, from top bar select '''Enfusion Tools -> Export -> Enfusion Animation (.txa)''' to initiate animation export.		If all above conditions are meet, from top bar select '''Enfusion Tools -> Export -> Enfusion Animation (.txa)''' to initiate animation export.

Reyhard: /* Action list */

2023-03-13T15:50:56Z

Action list

← Older revision		Revision as of 17:50, 13 March 2023
Line 55:		Line 55:
	[[File:armareforger-blender-txa-export-animation-list.png]]		[[File:armareforger-blender-txa-export-animation-list.png]]

	'''Action list''' contains '''actions''' (marked in orange) found in the scene. Actions marked as assets are hidden from this list. Each individual action has '''Show exports''' checkbox, which controls the visibility of '''Action export list''' - this option is quite useful when dealing with large amount of actions like on example picture above.		'''Action list''' contains '''actions''' (marked in orange) found in the scene. [https://docs.blender.org/manual/en/latest/files/asset_libraries/introduction.html#bpy-ops-asset-mark Actions marked as assets] are hidden from this list. Each individual action has '''Show exports''' checkbox, which controls the visibility of '''Action export list''' - this option is quite useful when dealing with large amount of actions like on example picture above.

	====Action export list====		====Action export list====

Reyhard: /* Top section */

2023-02-27T14:01:01Z

Top section

← Older revision		Revision as of 16:01, 27 February 2023
Line 49:		Line 49:
	*'''Save location''' - folder where the exported actions will be stored. You can either type in the location or use '''Change save location''' button located on the right side		*'''Save location''' - folder where the exported actions will be stored. You can either type in the location or use '''Change save location''' button located on the right side
	*'''Folder with export profiles -''' folder with animation export profiles which should be currently used. This list populated through '''Export Profile Folder''' parameter located in '''Enfusion Blender Tools settings.'''		*'''Folder with export profiles -''' folder with animation export profiles which should be currently used. This list populated through '''Export Profile Folder''' parameter located in '''Enfusion Blender Tools settings.'''
	*'''Armature name -''' name of the armature which will be used for export. Bone transformations from this armature are processed by the exporter and stored in exported TXA file.		*'''Armature name -''' name of the armature which will be used for export. Bone transformations from this armature are processed by the exporter and stored in exported TXA file. This parameter is only visible if you have more than one armature in the scene
	*'''Secondary armature name''' ''(optional)'' '''-''' name of the secondary armature which will be used during export . This is parameter is useful when armature which you want to export, is constrained to another armature and doesn't have any motion itself and you want to export multiple actions at once. In case of Rigify rig, in this field should be selected name of the Rigify control rig.		*'''Secondary armature name''' ''(optional)'' '''-''' name of the secondary armature which will be used during export . This is parameter is useful when armature which you want to export, is constrained to another armature and doesn't have any motion itself and you want to export multiple actions at once. In case of Rigify rig, in this field should be selected name of the Rigify control rig. This parameter is only visible if you have more than one armature in the scene

	====Action list====		====Action list====