Datasmith で Revit を使用する | Unreal Engine 4.27 ドキュメンテーション

このページでは、Datasmith で Autodesk Revit から Unreal Editor にどのようにシーンがインポートされるかについて説明します。ここでは、「Datasmith の概要」と「Datasmith のインポートプロセスについて」で説明されている基本的なプロセスにに沿っています。ただし、Revit に固有の特別な変換ビヘイビアがいくつか追加されています。Datasmith を使用して Revit から Unreal Editor にシーンをインポートする予定の場合は、このページを読むとシーンがどのように変換されるか、その結果を Unreal Editor でどのように使用できるかを理解するのに役立ちます。ただし、Revit に固有の特別な変換ビヘイビアがいくつか追加されています。

Revit のワークフロー

Datasmith は Revit に対してエクスポートプラグインワークフローを使用します。つまり、Datasmith を使用して Revit のコンテンツを Unreal Engine に取り込むには、次の手順を実行する必要があります。

Revit 用プラグインのインストール。「Revit 用 Datasmith エクスポータプラグインをインストールする」を参照してください。

Epic では、Unreal Engine のすべての新リリースに合わせて Revit 用 Datasmith エクスポータプラグインの新バージョンもリリースしています。Unreal Engine を別のバージョンに切り替える場合は、必ず該当するバージョンのプラグインをダウンロードしてインストールしてください。
Revit のコンテンツを 「.udatasmith」 ファイルにエクスポートします。「Revit から Datasmith コンテンツをエクスポートする」を参照してください。
まだインストールしていない場合は、[Importers] > [Datasmith Importer] プラグインをプロジェクトで有効にします。
Unreal Editor のツールバーの Datasmith インポータを使って、「.udatasmith」ファイルをインポートします。「Datasmith コンテンツを Unreal Engine 4 にインポートする」を参照してください。

他のタイプの Datasmith ワークフローについては、「Datasmith でサポートされているソフトウェアとファイルタイプ」を参照してください。

エクスポートする内容をコントロールする

Datasmith Exporter プラグインを使用してシーンをエクスポートするには、Revit で 3D ビューを選択してアクティブにする必要があります。その 3D ビューの表示設定により、エクスポートされた 「.udatasmith」 ファイルに含める Revit ファイルの要素を定義します。この操作を利用して、Unreal Engine にエクスポートするコンテンツを Revit 内で完全に制御することができます。

既に Revit ファイルにある 3D ビューを使用することができます。ただし、Unreal Engine に取り込むオブジェクトを完全に制御するには、Revit で新しい 3D ビューを設定し、リアルタイムビジュアライゼーションに必要なオブジェクトだけが表示されるようにビューを設定することをお勧めします。

Revit には、3D ビュー内のオブジェクトの表示設定を制御するための多くのツールとテクニックが用意されています。例：

[Graphics (グラフィック)] > [Visibility (可視性) / Graphics Overrides (グラフィックをオーバーライド)] を使用して、レベル内のさまざまなオブジェクトおよびオブジェクトのカテゴリの可視性をコントロールできます。
セクションボックスを使用すると、エクスポートしたジオメトリをカットすることができます。セクションボックス内のオブジェクトのみ Unreal Engine にエクスポートされます。下の画像のウォール、フロア、家具などのように、オブジェクトがセクションボックスの境界を越えてしまうと、そのジオメトリの表示は制限されることに留意してください。Unreal Engine 内にエクスポートされたオブジェクトを表すスタティックメッシュアセットには、セクションボックス内にあるジオメトリのみが含まれています。
Revit の [Temporary Hide and Isolate (一時的に非表示および分離する)] 設定を反映します。
現在の 3D ビューに表示されているジオメトリックオブジェクトのみがエクスポートされます。非ジオメトリックオブジェクトは無視されます。

Datasmith Exporter では、Revit ビューポート内のオブジェクトの表示/非表示の選択が反映されます。ただし、3D ビューの描画方法のコントロールに関する設定は反映されません。たとえば、3D ビュー向けに設定される [Graphics (グラフィック)] > [Graphic Display Options (グラフィック表示オプション)] (リアリスティックモデル表示、シェーディングモデル表示、シャドウのキャストなど) や [Camera (カメラ)] > [Rendering Settings (レンダリング設定)] (ドラフト品質設定、高品質設定、ライティングスキームなど) は考慮されません。

Revit 3D ビューでの表示/非表示のコントロールについての詳細は、Revit ヘルプの「プロジェクトビューの表示設定とグラフィック表示」も参照してください。

ジオメトリ

一般に、Revit シーン内で個別に選択できる要素は、Unreal では個別のスタティックメッシュアセットとして変換されます。いくつかの要素がレールなどの小さな部品で構成されている場合、さらに小さなスタティックメッシュに分割されることがあります。

各 Static Mesh アセットのジオメトリは、すべての場合において、ファイルをエクスポートした時点の Revit オブジェクトの寸法と一致するように設定されています。パラメトリック設定とコンストレイントは、Unreal Engine に反映されません。たとえば、Unreal Editor でフロアを上下に移動させても、Revit の場合のようにウォールの高さが新しい位置に合わせて伸び縮みしません。

インスタンス化

2 つのオブジェクトが同じファミリに属していて、それらがまったく同じパラメータ値を使用している場合、両方のオブジェクトは同一の Static Mesh アセットのインスタンスとして Datasmith シーンに表示されます。

テッセレーション

Datasmith は、Revit の組み込みテッセレーション機能を利用して、シーンジオメトリから三角ポリゴンメッシュを生成します。ほとんどの場合、テッセレーションを使用することで Unreal Engine に最適なジオメトリを生成できます。ただし、プロジェクト内でこのようなサーフェスが問題となる場合は、Unreal Editor が提供するプロキシジオメトリツールなどのツールを使用して、これらサーフェスのメッシュの複雑さを軽減することができます。

リンクモデル

Revit シーンにリンクモデルが含まれる場合 (他の Revit ファイルを参照している場合)、Datasmith は Revit ファイルに保存されたパスを使って、ご使用になっているコンピュータ上のリンク・ファイルを探そうとします。Datasmith には、Unreal Engine で Datasmith が作成した Datasmith シーンで検知できるすべてのリンクファイルが含まれます。

マテリアルとテクスチャ

Revit のシーンに含まれる各種サーフェスに対して、Datasmith によって新規のマテリアルアセットが Unreal Engine プロジェクト内に作成され、Datasmith シーンアセットの横の 「Materials」 フォルダに配置されます。これらのマテリアルの目的は、Revit での作業で慣れ親しんだものが反映された一連のプロパティを提供しつつ、Revit で設定したサーフェスの外観を忠実に描くことにあります。


Revit	Unreal

Datasmith は現在、Revit で生成された拡散マップとカラー、透明度、カットアウト、バンプ設定から Unreal Engine マテリアルへの変換をサポートしています。

Unreal Editor でマテリアルを変更するには、次の手順を実行します。

コンテンツブラウザ で目的のマテリアルをダブルクリックします。または、変更するマテリアルを使用するレベルのアクタを選択し、[Details (詳細)] パネルでそのマテリアルをダブルクリックします。
上の図に示すマテリアルエディタが起動します。[Details (詳細)] パネル上部の [Parameter Groups (パラメータグループ)] セクションでこれらのパラメータを変更できます。また、Unreal レンダラーによって公開されるその他のビルドインパラメータを変更することもできます。
プロパティのデフォルト値をオーバーライドするには、変更するプロパティ名の左にあるチェックボックスをオンにして、マテリアルでそのプロパティをアクティベートします。次に、そのプロパティで使用する値を設定します。

各アセットはマテリアルインスタンスで、その親は Datasmith プラグインに組み込まれているRevitMaster マテリアルです。この親マテリアルを開くと、マテリアルインスタンスで公開された各プロパティがマテリアルグラフ内でどのように関連付けられているかを確認することができます。

テクスチャと UV ラッピング

Datasmith は、Revit マテリアルで使用したテクスチャをアセットにインポートし、Datasmith シーンアセットの横にある「Textures」フォルダに配置します。

Texture アセットを使用する各マテリアルには、Revit テクスチャエディタと同様のコントロールがあり、そのマテリアルを使用して 3D オブジェクトのサーフェスにテクスチャマップを適用する方法をコントロールできます。

Revit の [Position (位置)] > [Offset (オフセット)] の値は、各マップタイプの UVOffsetX および UVOffsetY の設定によって決まります。
Revit の [Position (位置)] > [Rotation (回転)] の値は、マップの種類ごとの UVWAngle 設定によって決まります。
Revit の [Scale (スケーリング)] の値は実際の寸法に基づいており、Unreal Engine マテリアル内でスケール乗数に変換されます。これらのスケール値の絶対値を大きくすると、オブジェクトのテクスチャが小さくなります。

Datasmith では、Checker、Noise、Tiles などのプロシージャルテクスチャは変換されません。

Datasmith のシーン階層を構築する

Datasmith Exporter プラグインによって、Datasmith シーン内に親 / 子アクタの階層が生成され、Revit 内のシーンの全体的な構成が反映されます。これにより、Revit で使い慣れた考え方に従い、Unreal Engine レベルでアクタを整理がすることができ、オブジェクトの発見や操作がしやすくなります。

このシーン階層は、以下のルールに従って構成されています。

Revit の各レベル (1 階、レベル 1、レベル 2 など) は、Datasmith シーン階層内のアクタに個別に反映されます。
各レベル内で、Revit の他のシーン要素をホスト**しているオブジェクトは、そのオブジェクトがホストしているオブジェクトの親になります。
Revit のレベルとホストを表す親アクタの下には、各ジオメトリックオブジェクトを表す Static Mesh アクタがあります。

たとえば、「Level 1」という名前のアクタには、ウォールを表すアクタが含まれています。これらのアクタは、ウォールがホストするジオメトリックオブジェクト (ドア、窓、またはウォールセクション) を子に持つ別の親アクタとして順番に表されます。
カーテンウォールや手すりなど、「複合」Revit オブジェクトの多くの場合、複合オブジェクトを表すためにシーン階層にはアクタが 1 つだけ含まれます。このアクタに複合要素を構成しているサブオブジェクトのそれぞれにする Static Mesh コンポーネントが含まれます。

たとえば、Revit のカーテンウォールは通常は単一のアクタとして Unreal Engine に入ってきますが、このアクタには、カーテンウォールを構成する各仕切り枠と各パネルごとに別々になった Static Mesh コンポーネントが含まれています。

ライト

Datasmith では、ライトの強度として設定した物理的なユニットを維持したまま、Revit シーンから Unreal Engine にライトをインポートします。

カメラ

Revit から 3D ビューをインポートするとき、Datasmith は Unreal Editor のレベルに単一の CineCameraActor を生成します。このカメラの視野角を Revit 3D ビュー内のカメラの位置と向きに合わせて配置します。レベルビューポートまたは、[World Outliner (アウトライナ)] でこの CineCameraActor を選択した場合、「.udatasmith」ファイルをエクスポートした時に Revit 3D ビューのクロップ領域と厳密に一致するビューポイントのプレビューが表示されます。

Datasmith では、正投影モードやチルト、シフト、クロップ領域のようなパースペクティブの補正など、Revit で使用可能な一部のカメラモードには対応していません。

最良の結果を得るためには、以下の設定を行います。

3D ビューの [Camera (カメラ)] > [Projection Mode (プロジェクションモード)] 設定を [Perspective (パースペクティブ)] に設定します。
Revit で 3D ビューのクロップ領域を設定して、Unreal Engine のカメラで設定したいビューに焦点を合わせます。
Revit でカメラのターゲットポイントがクロップ領域の中心にあることを確認します。これを確認するには、他に平面図と立面図でカメラを表示します。
パースペクティブをシフトしても、Unreal Engine での結果は期待通りにはなりません。

たとえば、下の 3D ビューでは、クロップ領域を中心としたパースペクティブカメラがあり、これは適切に変換されます。

ただし、次の 3D ビューでは、クロップ領域が手動で調整されており、パースペクティブ領域の一方のエッジがターゲットポイントに対して不均等にシフトしています。これはうまく変換されません。

カテゴリ

シーン内の少なくとも 1 つのオブジェクトを含む Revit カテゴリは、それぞれ別のレイヤとして Unreal Editor に取り込まれます。

Unreal Editor 内でこれらのレイヤを使用してカテゴリを表示または非表示にしたり、それらに割り当てられているオブジェクトの検査や選択ができます。

なお、Revit SDK からエクスポータに提供される情報は、必ずしもすべてのシーンオブジェクトをカテゴリに関連付けているわけではないことに注意してください。Revit でカテゴリが割り当てられていないオブジェクトは、Unreal Editor 内のどのレイヤーにも割り当てられません。

メタデータ

Datasmith は Revit オブジェクトに関するメタデータをインポートし、そのメタデータは Unreal Engine 内で各 Revit オブジェクトを表すアクタにアタッチされます。

Unreal Engine で作成したランタイムエクスペリエンスで使用する可能性のあるメタデータのほとんどは、Datasmith メタデータとしてインポートされます。これには、Revit で各オブジェクトに設定したインスタンスプロパティ、および空ではないタイププロパティが含まれます。インポートされたプロパティや、エディタアセット準備スクリプトとランタイムゲームプレイスクリプトでインポートされたプロパティにアクセスする方法についての詳細は、「Datasmith のメタデータを使用する」を参照してください。

その他のいくつかの技術的な内部状態は、コンポーネントタグを使用して各アクタにアタッチされます。特に Unreal Editor でブループリントまたは Python スクリプトを使用してデータ準備を自動化する場合は、この情報がアクタの識別に役立つことがあります。次の例を挙げます。例：

Revit.Instance.Depth. - Revit シーン階層におけるオブジェクトのファミリインスタンスまたはファミリシンボルの深度。
Revit.Instance.Id. - Revit ドキュメント内のオブジェクトのファミリインスタンスまたはファミリシンボルの ID。
Revit.Host.Id. - オブジェクトのファミリインスタンスがホストされている場合、この値は Revit ドキュメント内のファミリインスタンスホストの ID を示します。

RPC オブジェクト

Datasmith は Revit の Rich Photorealistic Content (RPC) オブジェクトを Unreal Engine へ取り込みます。Revit シーンの中の RPC オブジェクトの各タイプごとに、Revit で表示された見ることができるジオメトリを新しい Static Mesh アセットにインポートします。Revit シーンに配置した RPC オブジェクトのそれぞれに対して、Datasmith は 3D 空間における同じ位置と方向を使って Unreal Engine Level の中に新しい Static Mesh アクタを作成します。

Unreal Engine レベルでこれらの RPC オブジェクトを見つけるには、Revit.RPC コンポーネントタグが割り当てられているアクタを検索します。

Revit で使用したプレースホルダーの周囲のオブジェクトを 3D リアルタイム可視化により適したものにで置き換える方法を自動化する場合に有用です。

このページで使用されたすべてのシーンとモデルは、Turbosquid のご厚意により提供されました。

サーベイポイントとプロジェクト基準点

Revit シーンに基準点またはサーベイポイントが含まれる場合、Datasmith はこれらの点を Unreal Engine Level にインポートし、目に見えるジオメトリを含まないプレーンなアクタでそれらを表現します。これらのアクタ上の Datasmith メタデータのサーベイポイントと基準点に関するデータを記録します。


基準点	サーベイポイント

上記のメタデータと Datasmith メタデータを使用するも参照してください。