geom:read-model

(geom:read-model path &key format color label)

モデルファイル中のメッシュを geom:solid として返します。フォーマットが分からないファイル、たとえばビューアが渡されたものをそのまま開く場合の唯一の入口です。フォーマットはファイル自身のバイト列から判定します。:format（:obj、:stl、:ply、:gltf、:glb）を渡せば判定を飛ばして直接指定できます。フォーマットが分かっているなら geom:read-obj、geom:read-stl、geom:read-ply、geom:read-gltf と名指しするほうが成果物は小さくなります。この関数はすべてのリーダーに到達しうるので、すべてのリーダーを抱え込みます。glTF は geom:read-gltf が述べるとおりソリッドのリストを返します。他のフォーマットはソリッド 1 つです。

:color と :label はパッケージ内の他のコンストラクタとまったく同じくソリッドのものです。ソリッドモデリングガイドを参照。

CL-USER> (geom:read-model "bunny.obj" :color (geom:vec3 0.85 0.72 0.5))
#<GEOM:SOLID 35947 vertices 69451 facets>
CL-USER> (geom:read-model "part.stl" :label "bracket")
#<GEOM:SOLID "bracket" 26862 vertices 8954 facets>

フォーマットの判定方法

まず内容から判定し、内容では答えようのないところだけ名前に頼ります。

バイナリ STL にはマジックナンバーがまったくありません — フォーマット側の不備です — そのため 80 バイトのヘッダが solid で始まらないバイナリ .stl は拡張子で名指しされます。拡張子が決して決められないのは ASCII/バイナリの区別のほうで、どちらの方言も .stl であり、geom:read-stl がバイト列からそれを決めます。

どのテストも認識しないファイルは、でたらめに解析されるのではなくファイル名を名指しして拒否されます。リーダー自身が扱えないもの(binary_big_endian の PLY、圧縮やスキン付きの glTF)は、そのリーダーのページにあるとおり名指しで拒否されます。

CL-USER> (geom:read-model "mystery.dat")
; Error: geom:read-model: cannot tell what format mystery.dat is; pass :format

バックエンド対応

ファイルシステムを持つすべてのバックエンド、すなわちインタプリタ、コンパイル済み .class/.jar、WASM Preview 1、WASI 0.3 コンポーネントで、4 つとも同じ答えを返します。ブラウザプレイグラウンドにはファイルシステムがありませんが、モデルファイルを読まないプログラムはリーダーをそもそも抱えません。コンパイル出力から刈り取られます。