Python package to export FreeCAD objects to the Wavefront (.obj) file format.

This package satisfies some unique requirements for exporting to OBJ that FreeCAD's built-in functions do not currently satisfy:

• Return a string or the file's contents; instead of writing to a file immediately.
• Use an object's Label for the object's name in the .obj file.
• Ungroup the following standard container objects:
  • Group
  • Part
• Control export granularity keeping container objects grouped, and links unresolved.
• Control which objects are exported (e.g. don't export invisible objects).
• Export wires (the black outline or line segments surrounding parts).
• Export link array elements.

import freecad_to_obj
obj_file_contents = freecad_to_obj.export(objects)

Object names in Wavefront .obj are preceded by an "o [ObjectName]" (source).

This library uses the object's Label for the object name by default, but you can change this behavior via the object_name_getter keyword argument (see API).

o [ObjectName]
v [x1] [y1] [y2]
v ...
vn [x1] [y1] [y2]
vn ...
f v1//vn1 v2//vn2 v3//vn3 ...

After the object name are:

• vertices preceded by v
• vertex normals preceded by vn
• and faces preceded by f
  • faces reference the vertices and vertex normals by number (starting from 1 instead of 0)

Combined these make up the geometry for the object.

Wires for objects are exported as separate objects in the form:

[ObjectName]WireN
v [x1] [y1] [y2]
v ...
l v1 v2 v3 ...

Where N is a zero-indexed incrementing counter.

For example:

o ExampleObjectWire0
...
o ExampleObjectWire1
...
o ExampleObjectWire2

After the object name are:

• vertices preceded by v
• and line segments preceded by l
  • line segments reference the vertices by number (starting from 1 instead of 0)

Exports a list of FreeCAD objects to Wavefront (.obj).

Returns: (string) Wavefront .obj file contents.

See Contributing Guidelines.

See Changelog.

For simplicity, this package does not care about thes generation of material (.mtl) files.

Currently tested with FreeCAD 19.1.