CustomDataの書式 » 履歴 » バージョン 5

sdust sdust, 2019/07/13 15:51

1 1 sdust sdust
h1. CustomDataの書式
2 1 sdust sdust
3 1 sdust sdust
* 基本は書いた文字列がそのまま表示される
4 5 sdust sdust
* 収集した情報を表示する部分を「モニターブロック」と呼ぶ
5 5 sdust sdust
* モニターブロックは$で始まり、;または{~}で終わる
6 3 sdust sdust
* #で始まる行は制御行として特別に処理される(内容は表示されない)
7 1 sdust sdust
* %で始まる行はコメント行として読み飛ばす
8 1 sdust sdust
9 5 sdust sdust
例えば、
10 1 sdust sdust
<pre>
11 3 sdust sdust
% Monitor Test
12 1 sdust sdust
Battery Monitor
13 1 sdust sdust
$Battery(icon, columns=|R120){name ; cha.bar, cha.p}
14 1 sdust sdust
</pre>
15 1 sdust sdust
16 5 sdust sdust
上記の場合、「Battery Monitor」はそのまま表示、その下にBatteryの情報が表示される。
17 1 sdust sdust
18 1 sdust sdust
!ss1.jpg!
19 5 sdust sdust
20 5 sdust sdust
h2. モニターブロックの詳細
21 5 sdust sdust
22 5 sdust sdust
<pre>
23 5 sdust sdust
$BlockType<target>(options);
24 5 sdust sdust
$BlockType<target>(options){contents}
25 5 sdust sdust
</pre>
26 5 sdust sdust
27 5 sdust sdust
* BlockType : モニターブロックの種類を示す
28 5 sdust sdust
* target : 対象となるブロックを指定する (省略可能)
29 5 sdust sdust
* options : モニターブロックの各種オプションを指定する
30 5 sdust sdust
* contents : 主に情報の表示の仕方を指定する (省略可能)
31 5 sdust sdust
32 5 sdust sdust
h2. モニターブロックの種類
33 5 sdust sdust
34 5 sdust sdust
基本的にはブロック名に対応する名前となっている。
35 5 sdust sdust
下記で説明を書いていないものは名前から察してほしい。
36 5 sdust sdust
37 5 sdust sdust
* Text
38 5 sdust sdust
  テキストブロック。テキストを表示する。
39 5 sdust sdust
* GasGenerator
40 5 sdust sdust
  H2/O2 Generatorの情報を表示する。
41 5 sdust sdust
* OxygenFarm
42 5 sdust sdust
* OxygenTank
43 5 sdust sdust
* HydrogenTank
44 5 sdust sdust
* GasTank
45 5 sdust sdust
  OxygenTankおよびHydrogenTankの情報を表示する。
46 5 sdust sdust
* Reactor
47 5 sdust sdust
* HydrogenEngine
48 5 sdust sdust
* SolarPanel
49 5 sdust sdust
* WindTurbine
50 5 sdust sdust
* Battery
51 5 sdust sdust
* PowerProducer
52 5 sdust sdust
  給電系(発電機およびバッテリー)ブロックの情報を表示する。
53 5 sdust sdust
  技術的なことをいえば、IMyPowerProducerインターフェースを実装するブロックを対象とする。
54 5 sdust sdust
* PowerGenerator
55 5 sdust sdust
  バッテリー以外の給電系ブロックの情報を表示する。
56 5 sdust sdust
* Container
57 5 sdust sdust
  コンテナの容量や格納されているアイテム毎の容量等を表示する。
58 5 sdust sdust
59 5 sdust sdust
h2. target モニターターゲットの詳細
60 5 sdust sdust
61 5 sdust sdust
対象となるブロックを指定する。
62 5 sdust sdust
63 5 sdust sdust
<pre>
64 5 sdust sdust
target : keyword{n,m}
65 5 sdust sdust
</pre>
66 5 sdust sdust
67 5 sdust sdust
* keyword : 検索キーワード
68 5 sdust sdust
  ブロック名にkeywordを含むブロックを対象とする。なにも書かなければすべてのブロックが対象となる。
69 5 sdust sdust
* n,m : インデックス範囲
70 5 sdust sdust
  対象となったブロックのうち、n番目からm個のブロックを対象とする。mを省略({n}のように指定)するとn番目から最後までが対象となる。
71 5 sdust sdust
* grid : 対象グリッド(指定方法検討中。今のところ{n,m,grid}と指定)
72 5 sdust sdust
  指定しない場合、実行しているプログラマブルブロックと同一のGridおよび機械的に接続(ローターやピストンで接続)されたGridが対象となる。
73 5 sdust sdust
  me : 同一Gridのみ、all : 接続されているすべてのGrid
74 5 sdust sdust
* targetを指定しない場合は<>も省略できる
75 5 sdust sdust
  例 : $Battery();
76 5 sdust sdust
77 5 sdust sdust
h2. options モニターオプション
78 5 sdust sdust
79 5 sdust sdust
モニターブロックの各種設定を指定できる。
80 5 sdust sdust
81 5 sdust sdust
<pre>
82 5 sdust sdust
options : [option] [, option] ...
83 5 sdust sdust
option : flag | key = value
84 5 sdust sdust
</pre>
85 5 sdust sdust
86 5 sdust sdust
* 複数のオプションが有る場合は","で区切って記述
87 5 sdust sdust
* フラグタイプのオプションはflagのみ、設定に付随する値があるオプションはkey=value形式で記述
88 5 sdust sdust
* モニターブロックの種類によって使用可能なオプションは異なる
89 5 sdust sdust
* 使用可能なオプション以外を記述してもエラーとはならず、無視される
90 5 sdust sdust
* 詳細はオプション毎の説明にて
91 5 sdust sdust
92 5 sdust sdust
h2. contents モニターコンテンツ
93 5 sdust sdust
94 5 sdust sdust
モニターブロックの表示内容を指定できる。
95 5 sdust sdust
96 5 sdust sdust
<pre>
97 5 sdust sdust
contents : [content] [, content | ; content] ...
98 5 sdust sdust
content : type [.subtype] [=value]
99 5 sdust sdust
</pre>
100 5 sdust sdust
101 5 sdust sdust
* 記述したコンテンツタイプに対応する情報が表示される
102 5 sdust sdust
* テキストブロックの場合、contentsがそのまま表示内容となる(改行も認識される)
103 5 sdust sdust
* 複数のコンテントを表示する場合は","で区切って記述する
104 5 sdust sdust
* 次の行に表示したい場合は";"で区切って記述する
105 5 sdust sdust
* モニターブロックの種類によって使用可能なコンテンツタイプは異なる
106 5 sdust sdust
* 使用可能なcontent以外を記述してもエラーとはならず、無視される
107 5 sdust sdust
* 詳細はcontent毎の説明にて
クリップボードから画像を追加 (サイズの上限: 5 MB)