Reader of .serp files for the import of bodies (mitcad#1870): the
native files of an open-source NURBS modeller built on OCCT, format
versions 1 to 9. No geometry kernel: the model makes the bodies
(core/model/src/exchange/serp_import.rs, import_file), the B-reps read
by the kernel's import_brep, the meshes by its triangle_body.
Written from the format as its writer saves it; there is no published specification, and the format still changes quickly (versions 1 to 9 within a few months), so the reader refuses a version newer than it knows in words ("made by a newer version of its program") rather than read it half.
- Version 1: a bare JSON scene. Versions 2 and later: a zip with
meta.json(format, version, saved time, counts),document.json(the scene) andthumbnail.png; from version 3 point clouds as binary members underblobs/, from version 4 pictures underimages/. - The scene:
format,version,units(mm,cm,m,in,ft; millimetres when missing or unknown),layers(id,name,color,visible,parent, …),objects(name,layer,visible,color,block, andbrepormesh),block_defs(by id:nameandshapes), and named views, layouts, annotation styles, hatch patterns, history records, point clouds, pictures and scan paths. - An object's
brepis base64 of the shape as OCCT's binary B-rep format writes it (BinTools). The same member holds other kinds in the writer's own tagged bytes: a text (STXT), a hatch (SHCH), a dimension (SDIM), a picture (SERPPICTURE) and a point cloud (SPCL), which are left out, and in a block's shapes a mesh (SMSH, form 1, or 2 with a float64 origin: the counts, float32 vertices and uint32 triangles). - An object's
mesh: base64 float32 verticesv, uint32 trianglestand an optional originothey are measured from. - Colours are three numbers from 0 to 1 (read from 0 to 255 when one is above 1). An object without a colour has its layer's.
- A placed block is an object whose shape is the block's shapes placed:
the file keeps no placement. The import finds it by comparing the
shapes (
Kernel::rigid_copies).
read gives Serp: the version, the units, the layers (with
layer_path, Parts::Bolts, and layer_shown, which follows the
parents), the objects (each Shape::Brep, Shape::Mesh, Shape::Other
or Shape::Unreadable), the blocks, and Skipped: how many point
clouds, scan paths, pictures, hatches, texts, dimensions, layouts and
history records the import does not take, in words (Skipped::parts).
Every count and index is checked before it is used; an object whose data
cannot be read is Shape::Unreadable with why, and the rest of the file
is read. The scene's JSON may take 2 GiB once unpacked, a mesh 50 million
triangles. A file that is not a .serp file, a damaged container and a
newer version are errors in words, their detail for agents and the log.
core.serp: files of the test writer (testfile), both forms, every
version up to the newest, a newer one, meshes far from the origin, layer
paths and colours, damaged and cut-short files.