GSMViewer - Help

GSMViewerは、GSM / PLY / GLBをブラウザで表示し、必要に応じて2点間の距離を測るためのViewerです。

マウス操作：視点変更

• 通常時（Measure Off）は、画面上を 左ドラッグ すると、モデルを見る角度を変えられます。
• マウスホイール で拡大・縮小できます。モデル自体の大きさは変えず、カメラを近づけたり遠ざけたりします。
• 右ドラッグ で、表示位置を上下左右にずらせます。見たい場所が画面端にあるときに使います。
• Reset または Space で、モデル全体が見える初期視点に戻ります。
• Measure On中は、マウス操作が計測点の指定・移動・削除に切り替わります。視点を動かしたい場合は、Esc でMeasureを解除してください。

ファイルの読み込み

• GSMファイルは、画面へドラッグ＆ドロップ（D&D）するだけで読み込めます。
• GLBファイルも単体でD&D読み込みできます。計測する場合は、表示中のGLB表面をクリックして距離を測ります。
• 公開配置したGSMは、URLに ?file=filename.gsm を付けると自動で読み込めます。サブフォルダに置く場合は ?file=models/filename.gsm のように指定します。

Debug: On / Off

• Debug: On にすると、右下にデバッグ情報が表示されます。読み込んだGSM名、ファイルサイズ、読み込み時間などの確認に使います。
• GSM内に計測用Meshが入っている場合、Debug On中だけ、そのMeshをWireframe（線だけの表示）で確認できます。
• Debug: Off にすると、デバッグ情報とWireframe表示を隠します。計測用Meshは見えませんが、計測には引き続き使われます。

BackColor

• BackColor を押すたびに、背景色が切り替わります。
• 背景は、グレー系 → 黒 → 白 の順にトグルします。モデルや計測線が見やすい色を選んでください。

Measure：距離を測る

• Measure ボタンを押すと計測モードになります。計測中は、クリック操作が「点の指定」に切り替わります。
• 測りたい場所の1点目をクリックすると、端点が置かれます。
• 別の場所をクリックすると、2点目が置かれ、2点間の距離が画面上に表示されます。
• 続けてクリックすると、前回の終点から次の点までを連続して測れます。
• Esc を押すと、Measureを解除して通常の表示操作に戻ります。

Measure：計測点を直す・消す

• Measure中に端点へカーソルを合わせると、ドラッグできる状態になります。
• 端点をドラッグすると、計測点の位置を後から調整できます。距離表示も自動で更新されます。
• 端点の上で Right Click すると、その点につながる計測線を削除できます。
• Double Click で、連続計測のつながりをいったん終了できます。

Capture：画像として保存

• Capture を押すと、現在の表示をPNG画像として保存します。
• 画面上の計測線、端点、距離ラベルも画像に入ります。
• Enter キーでもCaptureできます。

Download：計測結果をGSMに保存

• Download を押すと、現在読み込んでいるGSMに計測線・端点・単位設定を同梱して保存します。
• 保存したGSMをもう一度読み込むと、Measureで引いた線と距離ラベルが同じ場所に復元されます。
• 数値だけを保存するのではなく、3D空間上の端点座標を保存します。

その他の操作

• Reset または Space で、モデル全体が見える初期視点に戻ります。
• GSM内に計測用Meshが含まれている場合は、そのMesh上の点で距離を測ります。計測用Meshが無い場合は、表示データの点またはMeshに基づく計測へフォールバックします。
• 距離表示は初期設定でmmです。