Understanding 3MF Findings

Vertices are coordinate points used to define the shape of a polygon mesh. Triangles reference these points to construct the visible surface.

A higher vertex count generally indicates greater geometric complexity, but vertex count alone does not tell you whether a model is good, bad or printable.

Two tools may also report different vertex totals if one counts a source mesh while another counts resolved components or duplicated transformed geometry.

Triangles are the surface faces that make up most printable mesh models. Together they approximate the form of the original design.

Triangle count is useful for understanding model complexity, performance and file size. It is not a direct measure of print quality.

Very dense meshes may contain millions of triangles while still being geometrically valid. Conversely, a low-triangle model may still contain serious topology faults.

Bounding dimensions describe the overall physical extent of the analysed geometry along the X, Y and Z axes.

Dimensions depend on the unit declared by the 3MF package. Millimetres, centimetres, metres, inches and other supported units can represent very different real-world sizes using similar numerical coordinates.

Always confirm dimensions after repair or conversion. A geometry operation that accidentally changes scale may produce a valid mesh that is nevertheless physically wrong.

A boundary edge is generally an edge used by only one triangle. In a completely closed shell, surface edges normally connect neighbouring faces without leaving an exposed perimeter.

Boundary edges can therefore indicate holes, gaps, missing faces or intentionally open geometry.

The important distinction is intentional versus accidental. A hollow vessel designed with an open top is different from a solid object that has a missing patch of triangles.

In a conventional closed manifold surface, an edge is normally shared by two faces. An edge connected to an unexpected number of faces can indicate ambiguous or overlapping topology.

Non-manifold geometry can cause problems for slicing, boolean operations, volume calculations and automatic repair systems.

The finding should be located and inspected before modification. Automatically deleting geometry simply because an edge is non-manifold can damage a legitimate complex structure.

A vertex can participate in topology that does not form one consistent local surface neighbourhood.

This can occur where surfaces meet only at a single point, disconnected shells share coordinates or several regions are joined in a way that makes inside and outside ambiguous.

As with non-manifold edges, the topology should be inspected in context before repair.

A watertight mesh forms a closed surface without open boundaries through which an imaginary fluid could escape.

Watertightness is useful when a slicer or manufacturing process requires an unambiguous enclosed volume.

However, "not watertight" is not a complete diagnosis. The underlying reason still matters. The model may contain one tiny accidental hole, many disconnected surfaces or an intentionally open design.

Mesh findings describe detected topology. Whether they represent failure depends on what the model is intended to be and how it will be manufactured.

Moksha3D therefore separates the finding from the engineering decision. A warning may require investigation without necessarily requiring automatic repair.

A 3MF object is a resource that can contain a direct mesh or refer to other component objects.

This is one reason 3MF is structurally richer than a simple STL file. The object presented for manufacture does not always correspond to one standalone triangle mesh.

Components allow one object to reference another object. This makes assemblies, repeated parts and hierarchical model structures possible.

A component reference can also carry a transform, meaning that the same source object may appear in different locations or orientations within the assembled model.

The 3MF build identifies which object resources are intended to appear in the manufacturing build.

A build item may point directly to a mesh object or to an object that resolves through a hierarchy of components.

Component references can themselves lead to objects containing further components. An analyser may therefore need to recursively resolve the hierarchy before it reaches the actual mesh geometry.

This is particularly important when comparing results from different tools. One analyser may report the direct source object, while another measures the complete resolved assembly.

A resolved assembly represents the geometry after the relevant component hierarchy has been followed and the intended build structure understood.

Geometry totals for a resolved assembly may differ from totals for one source mesh because multiple transformed component instances may be present.

A component transform describes how referenced geometry is placed within an assembly. It can encode translation, rotation, scaling or a combination of these operations.

The source mesh coordinates and the final assembled coordinates are therefore not always identical.

When analysing dimensions or visual placement, the relevant transforms must be taken into account.

3MF can preserve appearance resources such as base materials, colours and textures alongside the geometry.

These resources describe appearance or material intent but should not be inferred when they are not actually stored in the file.

If a 3MF file does not declare a material, Moksha3D should report that the material is not specified rather than guessing from the colour or visual appearance of the model.

"Not specified" is itself useful evidence because it distinguishes an absent declaration from an analyser failing to read a valid one.

Some 3MF packages include slicer or vendor metadata describing layer height, nozzle size, filament type, filament colour or filament manufacturer.

This information describes manufacturing configuration. It is separate from the mathematical definition of the triangle mesh.

Vendor metadata may also contain support settings, infill, perimeter information, raft or brim configuration, nozzle temperature and bed temperature.

These findings can help explain how a file was prepared, but they should not be treated as universal recommendations for every printer or material.

Some information is represented through standard 3MF resources, while other information may be stored in application-specific files inside the package.

Moksha3D should clearly distinguish evidence originating from the standard 3MF model from evidence originating from vendor or slicer metadata.