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

sdust sdust, 2019/07/13 16:25

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 6 sdust sdust
[[モニターブロックの種類]]
38 5 sdust sdust
39 5 sdust sdust
h2. target モニターターゲットの詳細
40 5 sdust sdust
41 5 sdust sdust
対象となるブロックを指定する。
42 5 sdust sdust
43 5 sdust sdust
<pre>
44 5 sdust sdust
target : keyword{n,m}
45 5 sdust sdust
</pre>
46 5 sdust sdust
47 5 sdust sdust
* keyword : 検索キーワード
48 5 sdust sdust
  ブロック名にkeywordを含むブロックを対象とする。なにも書かなければすべてのブロックが対象となる。
49 5 sdust sdust
* n,m : インデックス範囲
50 5 sdust sdust
  対象となったブロックのうち、n番目からm個のブロックを対象とする。mを省略({n}のように指定)するとn番目から最後までが対象となる。
51 1 sdust sdust
* grid : 対象グリッド(指定方法検討中。今のところ{n,m,grid}と指定)
52 1 sdust sdust
  指定しない場合、実行しているプログラマブルブロックと同一のGridおよび機械的に接続(ローターやピストンで接続)されたGridが対象となる。
53 5 sdust sdust
  me : 同一Gridのみ、all : 接続されているすべてのGrid
54 5 sdust sdust
* targetを指定しない場合は<>も省略できる
55 5 sdust sdust
  例 : $Battery();
56 5 sdust sdust
57 5 sdust sdust
h2. options モニターオプション
58 5 sdust sdust
59 5 sdust sdust
モニターブロックの各種設定を指定できる。
60 5 sdust sdust
61 5 sdust sdust
<pre>
62 5 sdust sdust
options : [option] [, option] ...
63 5 sdust sdust
option : flag | key = value
64 5 sdust sdust
</pre>
65 5 sdust sdust
66 5 sdust sdust
* 複数のオプションが有る場合は","で区切って記述
67 1 sdust sdust
* フラグタイプのオプションはflagのみ、設定に付随する値があるオプションはkey=value形式で記述
68 1 sdust sdust
* モニターブロックの種類によって使用可能なオプションは異なる
69 1 sdust sdust
* 使用可能なオプション以外を記述してもエラーとはならず、無視される
70 1 sdust sdust
* 詳細はオプション毎の説明にて
71 5 sdust sdust
72 6 sdust sdust
[[モニターオプションの種類]]
73 6 sdust sdust
74 5 sdust sdust
h2. contents モニターコンテンツ
75 5 sdust sdust
76 5 sdust sdust
モニターブロックの表示内容を指定できる。
77 5 sdust sdust
78 5 sdust sdust
<pre>
79 5 sdust sdust
contents : [content] [, content | ; content] ...
80 5 sdust sdust
content : type [.subtype] [=value]
81 5 sdust sdust
</pre>
82 5 sdust sdust
83 5 sdust sdust
* 記述したコンテンツタイプに対応する情報が表示される
84 5 sdust sdust
* テキストブロックの場合、contentsがそのまま表示内容となる(改行も認識される)
85 5 sdust sdust
* 複数のコンテントを表示する場合は","で区切って記述する
86 5 sdust sdust
* 次の行に表示したい場合は";"で区切って記述する
87 5 sdust sdust
* モニターブロックの種類によって使用可能なコンテンツタイプは異なる
88 6 sdust sdust
* 使用可能なモニターコンテンツ以外を記述してもエラーとはならず、無視される
89 6 sdust sdust
* 詳細はモニターコンテンツ毎の説明にて
90 6 sdust sdust
91 6 sdust sdust
[[モニターコンテンツの種類]]
クリップボードから画像を追加 (サイズの上限: 5 MB)