VSJ ファイル形式とは?
.vsj ファイルは、Omri Rips 氏による無料のオンライン 3D モデルビューア ViewSTL、およびその関連ツールである ViewStl JavaScript プラグインで作成されるシーン保存ファイルです。名称は ViewStl JSON の略であり、その名の通り、3D シーンの状態を記述したプレーンテキストの JSON ドキュメントです。
内部的に、.vsj ファイルはシーンに何が含まれているかではなく、シーンがどのように見えるべきかを記録します。保存される値には、高さや背景色などのキャンバス設定、カメラの状態(位置、アップベクトル、ターゲット)、およびモデルの配列が含まれます。各モデルのエントリには、元のファイル名と、色や透明度などの表示属性が保持されます。ビューアは save_scene 関数を通じてこのファイルを書き出し、デフォルト名 1.vsj で JSON をダウンロードします。
最も重要な点は、.vsj ファイルにはメッシュジオメトリが一切含まれていないことです。これは外部の .stl または .obj ファイルを名前で参照しているため、シーンをレンダリングするにはそれらのファイルが引き続き利用可能である必要があります。ジオメトリとシーンの状態をまとめて持ち運びたい場合、ViewSTL は関連する .vsb フォーマットを提供しています。これは、必要な STL モデルと json.data.vsj エントリを同梱した ZIP アーカイブです。
セキュリティと安全性
リスク: LOWA .vsj file is plain-text JSON with no executable code, macros or scripts, so opening one cannot by itself harm your system. The only practical concern is that it references external STL/OBJ files by name; if those are missing the scene will not render fully. Editing the JSON by hand can break the syntax and stop ViewSTL from loading it, so keep a backup before making changes.
形式の詳細
概要VSJ ファイルを開くプログラム
.vsj file to view its raw JSON text, though large single-line files may be hard to read. .vsj file to restore the saved scene; keep the referenced STL/OBJ files in the same location so the geometry loads. .vsj file and rebuild the camera, canvas and model settings. .vsj file as text to read or hand-edit its JSON keys (canvas, camera, models); VS Code formats and validates the JSON. .vsj file onto the viewer to rebuild the saved camera, background and model colors in the browser. 技術的詳細
詳細仕様| Encoding | UTF-8 plain text (JSON) |
| Byte order | N/A (text format) |
| Container | JSON object |
| Compression | None (the compressed counterpart is the .vsb ZIP file) |
| Typical size | A few hundred bytes to a few kilobytes; the file stores scene settings only, not mesh geometry |
| Structure | A single JSON object holding the state of a ViewSTL scene: canvas settings (such as canvas height and background color), camera state (position, up vector and target), and an array of model entries. Each model entry references the source geometry by filename and stores display attributes such as color, transparency and visibility. |
| Integrity | None; integrity depends on valid JSON syntax |
| Platforms | Windows, macOS, Linux, Web browser |
| Notes | A .vsj file records how a scene should be displayed but does not embed the 3D mesh. It points at external .stl or .obj files by name, so those source files must be available for the scene to render. To bundle geometry and scene state together, ViewSTL uses the .vsb format, a ZIP archive that contains a json.data.vsj entry plus the referenced STL models. |
| Created By | The save_scene() method of the ViewSTL online viewer and the ViewStl JavaScript plugin |
| Default Filename | 1.vsj is the default name produced by save_scene() |
| 仕様書 | www.viewstl.com |
VSJ の変換
コミュニティ Q&A
ユーザーからの質問まだ質問はありません。VSJ ファイルについて最初の質問をしてみましょう。
よくある質問
VSJ ファイルを開くにはどうすればよいですか?
.vsj ファイルを選択します。ビューアが JSON を読み取り、保存されたカメラ、背景、モデルの色を復元します。ジオメトリは .vsj ではなく参照先のファイルにあるため、STL または OBJ ファイルが利用可能であることを確認してください。VSJ ファイルには 3D モデルが含まれていますか?
.vsj ファイルには、キャンバス、カメラ、モデルごとの表示オプションなどのシーン設定のみが保存されます。実際のメッシュファイルは名前で参照されます。ジオメトリとシーンの状態を 1 つのファイルにまとめたい場合は、代わりに .vsb フォーマットを使用してください。VSJ と VSB の違いは何ですか?
.vsj はプレーンテキストの JSON シーン記述です。.vsb は、同じシーン JSON(json.data.vsj として)と STL モデルを含む ZIP アーカイブであるため、単一の .vsb ファイルで自己完結し、持ち運びが可能です。テキストエディタで VSJ ファイルを編集できますか?
VSJ シーンにモデルが表示されないのはなぜですか?
.vsj は外部モデルファイルをファイル名で参照しているだけです。それらの STL または OBJ ファイルが見つからないか、別のフォルダにある場合、シーンの設定は読み込まれますがジオメトリは表示されません。参照ファイルを復元するか、代わりに .vsb バンドルを使用してください。どのプログラムが VSJ ファイルを作成しますか?
save_scene 関数を通じて作成します。これにより、現在のシーンが .vsj ファイル(デフォルト名 1.vsj)としてダウンロードされます。