🚀 5 分で使う
ロケハン3Dは、3Dスキャン（3DGS）を読み込んでロケハン・絵コンテ・プリビズに使うビューアーです。まずはこの3ステップ。
- 読み込む — 最初の画面の「📂」エリアに 3DGS ファイル（.splat / .ply など）をドラッグ。試すだけなら「デモシーン」ボタン。
- 動かす — マウス右ドラッグで視点回転、WASDで移動。
- 使う — 画面下のボタンで「カメラ / 日照 / 測定」、上のボタンで「オブジェクト追加」。左のレイヤーパネルで管理。
🎮 カメラを動かす
- 視点を回す：マウス右ドラッグ
- 移動：W前 / S後 / A左 / D右 / Q下 / E上
- 移動速度：マウスホイール（または画質パネルのスライダー）
- 視点リセット：上部「🏠 カメラリセット」
スマホ / iPad では、左下のジョイスティックで移動、画面ドラッグで視点回転します。
📁 レイヤーとフォルダー
左の「シーンレイヤー」に、読み込んだファイルや追加オブジェクトが並びます。
- 👁 表示 / 非表示の切替
- ✏️ 名前を変更（ダブルクリックでも可）
- 🗑 削除（Ctrl+Z で元に戻せます）
- ドラッグで並べ替え・フォルダーへ収納
- 🔒 フォルダーをロック：中身の移動・編集・削除をまとめて無効化（誤操作防止）。もう一度押すと解除。
⇆ 位置・回転・拡縮
オブジェクトを選ぶと、3Dハンドル（ギズモ）と数値入力が出ます。
- 矢印＝移動 / リング＝回転 / キューブ＝拡縮
- 「ローカル / ワールド」で座標系を切替（新規・読み込みは既定でローカル）
- iPad ではギズモを指でドラッグして操作できます
＋ オブジェクトを追加
上部「📦 オブジェクト追加」から種類を選び、シーン内を左クリック長押しして配置します（押して位置を探り、離して確定。Escで中止）。
- 📦 Cube — 寸法の目安・あたり
- 🟠 Event — 注目ポイント。画像を貼れます
- 👤 Figure — 人型（身長・ポーズ調整）でスケール感を確認
- 🛣 パス — 4点で囲む区画＋中央ラベル（駐車区画など）。ラベルは複数行OK
📐 距離測定
画面下「📐 測定」をON。スキャン表面の2点間の実距離を測ります。
- 左クリック長押しで点をプレビュー → 離して確定（点A → 点B）
- 「+ 高さを図る」で3点目（高さ）も測定
- マーカーは矢印で微調整、🗑 でクリア
📷 カメラツール / アニメーション
カメラツール（下「📷 カメラ」）：実機のレンズ・センサー・アスペクト比を設定し、構図枠とグリッドを表示。JPEG撮影でカメラ情報も焼き込めます。
カメラアニメーション（上「🎞 アニメーション」）：カメラ位置を複数登録してパスを作り、MP4で書き出し。動きは「イージング（緩急） / リニア（等速）」を選べます。
☀ 日照・天気
画面下「☀ 日照」：日付・時刻・都道府県から太陽の位置と光のムードを再現します。
- 時刻スライダーで朝〜夜の光をスクラブ
- 天気（晴れ / 曇り / 雨）で空の雰囲気を変更
- 「🌐 実際の天気予報を取得」でオンラインの実天気に追従（任意）
💾 保存・読み込み
- オフライン保存（左上）：シーン全体を1つのZIPに保存。レイヤー・オブジェクト・カメラ・設定をまるごと復元できます。
- 読み込み（レイヤーパネル上の「📁 読み込み」）：ZIPや 3DGS / モデルを追加。
- 🎥 カメラ保存：今のカメラ位置をレイヤーとして保存。
❓ よくある質問・ショートカット
- シーンが上下逆 / 横倒し → レイヤーを選び「軸反転」または角度入力で調整。
- 動作が重い → 右上の画質チップで「低」に。描画は最大60fpsです。
- 言語 → 右上「EN / 日本語」で切替。
ショートカット：Ctrl+Z 取り消し / Ctrl+Y やり直し / Ctrl+D 複製
🚀 5-Minute Quickstart
Locahun3D is a viewer for loading 3D scans (3DGS) for location scouting, storyboards and previz. Start with these three steps.
- Load — drag a 3DGS file (.splat / .ply, etc.) onto the “📂” area on the start screen, or hit “Demo scene” to try it.
- Move — right-drag the mouse to look around; WASD to move.
- Use — bottom buttons: Camera / Sun / Measure. Top button: Add object. Manage everything in the left layer panel.
🎮 Moving the camera
- Look around: right-drag the mouse
- Move: Wfwd / Sback / Aleft / Dright / Qdown / Eup
- Speed: mouse wheel (or the slider in the quality panel)
- Reset view: “🏠 Camera reset” at the top
On phone / iPad, use the bottom-left joystick to move and drag the screen to look around.
📁 Layers & folders
Loaded files and added objects appear in “Scene layers” on the left.
- 👁 toggle visibility
- ✏️ rename (double-click also works)
- 🗑 delete (Ctrl+Z to undo)
- drag to reorder / drop into a folder
- 🔒 Lock a folder to disable moving, editing and deleting its contents (prevents accidents). Click again to unlock.
⇆ Move / rotate / scale
Select an object to get the 3D handles (gizmo) and numeric inputs.
- arrows = move / rings = rotate / cubes = scale
- switch coordinate space with “Local / World” (new & imported objects default to Local)
- on iPad you can drag the gizmo with your finger
＋ Adding objects
Pick a type from “📦 Add object” at the top, then long-press (left-click) in the scene to place it (hold to aim, release to confirm; Esc to cancel).
- 📦 Cube — size reference / blocking
- 🟠 Event — a point of interest; you can attach an image
- 👤 Figure — a human (adjustable height & pose) for sense of scale
- 🛣 Path — a 4-point area with a centre label (e.g. parking bays). Labels can be multi-line.
📐 Distance measure
Turn on “📐 Measure” at the bottom. Measures the real distance between two points on the scan surface.
- long-press to preview a point, release to confirm (point A → point B)
- “+ Measure height” adds a 3rd point for height
- fine-tune markers with the arrows; 🗑 to clear
📷 Camera tool / animation
Camera tool (“📷 Camera” at the bottom): set a real lens, sensor and aspect ratio, show the framing box and grid, and capture JPEGs with camera metadata burned in.
Camera animation (“🎞 Animation” at the top): add several camera keys to build a path and export an MP4. Motion can be Ease in/out or Linear.
☀ Sun & weather
“☀ Sun” at the bottom: reproduces the sun position and lighting mood from date, time and prefecture.
- scrub the time slider from morning to night
- change the sky mood with weather (clear / cloudy / rain)
- “🌐 Get live forecast” follows real online weather (optional)
💾 Save & load
- Offline save (top-left): saves the whole scene into a single ZIP — layers, objects, camera and settings all restore.
- Load (“📁 Load” above the layer panel): add a ZIP or a 3DGS / model.
- 🎥 Save camera: stores the current camera position as a layer.
❓ FAQ & shortcuts
- Scene upside-down / sideways → select the layer and use “Flip axis” or the angle inputs.
- Running slow → set the quality chip (top-right) to “Low”. Rendering is capped at 60 fps.
- Language → toggle “EN / 日本語” at the top-right.
Shortcuts: Ctrl+Z undo / Ctrl+Y redo / Ctrl+D duplicate