Files

Opening files and mesh repair

Atlasmith opens OBJ, FBX, STL and Alembic meshes of any size, keeps their quads, polygroups and normals, and checks every mesh for problems as it opens. Repair mesh fixes them in one click.

Opening a mesh

  • Open in the top bar (Ctrl+O), or Open ▾ for the menu.
  • Recent files: Ctrl+R.
  • Drop the file on the window.
  • From the command line or a shortcut: Atlasmith.exe "C:\path\mesh.obj".

Opening a big file can be cancelled with Esc. Dropping a mesh while one is loaded asks Open as new mesh (the default) or Use as high-poly for the bake.

Supported formats

FormatWhat is read
OBJPositions, polygons (quads and n-gons kept), UVs, normals, groups (as polygroups).
FBX (binary and ASCII)Every mesh with its transform, several objects merged (each one a polygroup), quads and n-gons, the first UV set, normals. Converted to Y up in centimetres, so a Z-up file in inches or metres comes in the right way up. Materials and animation are ignored.
STLTriangles. STL has no UVs, so Quick export writes it as OBJ.
Alembic (.abc)Positions, polygons, UVs, normals.
Atlasmith project (.atlas)The whole work, see Saving a project.

The file's UVs

When a file already has UVs, Atlasmith asks "Use the UVs in the file?":

  • Use its UVs: they become the layout, and their island borders become the seams. Cut, weld, U and P work on them.
  • Start without UVs: every part starts as one not-flat island (grey in the UV view). Cut your own seams, or use Select seams.

To answer this once and for all, use Open with the file's UVs (asked at open) in Options > General.

To bring in UVs later, from another file of the same mesh, use Open ▾ > UVs from a file of this mesh…, see UVs from a file.

Polygons, polygroups and normals

Quads and n-gons

Polygons stay polygons: quads stay whole when you select them, and export writes them back as they came. With Keep polygons (Unwrap card) seams never cut through a polygon, so you can take the UVs back to ZBrush with the same topology.

Polygroups

An OBJ with groups shows "N polygroups" on the Mesh line. From ZBrush, export with Grp on so the polygroups come as OBJ groups; otherwise the OBJ materials count as groups. Use them with the 3D bar's Polygroups selection or the Seams card's Polygroups option, which makes every polygroup border a seam.

Normals and hard edges

The normals a file brings are kept per face corner, so its hard edges survive: the 3D view shades with them, Repair mesh keeps them, the project stores them, and export writes them back with the same values.

They are used only when they fit the faces. Normals written in another axis frame than the positions are dropped, as if the file had none. A Simplify makes a new mesh with new smooth normals.

Up axis

Atlasmith guesses whether a mesh is Y up or Z up when it opens, and says which on the Mesh line ("Up: Z (auto)"). FBX and Alembic are always Y up. To change it, use View ▾ > Up axis or Alt+Z. It only turns the view: the exported coordinates are exactly the file's. See Background and up axis.

Very large meshes

Atlasmith is built for meshes of tens of millions of triangles. A few things help:

  • Meshes over 20 million triangles open without the selection tools ready; they are prepared when needed. Simplify first for the fastest work.
  • After a Simplify the original is kept on disk, not in RAM, until the bake needs it.
  • An .atlas project opens much faster than the original OBJ.

See Big meshes and memory.

Mesh check and repair

Every mesh is checked as it opens, beside your work; a sculpt of a few million triangles takes under a second, and nothing changes by itself. The check looks for:

  • corners split at one place on open borders (a closed model exported as separate panels), and cracks;
  • duplicate faces, back-to-back faces and zero-area faces;
  • non-manifold edges and vertices;
  • neighbours turned against each other, and inside-out parts;
  • tiny loose parts.

When it finds something Repair can fix, the status line says so once, for example "Mesh check: N split corners … - Repair mesh fixes them", and the Repair mesh button on the Mesh panel gets an outline. Its tooltip lists what the check found. The model's own open borders, tiny loose parts and slivers are information, not problems.

The Mesh panel with the Repair mesh button outlined, and the mesh check message in the status line
Repair mesh outlined, and the check message in the status line

Repair mesh

Click Repair mesh (or Ctrl+K > "Repair mesh"). It runs as a job with progress and Cancel, and:

  • joins corners at one place on open borders (but never into an edge of three faces, nor two parts that only touch at a point);
  • removes broken, duplicate and zero-area faces; a back-to-back pair keeps the face its neighbours agree with;
  • takes non-manifold edges apart and splits non-manifold vertices;
  • turns each part's faces one way, and turns inside-out closed parts right side out (a cavity inside another part stays as it is).

Only positions change. Every corner keeps its UV and its normal, so UV seams stay seams and hard edges stay hard; islands, locks, groups, pins and your cuts follow. Polygons stay polygons.

Repair works on the whole current mesh (the low-poly after a Simplify, never the kept high-poly) and shows everything again. Repair before simplifying gives a cleaner low-poly. One Ctrl+Z puts the mesh back exactly, with its layout and seams; Ctrl+Y repairs again.

Repair options

In Options > Mesh repair, all off by default and remembered (also in Ctrl+K):

OptionWhat it does
Fill holesCaps every open loop that is left. Each cap is an island of its own, not flat yet.
Remove loose partsDrops tiny separate parts (debris). Open models and small separate parts are often meant so; that is why it is off.
Keep panel borders hardFor hard-surface models exported as separate panels: the edges stitched between two panels stay hard, so each panel keeps its own shading as before the repair. Meshes without normals get normals, written on export.