Output: file formats, names and folders

The Output dropdown at the top of the Process tab decides what you get. The box at the bottom holds the name, the folder and the format options.

Output formats

The sections adjust to the format: a file always needs baked textures.

Name

The name of the file, and the prefix of every object, material and texture inside it. {name} stands for the name of the human, so the default {name} exports Jake as Jake.fbx with meshes like Jake_Body and textures like Jake_Body_BaseColor. Change it to Hero_{name} and you get Hero_Jake.fbx and Hero_Jake_Body. Spaces and odd characters become underscores.

Folder

Where the files go. Leave it empty for the export_results folder inside your Human Generator content folder (the folder from the add-on preferences). The grey line under the field always shows the folder that will be used. Paths starting with // are relative to your Blender file. The folder is created if it doesn't exist.

Advanced

Naming

How every object, mesh, material and texture in the file is named. Engines show these names, so a clean scheme saves renaming later.

With more than one LOD level the meshes get a _LOD0, _LOD1, … suffix, as the engines expect.

Textures

Where the baked textures end up:

• Textures folder (default): in a Textures folder next to the file.
• Next to file: in the same folder as the file.
• Embedded: inside the FBX or glb file, so you only hand over one file. glTF + textures always writes them next to the file.

Keep copy in this file

After the file is written, the processed copy normally disappears from your scene. Turn this on to keep it, for example to check the result in Blender or to render with the baked materials. The copy behaves like an In this file result, see below.

FBX options

The recipes set these for the engine, you rarely need to touch them. Forward and Up are the axes of the file (-Z forward, Y up is what Unity and Unreal read correctly). Primary and secondary bone axis orient the bones. Smoothing writes smoothing groups per face, per edge, or normals only. Triangulate writes triangles instead of quads. Leaf bones adds an extra bone at the end of every chain, which engines show as extra bones, so it is off. Custom properties also writes the custom properties of the objects.

glTF options

Images writes PNG, or JPEG where no alpha channel is needed (Auto), or always JPEG for smaller files. Tangents writes the tangents into the file instead of letting the engine compute them. Draco compression makes the file much smaller; the program that reads it needs to support Draco.

What is in the file

The skeleton, the body, the eyes, the teeth, the clothing and footwear, and the hair cards when Haircards is on. Particle hair is never exported, no file format can carry it. The processed copy is placed at the world origin before it is written, so the character stands at 0, 0, 0 in the engine regardless of where it is in your scene.

Processed copies

A processed copy is what In this file gives you, and what Keep copy in this file leaves behind. It stands two meters behind the original, in a collection called Processing Results, and it is frozen: a finished character rather than an editable human.

Select it and the Human Generator panel shows:

• Go to original human: selects the human it was made from, so you can keep editing there.
• Process again: processes the original once more with the exact settings this copy was made with. The way to update a copy after you changed the original.
• Load these settings: puts the settings of this copy into the Process tab, to export the same way or to make a variation.

You can rename, move, animate, render and delete a processed copy like any other object. The settings it was made with are stored on its rig, so they travel with it when you append it into another file.

settings.output.format = "glb"        # "in_file", "fbx", "glb", "gltf", "obj", "abc"
settings.output.name = "Hero_{name}"
settings.output.folder = "//export"   # relative to the blend file
settings.output.naming = "unreal"
settings.output.textures = "embedded"
result = human.process.run(settings)
result.files      # the written files
result.humans     # the processed copies left in the file
 
copy = result.humans[0]
copy.process.is_processed   # True
copy.process.settings       # the ExportSettings it was made with