Block データコンポーネント
本マニュアルでは、Unity エディタ内の Block データコンポーネントが提供するコントロール機能と使用方法を詳細に説明します。
バージョン情報
自建図バージョン 9.4 以降、Block Mesh データ形式は eme から gltfx にアップグレードされました。
本文中で新版形式のみをサポートする機能は全て [>=9.4] と表記されています。データバージョンが 9.4 未満の場合、関連する UI コントロールは有効になりません。
本文中で旧版形式のみをサポートする機能は全て [<9.4] と表記されています。データバージョンが 9.4 以上の場合、関連する UI コントロールは有効になりません。
初期状態
コンポーネントの初期状態とは、ツールが作成直後でサービスが選択されておらず、データがロードされていないときの Block データコンポーネントの状態を指します。

Annotation Tool および Block Viewer for Unity Developer 上の Block データコンポーネント.
| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 1 | グローバル座標系オプション | ドロップダウンメニュー | シーン座標系と Block が持つ GNSS データの整合ロジックを設定: GPS (デフォルト): GNSS データに基づき Block を自動整列。この時 Block は Block ルートノードに対して移動不可。 None: GNSS データを使用せず Block を整列しない。この時 Block は Block ルートノードに対して移動可能。 |
| 2 | ルートノード選択 | セレクター | シーン内の BlockRootController コンポーネントを持つノードをルートノードとして選択。 |
| 3 | 新規ルートノード作成 | ボタン | 新しい Block ルートノードを生成し、ルートノードとして設定。ロード済み Block は自動削除。 |
| 4 | キャッシュファイル消去 | ボタン | ローカルにキャッシュされた全 Block データを消去。 |

Block Viewer 上の Block データコンポーネント
| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 5 | ローカル Block ロード | ボタン | ローカルの .eme または .gltfx 拡張子を持つ Block をロード。 |
| 6 | リセット | ボタン | 現在の Block コンポーネントを初期状態に戻す。 |
サービス選択状態
コンポーネントのサービス選択状態とは、ツール内でサービス(Mega Block 位置特定サービス、Mega Block ストレージサービスなど)が選択された後の Block データコンポーネントの状態です。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 7 | Block リスト更新 | ボタン | 現在の Block ツール上の情報を更新し、クラウドサービスとデータ同期。 |
| 8 | レイキャスト精度選択 | ドロップダウンメニュー | [>=9.4]Block のメッシュをレイキャストに使用する際のモデル精度を設定。精度を下げるとエディタ内の LOD ロード速度が向上するが、編集時の精度が犠牲になる: Min LOD (デフォルト): 最簡モデルを使用してレイキャストを実行。 None: 衝突モデルをロードせず、レイキャストを実行しない。 Match LOD: LOD に基づき衝突モデルをロード。 |
| 9 | メッシュ分塊識別子 | トグル | [>=9.4]チェックするとシーン内にメッシュ分塊識別子が表示される。 |
| 10 | Block ノード選択 | ボタン | シーン内の BlockController コンポーネントを持つノードを Block ノードとして選択。 |
| 11 | バージョン | テキスト | 当該 Block のバージョン。 |
| 12 | Block エクスポート | ボタン | [>=9.4]エクスポートメニューを表示。 [<9.4]エクスポートディレクトリを選択し、 obj 形式のモデルファイルをエクスポート。 |
| 13 | Block ロード | ボタン | シーン内にメッシュをロード。 |
エクスポートメニュー[>=9.4]
新版のエクスポートメニューでは、エクスポート階層、テクスチャのエクスポート有無、ファイル形式などの設定を変更可能。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 20 | 階層選択 | チェックボックス | エクスポートするモデルの LOD 精度を選択。ファイル結合未チェック時は複数選択可、チェック時は単一選択のみ。 |
| 21 | オリジナルファイルエクスポート | トグル | 元の gltfx 形式でエクスポート。 |
| 22 | テクスチャエクスポート | トグル | モデルテクスチャをエクスポートするかどうか。 |
| 23 | ファイル形式 | ラジオボタン | エクスポートする単一ファイル形式を glb または gltf に切替。 |
| 24 | ファイル結合 | トグル | エクスポート時に当該階層の全分塊を結合。 |
| 25 | エクスポート | ボタン | エクスポートパスを選択し、エクスポート開始。 |
エクスポート進捗
12 Block エクスポート[<9.4] または 25 エクスポート クリック後に表示される進捗バー。現在のエクスポート状態を確認可能。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 26 | エクスポート進捗 | プログレスバー | パス選択後のエクスポート中に表示されるエクスポート進捗バー。100% で完了。 |
ロード進捗[<9.4]
13 Block ロード ボタンクリック後に表示される進捗バー。現在のダウンロード/ロード状態を確認可能。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 27 | ダウンロード進捗 | プログレスバー | Block データのダウンロード進捗バー。100% でロードがトリガーされる。 |
| 28 | ロード進捗 | プログレスバー | Block データのロード進捗バー。100% で完了。 |
モデルロード済み状態
コンポーネントのモデルロード済み状態とは、13 Block ロード をクリックして少なくとも1つの Block メッシュがロードされた後の Block データコンポーネントの状態です。
| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 5 | ローカル Block ロード | ボタン | ローカルの .eme または .gltfx 拡張子を持つ Block をロード。 |
| 6 | リセット | ボタン | 現在の Block コンポーネントを初期状態に戻す。 |
パノラママーカー未ロード状態
少なくとも1つの Block メッシュがロードされているがパノラママーカーがロードされていない状態の Block データコンポーネント。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 14 | 非表示/表示 | ボタン | シーン内の Block メッシュを非表示/表示。 |
| 15 | Block 削除 | ボタン | 現在ロードされている Block を削除。 |
| 16 | 高精細マーカー | テキスト | HD は高精細パノラマ; SD は標準精細パノラマを示す。 |
| 17 | パノラママーカーロード | ボタン | 現在のシーンにパノラママーカーを示す黄色い球体識別子をロード。 |
パノラママーカーロード済み状態
17 パノラママーカーロード をクリックしてパノラママーカーがロードされた状態の Block データコンポーネント。
この状態では、関連するパノラマ識別子の表示/非表示/削除やパノラマウィンドウのロードが可能。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 18 | 非表示/表示 | ボタン | シーン内のパノラママーカー球体を非表示/表示。 |
| 19 | パノラママーカー削除 | ボタン | 現在ロードされているパノラママーカーを削除。 |
シーン内コントロール
Unity エディタの SceneView 内には、Block データコンポーネントによって作成されるコントロールが存在します。
LOD 分塊識別子[>=9.4]
9.4 以降のツールで 9 メッシュ分塊識別子 を有効にした際に表示される識別子。LOD の分塊、階層、状態を識別するためのもの。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 29 | 分塊 LOD 識別子 | Gizmo | 分塊を識別。LOD ロード後、階層と状態に応じて異なる色で表示: 青: Min 階層、精度最低。 水色: Medium 階層、精度中程度。 緑: Max 階層、精度最高。 赤: ロード中に異常発生(再試行中)。 黄: ロード中。 |
LOD ロード識別子[>=9.4]
LOD ロード識別子は回転する UI コントロールで、LOD 切替時のみ表示されます。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 30 | LOD ロード識別子 | UI | 表示中は LOD ロードが進行中であることを示す。 |
パノラママーカー
パノラママーカーは Block メッシュロード後、17 パノラママーカーロード をクリックするとシーン内に出現するマーカー。パノラマプレビュー可能な位置を示す。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 31 | パノラママーカー | インタラクティブオブジェクト | 当該位置でパノラマプレビューが可能であることを示す黄色い球体識別子。 |
パノラマウィンドウ
パノラマウィンドウは Block メッシュとパノラマ識別子ロード後、31 パノラママーカー をクリックすると表示されるウィンドウ。内部でパノラマプレビューやコンテンツ編集が可能。

| 番号 | コントロール名 | コントロールタイプ | 機能説明 |
|---|---|---|---|
| 32 | パノラマウィンドウ | SceneView | パノラマプレビューが可能なウィンドウ。 |