FAQ

Revit API の言語環境、開発ツール、ベストプラクティス、その他の一般的な問題に関するよくある質問とその回答です。

開発環境

Revit API 開発には、Visual Studio のどのバージョンが必要ですか?Visual C# Express を使用することはできますか?

Visual Studio 2012 Professional をお勧めします。Visual C# や VB Express は機能しますが、Express エディションは DLL デバッグをサポートしていないため、Revit の実行中はアドインをデバッグできません。.NET Revit API 開発には、Revit に組み込まれている SharpDevelop マクロマネージャを使用することもできます。

Revit API 開発ではどの言語がサポートされていますか?

アドイン開発では、C#、VB.NET、C++/CLI がサポートされています。マクロ開発では、C#、VB.NET、IronPython、IronRuby がサポートされています。Revit API では他の CLR 言語も機能しますが、テストされておらず、サポートもされていません。

アドイン

Revit アドインの生成を支援するウィザードはありますか?

はい。http://thebuildingcoder.typepad.com/blog/2014/05/add-in-wizards-for-revit-2015.html を参照してください。

C++ アドインが構築されないのはなぜですか?

.vcxproj ファイルの <PropertyGroup Label="Globals"> セクションに <TargetFrameworkVersion>v4.5</TargetFrameworkVersion> がない場合があります。このノードがない Visual C++ の既定フレームワークは .NET 4.0 です。

外部コマンドが表示されないのはなぜですか?

さまざまな理由があります。.addin マニフェストファイルが C:¥ProgramData¥Autodesk¥Revit¥Addins¥ 20xx¥ に正しくインストールされていますか? .addin 内の DLL へのパスは正しく設定されていますか?

Revit の起動時に、アプリケーションの OnStartup メソッドが呼び出されないのはどうしてですか?

上述の質問の .addin マニフェストを確認します。また、Revit の起動時に、アドインオブジェクトのコンストラクタで例外が呼び出されていないかを確認してください。

API の使用法

Revit ではどのようにして要素を参照するのですか?

各要素は ID を持ちます。モデル内で他と重複しない ID を使用することで、Revit の複数のセッション間で同じ要素を参照していることを確認できます。

モデルが使用できる共有パラメータファイルは 1 つだけですか?

共有パラメータファイルは、パラメータに関するわずかな情報を保持するために使用します。情報の最も重要な部分が GUID (Globally Unique Identifier)であり、単一ファイル内および複数モデル間でのパラメータのユニーク性を保証するために使用します。

Revit は複数の共有パラメータファイルで作業することができますが、一度に 1 つのファイルからのみパラメータを読み込むことができます。すべてのモデルに同一の共有パラメータファイルを使用するか、各モデルに別のファイルを使用するかは開発者が選択できます。

さらに、API アプリケーションがユーザのパラメータファイルと干渉が発生しないようにする必要があります。アプリケーションは、開発者が用意したパラメータを含む独自のパラメータファイルとともに出荷してください。Revit ファイルにパラメータをロードするには、次の手順を実行します。
- アプリケーションは、ユーザのパラメータファイル名を記憶している必要があります。
- アプリケーションのパラメータファイルに切り替え、パラメータをロードします。
- その後、ユーザのファイルに戻します。

他のプログラムで共有パラメータを使用できるように、モデルと一緒に共有パラメータファイルを配布する必要がありますか?

いいえ、共有パラメータファイルは共有パラメータをロードする場合にのみ使用します。ロード後は、モデルはファイルを必要としなくなります。

対応する要素がコピーされると、共有パラメータ値もコピーされますか?

はい。データベース内に要素のユニークな ID を保持する共有パラメータがある場合、Revit 要素のユニークな ID を付加するか、Revit 要素のユニークな ID を使用して別の共有パラメータを追加します。こうすることで、ID をチェックして、コピーではなく元の要素 ID で作業していることを確認できます。

要素のユニークな ID (UID)は普遍的にユニークですか、また変更することはできますか?

要素のユニークな ID (UID)は普遍的にユニークではありませんが、モデル内ではユニークな要素 ID になります。普遍的にユニークではない理由は、別のドキュメントをコピーして新しいドキュメントを作成する際に、ID が重複する可能性があるためです。ただし、ユニークな ID は変更されないため、ワークシェアリング環境内で要素を参照する場合はユニークになります。ユニークな ID とは異なり、通常の ID は中央モデルとの同期時に番号が付け直されることがあるため、要素を参照する際にユニークな ID として処理することはできません。

アプリケーションがデータをモデルに戻す際に Revit の更新に時間がかかります。速度を速めるためにはどのようにすればいいですか?

必要なときのみ Document.Regenerate()を呼び出すようにしてください。このメソッドでは Revit ドキュメントの要素にすべての変更が反映されていることを確認する必要がありますが、そのためにアプリケーションが遅くなることがあります。トランザクションがコミットされると、ドキュメントの再生成が自動的に呼び出されることにも注意してください。

共有パラメータをバインドする機能を持たない要素に共有パラメータを追加する場合は、どのようにすればいいですか?たとえば、通芯やマテリアルなどです。

要素タイプに共有パラメータを追加する機能がない場合は、プロジェクトパラメータを追加する必要があります。要素に関連付けられている共有パラメータにアクセスする際には、要素のパラメータリストの一部として表示されないため、作業が少し複雑になります。プロジェクトの共有パラメータを文字列にし、共有パラメータに要素 ID を含めるという操作を行えば、文字列を解析してからデータを要素に関連付けることができます。

保存されたモデルやコンテンツ BMP にはどのようにしてアクセスするのですか?

Preview.dll はシェルプラグインであり、IExtractImage インタフェースを実装するオブジェクトです。IExtractImage は Windows のシェルフォルダで使用されるインタフェースであり、既知のファイルタイプのイメージを抽出します。

詳細については、『Revit API 開発者用ガイド』を参照してください。

CRevitPreviewExtractor は次のように標準 API 関数を実装します。
```
 STDMETHOD(GetLocation)(LPWSTR pszPathBuffer,
                                                DWORD cchMax,
                                                DWORD *pdwPriority,
                                                const SIZE *prgSize,
                                                DWORD dwRecClrDepth,
                                                DWORD *pdwFlags);
                STDMETHOD(Extract)(HBITMAP*);
```
自身をレジストリに登録します。

Element.Parameters へのアクセスに時間がかかるのはなぜですか?

このプロパティは、内部で多くの計算を実行します。アプリケーションのニーズに合わせて、個別のデータ構造に特定のプロパティをキャッシュする方法をお勧めします。

Revit Structure

構造要素の既定の終端のリリースがモデルを不安定にレンダリングする場合があります。このような場合どうしたらよいですか?

Revit Structure R3 で導入された解析モデルのチェック機能で、これらの問題がいくつか見られます。解析モデルを読み込むときに、RST (Revit Structure)からリリース条件を保持するかどうか、またはすべての梁と柱を固定に設定するかどうか尋ねられます。モデルを RST に再読み込みすると、終端のリリースを常時更新し、後続の書き出しの終端のリリースを解析プログラムに上書きしません。

梁の方向を回転させているため、弱方向に回転します。たとえば、W14X30 の I は、90 度回転させると H のように見えます。回転角度は API でどのようにアクセスされますか?位置は LocationPoint ではなく LocationCurve であり、Rotation 値にアクセスする権限がありません。確認する必要があるものは何ですか?確認する FamilyInstance 要素があります。これで何をするのですか?

SDK の RotateFramingObject の例を見てみましょう。梁、ブレース、柱の回転角度の取得、変更方法の例があります。

新しいコンクリート梁や柱のサイズをモデルに追加するにはどうしたらよいですか?

SDK の FrameBuilder のサンプルコードを見てみましょう

真のデッキレイヤを表示するにはどうしたらよいですか?

SDK に DeckProperties と呼ばれる例があり、これによってデッキのレイヤ情報を得る方法がわかります。デッキ情報は、UI での場合とまったく同じように報告されます。デッキの寸法パラメータは次のように表示されます。

片持ち梁がある場合はどうしたらわかるのですか?

梁が片持ち梁かどうか Revit データベースで直接知る方法はありません。ただし、次の 1 つ以上のオプションを使用することで、ある部位が片持ち梁かどうか高精度で予測することができます。

[モーメント接合始点]と[モーメント接合終点]という 2 つのパラメータがあります。これらの 2 つの値セットが[なし]でない場合は、同一直線上にあり、[なし]以外の値セットを持つ梁があるかどうか確認する必要があります。ユーザが[構造フレーム]オプションではなく、[片持ちモーメント]オプションを選択しているかどうかも尋ねます。

おおよそ 1 つまたは 2 つの要素を超えて接続性を追跡します。

要素のリリース条件を確認します。

グループを含むモデルを外部プログラムに書き出すときに、書き出しの最後に「「グループ 1 への変更」はグループ編集モードでのみ許可されます」というエラーが表示されます。グループのすべてのインスタンスに変更を加えるには、[グループを編集]コマンドを使用します。変更されたグループインスタンスをグループ解除してこの変更を続行するには、[グループを解除]オプションを使用します。

現在 API はグループメンバーに対する変更を許可していません。プログラムでグループ化を解除し、変更を加え、再グループ化して古いグループの他のインスタンスと新しいグループを交換して同じ効果を得ます。

一般

API バイナリはメジャーリリース同士で互換性がありますか?

一部互換性があります。廃止のマークが付いた API は該当するリリースではサポートされますが、次のリリースでは削除されます。したがって、互換性を維持するには、少なくとも1 回おきのリリースで、アプリケーションの API が最新である必要があります。