DataRefEditor は、X-Planeの 2000+ DataRef 値を表示し、変更することができる無料のプラグインです。
コクピットをTeensyボードを使って自作する上で重要な役割をはたします。
ーーーーーーーーーーーーーーーーーーーーーーーーーーーー
Contents
1 Downloading and Installing DataRefEditor
2 Viewing DataRefs
2.1 Art Controls and Sim Stats
3 Changing DataRefs
4 Adding Your Own DataRefs
ーーーーーーーーーーーーーーーーーーーーーーーーーーーー
１、DataRefEditor をダウンロードしてインストールします。
DataRefEditor はここからダウンロードすることができます。
DataRefEditorフォルダを、X-Plane/Resources/Plugins フォルダにドラッグしてインストールします。
DataRefs の表示
インストールが完了すると、ここに出てきます。
次に出てくるメニューの一番上を選択すると「dataref」画面が表示されます。
このように沢山のX-Planeの情報が表示されます。
この画面を見ながらX-planeの動きを観察します。例えば、上の赤枠のパスはB747-400のオートパイロットのスイッチにあたります。今、「2」と最後の数字がなっていますが、スイッチが入った状態です。OFFにすると、これが「0」に変化します。
自作したスイッチと、Arduinoのスケッチで、この数字の変化をコントロールすることになります。中には理由があってこの数字を変更できないdatarefもありますが、ほとんどのデータを扱うことが出来るようです。
DRE ウィンドウは、任意の余白をドラッグしてサイズ変更できます。ウィンドウは、画面上の任意の位置にドラッグできます。
選択するためにフィルターをかけるか、または小グループを検索するため、DataRefはDREウインドウの左下角に、DataRefの文字列名を入力します。
注: DRE は大文字小文字を区別します。たとえば「tire」を入力すると DataRef 名は「tire」を含む 25 以上の datarefs が表示されます。多くの値が変動することに注意してください。
ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー
以下の情報（その他の機能）は私自身まだよく理解していませんが、簡単に翻訳した分を一緒に記載して置きます。もっと詳しく知りたい場合は
説明先：http://wiki.x-plane.com/DataRefEditor
で調べて見てはいかがでしょうか。
Art Controls and Sim Stats
アート コントロールと Sim の統計情報
Besides the regular "show datarefs" display (which shows all of the datarefs in DataRefs.txt plus any datarefs intentionally published by other plugins), there are two other sets of datarefs that DataRef editor can show:
DataRefエディタが表示することができるのは、「show Datarefs」の表示のほかに、datarefsは他に２つのセットがあります（他のプラグインによって意図的に公開されるDataRefs.txtなど、プラスされたどんなdatarefsでも、datarefsのすべてを示している）。
- Art Controls（アート コントロール）
- Stats（統計情報）
どちらも、メニュー選択を使用すると「Show Art Controls」と「Show Stats」が表示されます。
Art Controlsは、 X-Planeによって、ドメインの sim/private/controls/.... にマップされます。
stats（統計情報）は、ドメインの sim/private/stats/.... にマップされます。
すべての sim-private datarefs （sim/private）、 これらの datarefs は文書化されていないと、サポートされないし、将来の構築に非公開になる場合があります。
プラグイン、パネル、またはオブジェクトは、任意の sim/private datarefs に依存しないでください！
これらは、diagnostics/debugging（診断/デバッグ）のみに使用する必要があります。
アート コントロール datarefs は、sim が変更されたとき動作が変更される datarefs です。たとえば、アート コントロールを使用して、billboarded lights（ビルボード ライト）のグローバルサイズを変更できます。
Sim 統計 sim のパフォーマンスについての診断情報の膨大な量を提供します。たとえば、レンダリング負荷の計算の詳細統計情報を介して X 平面幾何学的なスループットを測定する方法について説明しますを参照してください。
統計とアート コントロール; のない 1 つの包括的なリストがあります。彼らは私たちの内部の開発プロセスとベータの間にデバッグを支援する sim で左の一部として生成されます。
Both are shown using the menu picks "Show Art Controls" and "Show Stats".
The art controls are mapped into the domain sim/private/controls/.... by X-Plane.
The stats are mapped into the domain sim/private/stats/....
Like all sim-private datarefs (sim/private) these datarefs are undocumented and unsupported and may not be there in future builds.
Your plugin, panel, or object should not depend on any sim/private datarefs! They should only be used for diagnostics/debugging.
The art control datarefs are datarefs that will change the operation of the sim when changed. For example, you can change the global size of billboarded lights using an art control.
The sim stats provide a huge amount of diagnostic information about the sim's performance. For an example, see Calculating Rendering Load, which in detail explains how to measure X-Plane's geometric throughput via the stats.
There is no one comprehensive list of stats and art controls; they are generated as part of our internal development process and left in the sim to aid in debugging during beta.
Changing DataRefs
DataRefs を変更するには。
右または左をクリックして DataRef 値と新しい値を入力するほとんどの DataRefs の値を変更することができます。
飛行中またはランプ中 DataRef の変更の効果を観察することができます。
たとえば、sim/operation/failures/rel_tire1 の値を 0 から 1 に変更した場合、タイヤが縮小し小型機が側に傾くのを観察できますし、「tire blown!（タイヤのパンク）」の警告が表示されます。
Return キーを押してキーボード フォーカスを X-Planeに戻してください。
DataRefs の多くの項目は配列として格納されます。DRE ウィンドウの右下にスライダーを使用して、配列のインデックス値の 99 まで 1 によって事前に。たとえば、配列内のインデックスをインクリメントして x、y、および z の「重い」の 10 タイヤのそれぞれの方向でタイヤのたわみを確認できます。左のスライダーは 100 を配列のインデックスを進めます。
This will allow you to observe the effect of changing a DataRef while in flight or on the ramp. For example, if you change the value of sim/operation/failures/rel_tire1 from 0 to 1 you will observe that a small aircraft will tilt to the side as the tire deflates and the "tire blown!" warning appear.
Bring keyboard focus back to X-Plane by pressing return.
Many DataRefs items are stored as arrays. Use the slider on the bottom right of the DRE window to advance the array index by 1 up to a value of 99. For example, you can observe the tire deflection in the x, y, and z directions of each of the 10 tires on a "heavy" by incrementing the array index. The slider on the left advances the array index by 100.
あなた自身の DataRefs を追加するには。
DataRefEditor に datarefs を追加する 2 つの方法があります。
- Resources/pluginsの DataRefs.txt を編集することができます。これはdatarefsを加える最も簡単な方法です。しかし、X-Planeを更新するとき、インストーラは、変更内容を上書きします。このためにそれが動作するようにするため、プラグインは、DataRefEditorの前にロードされなければなりません。
- ここで解説されているように、プログラムで、あなたのdatarefsを公開することができます。http://www.xsquawkbox.net/xpsdk/mediawiki/DataRefEditorPlugin