cadmpeg-codec-sat
cadmpeg-codec-sat decodes bare Autodesk ShapeManager and admitted Spatial
ACIS B-rep streams outside any container. It accepts binary SAB streams in
.smb/.smbh-style files, text SAT/SMT streams, and the ACIS 217/218 binary
branch. It transfers supported records through cadmpeg-asm into
cadmpeg-ir. The stream content selects the decoder; file extensions do
not.
Support: L3 (ladder).
The codec is read-only. It does not read .f3d or Inventor containers, and it
does not encode SAT/SAB output.
Install
Decode a stream
use File;
use SatCodec;
use ;
Read DecodeReport::losses before trusting geometry. A
framed stream can still contain an unsupported kernel branch or records that
produce no transferred geometry. Such results retain source metadata and
unknown records while reporting a blocking geometry_not_transferred loss.
SatCodec::inspect reports the stream kind, kernel header facts, record count,
scale, and text terminator without building the neutral model. Detection is
content-based: binary ASM and ACIS magic produce high confidence, while a
structurally plausible text header produces medium confidence because numeric
text is not unique to SAT/SMT.
Input branches
| Stream | Detection | Decode path |
|---|---|---|
ASM BinaryFile4 |
High | Fixed ASM header, SAB framing at the declared reference width, solved-record transfer. |
ASM BinaryFile8 |
High | Fixed ASM header, 64-bit entity/reference fields, SAB framing, solved-record transfer. |
ACIS BinaryFile |
High | 32-bit ACIS header, four-byte SAB framing, solved-record transfer. |
| Text ASM SAT/SMT | Medium | Four-word ASCII header, counted strings and numeric records, End-of-ASM-data termination. |
| Text ACIS SAT/SMT | Medium | Four-word ASCII header, numeric records, End-of-ACIS-data termination. |
ASM headers select the integer/reference width and expose save format, entity count, flags, product strings, save date, scale, and tolerance fields. A history-bearing stream declares the boundary between solved records and construction history; the model transfer reads the solved partition and keeps the remaining record identity as native data where available.
Save-format majors 217 and 218 are the verified Spatial ACIS bands. An
ACIS-branch stream, binary or text, outside those majors takes the same header
reading, SAB or text framing, and record decode: the save format bands the
admission, not the decode. Such a stream reports
Admission::Unverified, whose using names the verified band whose
grammar was substituted, and charges source.kernel-dialect-unverified. What its
records decoded is reported as it decoded, down to unknown_records coverage
and a blocking geometry loss when nothing carried.
Text streams use the line-oriented SAT/SMT grammar. Their header scale is applied by the shared ASM transfer path, and the terminal line determines the ASM or ACIS dialect. A numeric line that does not contain the complete SAT/SMT opening is not accepted as a text stream.
SAB framing and transfer
Binary streams frame records from the ASM header's record-stream boundary and reference width. The framer recognizes nested subtype tokens, record names, scalar values, strings, references, vectors, positions, enums, and integer values. It stops at the declared solved-record limit or the correct stream terminator; it does not search payload bytes for a record signature.
The shared kernel decoder builds neutral geometry and retains ASM-native
records under the sat namespace. Transfer covers the admitted analytic,
NURBS, topology, placement, and procedural carrier branches documented in
the ASM format notes. Unsupported surfaces remain linked opaque
geometry where topology permits. Unknown SAB records retain their source
range, digest, and kernel-qualified identity through SourceFidelity.
Model lengths and placements use the scale and unit semantics in the selected stream header. Header tolerances populate the neutral IR when both linear and angular values are available. The codec does not infer units from file names or from record text.
Documentation
- API documentation
- Format support
- ASM/SAT format notes
- Architecture and crate map
- Clean-room and legal policy
- Repository
Requires Rust 1.88 or later. Licensed under Apache-2.0.
Autodesk, ShapeManager, ACIS, and other product names are trademarks of their respective owners. cadmpeg uses them only to identify the file formats this codec targets and is not affiliated with, endorsed by, or sponsored by any CAD vendor. See the clean-room and legal policy.