Module obj 

Wavefront OBJ ASCII parser + serialiser.

Polygonal subset (vertex / face / line / point / grouping / material directives) is fully decoded into the typed Scene3D model. The free-form curve/surface directives — vp, cstype, deg, curv, curv2, surf, parm, trim, hole, scrv, sp, end, plus the superseded bzp / bsp patches — are captured verbatim into Scene3D::extras["obj:vp"] and Scene3D::extras["obj:freeform_directives"] so a decode → encode round-trip preserves the directive sequence and arguments without semantic interpretation. The .mod binary form remains out of scope.

The grammar is line-oriented; whitespace-separated; # introduces a comment to end of line. Continuation lines (trailing \\) are supported by gluing the next line on before tokenisation.

Structs

SerializeOptions

Serialiser configuration. Keeps the public free-function signature stable while letting the crate::ObjEncoder thread richer options through.

Functions

parse_obj

Parse an OBJ document (no MTL resolution).

parse_obj_from_path

Parse an OBJ document at path, resolving mtllib references against the OBJ file’s parent directory.

parse_obj_with_resolver

Parse an OBJ document, calling resolve once per mtllib entry to fetch the bytes of the named material library. Each library is parsed via parse_mtl and its materials merged into the resulting scene; references in usemtl directives bind to those materials by name.

serialize_obj

Serialise a Scene3D to OBJ format.

serialize_obj_with_options

Serialise a Scene3D to OBJ format with explicit options.