Enfusion Blender Tools: Import/Export Animation – Arma Reforger

From Bohemia Interactive Community
Jump to navigation Jump to search
(Page creation)
 
(improved TXA exporter documentation)
Line 16: Line 16:
It exports animation data for Enfusion. To have an animation created in Blender in Enfusion, follow these steps:
It exports animation data for Enfusion. To have an animation created in Blender in Enfusion, follow these steps:


# Export the FBX model from Blender with an armature matching the animation you want to export
# [[#Export_FBX_from_Blender  |Export the FBX model from Blender with an armature matching the animation you want to export]]
# Import the FBX model into Enfusion
# [[#Import_FBX_to_Enfusion|Import the FBX model into Enfusion]]
# Export the animation from Blender (TXA format)
# [[#Export_Animation_from_Blender|Export the animation from Blender (TXA format)]]
# Import the animation TXA file into the Enfusion
# [[#Import_Animation_to_Enfusion|Import the animation TXA file into the Enfusion]]


{{Feature|informative|If you are trying to make animation to already existing character then you can skip directly to [[#Export_Animation_from_Blender|Export Animation from Blender ]] paragraph}}


== FBX ==
== FBX ==
Line 26: Line 27:
=== Export FBX from Blender ===
=== Export FBX from Blender ===


Set the pose mode to rest for a given skeleton to export the rig.
<gallery mode="packed-hover" heights=500px style="text-align:left" >
Image:armareforger-blender-txa-export-rest-position.png|Rest position
Image:armareforger-blender-txa-export-fbx-export.jpg|Blender FBX export settings
</gallery>
 
Set the pose mode to rest for a given skeleton to export the rig. When exporting this FBX, make sure that you uncheck '''Add leaf bones''' option.  


=== Import FBX to Enfusion ===
=== Import FBX to Enfusion ===
[[Image:armareforger-blender-txa-export-fbx-import.jpg|thumb|right|x500px|Import settings inside Workbench]]
[[Image:armareforger-blender-txa-export-register-as-anim.png]]


Import the model "As Model" and afterwards set import to import skinning too.
Import the model "As Model" and afterwards set import to import skinning too.
 
{{Clear}}


== Animation ==
== Animation ==
Line 37: Line 46:
=== Export Animation from Blender ===
=== Export Animation from Blender ===


Now define where to output the TXA file. Note that the file name set in the bottom input will not be used, only the location.
TXA Export is available in top section of viewport. From there, select '''Enfusion Tools -> Export -> Enfusion Animation (.txa)''' to initiate animation export.
 
[[Image:armareforger-blender-txa-export-toolbar.jpg|800px]]


All the profiles have to be in {{hl|anims\export_profiles}} or in a subdirectory.
Once that button is pressed, following window should be visible:


Select an export profile.
[[Image:armareforger-blender-txa-export-animation.jpg]]
 
In '''export section''' all animation takes related to selected Armature (picked in '''Armature name''' option) should be listed. By clicking on '''Show exports''' checkbox next to desired action name, it is possible to enable export of that animation and further define what action should be exported.
 
In '''export options''' section it is possible to change following things:
* Pick animation '''export profile'''. All the profiles have to be in {{hl|anims\export_profiles}} or in a subdirectory. By default, assuming [[Arma_Reforger:Enfusion_Blender_Tools#Installation|Enfusion Blender Tools Data]] was correctly installed, there should be dozens of available animation exports which were used on Reforger assets. Selected profile has to correspond with the skeleton - otherwise no animation will be exported.
* Select animation for difference animations. This is only used if additive animation export profile is used.
* Change '''file name''' of exported animation. If this field is empty, plugin will use action name for creation of new txa
 
{{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'''}}
 
Location of where TXA files will be generated can be changed by selecting different directory in the '''save location''' field in the top section of 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 '''Export TXA''' button in bottom right section of the export window.
 
{{Feature|important|Deepening on complexity of the animation (''character animations can be especially demanding''), export can take up to 4 minutes while using 100% of the CPU.}}


This profile has to correspond with the skeleton. Lastly, choose whether to export all takes together or just one specific.


If batch mode is selected then all animations will be exported with the same export profile.


=== Import Animation to Enfusion ===
=== Import Animation to Enfusion ===


Drag and drop the TXA file into the [[Arma Reforger:Resource Manager|Resource Browser]].
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.
 
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}}
{{GameCategory|armaR|Modding|Tutorials|Official Tools|Enfusion Blender Tools}}

Revision as of 15:57, 27 June 2022

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.

APR files are used for animations export. These files contain export profiles. Profiles can be found in anims\export_profiles. The export profile defines which bones to export and how to export them. Export profiles have to correspond with the used skeleton in the take.

It exports animation data for Enfusion. To have an animation created in Blender in Enfusion, follow these steps:

  1. Export the FBX model from Blender with an armature matching the animation you want to export
  2. Import the FBX model into Enfusion
  3. Export the animation from Blender (TXA format)
  4. Import the animation TXA file into the Enfusion
If you are trying to make animation to already existing character then you can skip directly to Export Animation from Blender paragraph

FBX

Export FBX from Blender

Set the pose mode to rest for a given skeleton to export the rig. When exporting this FBX, make sure that you uncheck Add leaf bones option.

Import FBX to Enfusion

Import settings inside Workbench

armareforger-blender-txa-export-register-as-anim.png

Import the model "As Model" and afterwards set import to import skinning too.

Animation

Export Animation from Blender

TXA Export is available in top section of viewport. From there, select Enfusion Tools -> Export -> Enfusion Animation (.txa) to initiate animation export.

armareforger-blender-txa-export-toolbar.jpg

Once that button is pressed, following window should be visible:

armareforger-blender-txa-export-animation.jpg

In export section all animation takes related to selected Armature (picked in Armature name option) should be listed. By clicking on Show exports checkbox next to desired action name, it is possible to enable export of that animation and further define what action should be exported.

In export options section it is possible to change following things:

  • Pick animation export profile. All the profiles have to be in anims\export_profiles or in a subdirectory. By default, assuming Enfusion Blender Tools Data was correctly installed, there should be dozens of available animation exports which were used on Reforger assets. Selected profile has to correspond with the skeleton - otherwise no animation will be exported.
  • Select animation for difference animations. This is only used if additive animation export profile is used.
  • Change file name of exported animation. If this field is empty, plugin will use action name for creation of new txa
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

Location of where TXA files will be generated can be changed by selecting different directory in the save location field in the top section of 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 Export TXA button in bottom right section of the export window.

Deepening on complexity of the animation (character animations can be especially demanding), export can take up to 4 minutes while using 100% of the CPU.


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 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.