サンプルファイルはGithubからダウンロードしたSideFX Labs ディレクトリ\hip\examples\mapboxに保存されています。
トークンの設定
これは長い文字列トークンで、インタラクティブマップの起動、マップのダウンロード、SKUトークンの取得に必要です。設定するには:
1. まだアカウントをお持ちでない場合は、Mapboxにアクセスしてアカウントを作成してください。
2. Mapbox アカウントページに移動します。デフォルトパブリックトークンの下にある API アクセストークンを探します。それをコピーしてください。
3.a.Houdiniユーザー設定ディレクトリ$HOUDINI_USER_PREF_DIRに移動します(Windows OSの場合、通常はC:∕Users∕...∕Documents∕houdiniX.Yです)。テキストエディタでhoudini.envを開きます。最後に新しい行を追加する: MAPBOX_API = pk.*** (pk.***の部分を実際のトークンに置き換えてください)。これはトークンをHoudini環境変数として設定します。トークンは頻繁に変更されるものではないので、この方が便利です。
3.b. あるいは、Location and Maps > Mapbox Download Tokens > API Access Tokenにトークンを貼り付ける。これは、Labs Mapbos SOPを作成するたびに行う必要があるため、あまり便利ではありません。
SKU Token
これは、標高マップをダウンロードするために必要な短い文字列トークンです。設定するには
1. Location and Mapsタブで、「Look Up」ボタンのいずれかからインタラクティブ・マップを起動する。インタラクティブ・マップのウィンドウで、「Set Location Only」または「Set Location and Download」のいずれかを押すと、SKUトークンが自動的に設定されます。
2. 何らかの理由でSKUトークンが設定されていない、または機能していない場合は、Mapbox Download Tokens > Rrefesh SKU Tokenを押し、ポップアップウィンドウでGet New SKU Tokenを押します。
シームレスな地形タイルの作成
シームレスな 起伏、色、マテリアル
複数のLabs Mapbox SOPの出力タイルを結合して、より大きな地形を形成することができます。そのためには:
1. 同じロケーション設定とトークンを使用する複数の Labs Mapbox SOP を作成する。
サンプルファイルでは9個のタイルに分割します。下記のように9つのMapbox SOPを作成しました。
2. Location and Maps(場所とマップ)>Tile Offset X/Y(タイルオフセットX/Y)を設定して、各タイルを目的の場所に移動します。このパラメーターの単位は、タイルの幅全体です。
例えば上記の画像でMapbox_Cを中央のタイルと考えます。
次のmapbox_N1ではTile Offset X/Y以外はmapbox_Cと同じにし、Tile Offset X/Yのみをずらしています。
3. すべてのタイルは同じ幅を共有する必要があります。これを行う最も簡単な方法は、1つのノードを使用して参照タイル幅を提供することです。他のすべてのノードで、[Tile Scale] > [Tile Width] を [From Reference Mapbox SOP] に設定し、[Reference Mapbox] を参照ノードにポイントします。
4. すべてのノードで選択されたすべてのマップをダウンロードします。
各MapboxノードでDownloadを実行することでマップをダウンロードすることができます。
5. すべてのノードで Seamless Tiling > Enable Seamless Tiling with Neighbour Tiles をオンにします。
6. すべてのノードに正しいTop Neighbour、Right Neighbour、Top-Right Neighbourを設定します。タイルが特定の隣接を持たない場合は、空白のままにしておきます。
下記はmapbox_Cの設定です。自分の上、右、右上のMapbox ノードを指定します。
7.(オプション) マテリアルにタイル化可能カラーマップを使用したい場合は、すべてのノードで Seamless Tiling > Tileable Material > Render Tileable Color Map を押します。
8. (オプション)場所が変更された場合は、選択したマップをすべて再ダウンロードし、タイル化可能なカラーマップ(使用されている場合)をすべて再レンダリングし、テクスチャ同期の問題を避けるためにダウンロード中に自動的にオフになったOutputタブのマテリアル/カラーパラメータをすべて再度有効にしてください。
シームレスな法線
ハイトフィールドタイリングとメッシュタイリングの両方において、法線は本質的に融合されていない境界の2つの辺の間で矛盾するため、このノードだけで法線をシームレスにすることは不可能です。しかし、ダウンストリームLabsのMapbox Post-process SOPを使用することで、法線をシームレスにすることができます。
トラブルシューティング
“Your file was not found / ERR_FILE_NOT_FOUND”
インタラクティブマップを起動する際、このエラーメッセージが表示された場合は、ネットワーク内に新しいLabs Mapbox SOPを作成するだけです。これですぐに問題が解決し、作成した新しいノードを削除できます。(このノードが作成されるたびに、いくつかのHTMLファイルが自動的に$HOUDINI_USER_PREF_DIR/SideFXLabs/misc/mapbox/にコピーされます。このエラーメッセージは、ノードが必要な HTML ファイルを見つけられないことを意味します)。
ブラックスクリーン
インタラクティブマップを起動する際、黒い画面が表示される場合(多くの場合、その後にクラッシュします)、サーバーへの接続またはマップビューのレンダリングに何らかの問題がある可能性があります。しばらく時間をおいてから、一時的に空のHoudiniシーンを開いてください。Labs Mapbox SOPを作成し、インタラクティブマップを再度起動してみてください。マップが正常に戻っていれば、元のHoudiniシーンに戻ることができます。
マテリアルにテクスチャーがない
ディスク上にテクスチャファイルが存在してもマテリアルにテクスチャが表示されない場合は、ビューポートのマテリアルトグルがオンになっているか、またOutputタブでマテリアルが有効になっているかを確認してください。すべてが正常に見える場合は、Reload Texturesを押す前にRefresh Viewportを押してみてください。それでもテクスチャがない場合、これはテクスチャパスが存在しないファイルを指している間にマテリアルが表示されているときにビューポートがまれに陥るデッドロックである可能性が高いです。ビューポートがすでにこのデッドロックに陥っている場合は、必要なテクスチャがディスク上に存在することを確認し、Houdiniを再起動する必要があります。
詳細なパラメータは下記をご参照ください。
https://www.sidefx.com/docs/houdini/nodes/sop/labs--mapbox-3.0.html