Contents3 sections
meshfx runs on the hosted API: try it in the Playground.
Errors and exits
| Exit | Codes | Meaning |
|---|---|---|
| 0 | Done. Warnings, if any, are in the report. | |
| 1 | BAD_SCALE, SOURCE_MISSING, TARGET_LIMIT | The spec or the command is wrong; the message names the key and what it accepts. |
| 2 | STAGE_FAILED, GPU_ERROR, OUT_OF_MEMORY | A step could not make a valid result. |
| 3 | FILE_READ, FILE_WRITE, MODEL_INVALID, JOINTS_NEED_TREE, JOINT_REBUILD_UNSUPPORTED, MODEL_UNSUPPORTED, MODEL_EMPTY, TEXTURE_UNREADABLE, SKIN_NOT_SUPPORTED | A file could not be read, used or written; the message names it. |
| 4 | NO_GPU | Only for an unavailable stage. |
| 5 | BUDGET_EXCEEDED | The run finished and wrote every file, but missed a [budget] limit. |
Warnings and settings
| Warning | Key to change |
|---|---|
NON_MANIFOLD_EDGES | repair.remesh |
FLIPPED_NORMALS | repair.fix_winding |
OPEN_HOLES | repair.fill_holes |
DUPLICATE_VERTICES | repair.weld_m |
ZERO_AREA_FACES | repair.enabled |
BAD_SCALE | units.size_m |
POSE_NOT_READY | pose.expect |
WRONG_PIVOT | units.pivot |
UV_OVERLAP | uv.mode, uv.lightmap |
UV_OUT_OF_RANGE | uv.mode |
UV_STRETCH_HIGH | uv.iterations |
UV_FALLBACK | uv.time_limit_s, uv.padding_px |
TEXEL_DENSITY_LOW | textures.size_px |
SELF_INTERSECTIONS | repair.remesh |
HIDDEN_GEOMETRY | repair.remove_hidden |
JOINT_PART_FLOOR | lod.triangles, simplify.triangles, repair.enabled |
JOINT_NORMAL_NEEDS_UV | uv.mode |
FLOATERS_REMOVED | repair.floaters |
REPAIR_REJECTED | repair.max_error |
NOT_WATERTIGHT | repair.remesh |
ZERO_THICKNESS | repair.thicken_m |
LOD_BUDGET_MISSED | simplify.max_error, lod.max_error, lod.count, lod.triangles, simplify.protect, simplify.forbid, uv.mode |
SILHOUETTE_CHANGED | simplify.triangles |
PART_LOST | simplify.triangles |
LOD_FAULTS_ADDED | simplify.triangles, lod.ratio, simplify.forbid |
BAKE_MISSES | bake.max_distance |
BAKE_MISMATCH | bake.max_distance |
BAKED_LIGHTING | textures.delight |
ALBEDO_OUT_OF_RANGE | textures.pbr_check |
TEXTURE_DOWNSIZED | textures.size_px, budget.max_texture_px, budget.max_bytes |
MATERIAL_SIMPLIFIED | textures.atlas |
ATTRIBUTE_DROPPED | uv.lightmap |
ANIMATION_DROPPED | source.skin |
COLLISION_LOOSE | collision.max_hulls |
COLLISION_CAPPED | collision.max_hulls |
OCCLUDER_SKIPPED | occluder.inset |
STAGE_NOT_BUILT | collision.mode |
Read the full report before using a result. A finished compile can still miss a budget; exit code 5 keeps all output files.
Questions
What does exit code 5 mean in meshfx?
Exit code 5 means BUDGET_EXCEEDED, so the run finished and wrote every file but missed a budget limit.
Which warning appears if a triangle target is too low for a rigid part?
A triangle target below the rigid part floor triggers JOINT_PART_FLOOR and names lod.triangles, simplify.triangles or repair.enabled to adjust.
What is the difference between exit code 1 and exit code 3 in meshfx?
Exit code 1 means the spec or command is wrong, while exit code 3 means a file could not be read, used or written.