チャート記述のための文法 TCML

文法の概要

すでに述べましたように、本ツールはテキストで適当に書いたそれらしい原稿を清書するものです。そのため、原稿に文法が存在します。

(通称 TCML: Timing Chart Make up Language、タイミングチャート作成言語 ＜ Mark up でなく Make up、JinSatoさん名付け親)

ここでは、その定義を述べます。定義なので、堅苦しく、わけわかりにくいかもしれません。

文　法

凡例：

[数値]　　　　：実数を一般的な小数で記述
[空白]　　　　：スペース、タブ
[空白文字列]　：連続する複数の空白
[文字列]　　　：任意の文字列
[非空白文字]　：空白文字以外の文字
[非空白文字列]：空白文字を含まない任意の文字列
[非空白文字〜文字列]：非空白文字で始まる文字列

ファイル構造

チャート記述のためのテキスト原稿(以下、単に原稿といいます)は、原則として半角英数文字(１バイトのASCII文字)で記述され、行単位に独立して意味を持ちます。

• 「#」で始まる行:　
  コメント行として無視されます。
  どこに記述しても構いません。

• 「@」で始まる行:　
  各種パラメータ設定を行います。
  どこに記述しても構いません。どこに記述してもチャート全体に作用します。同じパラメータに対する設定は、後ろの行でなされたものが有効となります。

• 「%」で始まる行:　
  チャートの指定した位置に文字列を書き込むことができます。
  どこに記述してもかまいません。
  (ほとんど使う必要はないでしょう)

• タイミング記述行:　
  「信号名＋空白文字＋レベル文字列」という型式からなる行で、これを元に各信号線が清書されます。
  記述された順に、チャート上で上から並びます。

タイミング記述行

[非空白文字列] [空白文字列] [非空白文字〜文字列]

レベル文字列はレベル記号、補助記号、書き込み文字列からなります。

レベル記号：信号の時々刻々のレベルを規定する文字
補助記号  ：レベル記号を補助する文字
書込文字列：信号上に書き込まれる記述

レベルの規定は「単位時間」ごとに行います。 単位時間は、図を書く際の時間分解能であり、物理的にどれだけの時間であるかは問いません。 また、パラメータ設定によって、チャート上で１単位時間をどれだけの長さに書くかを設定できます。

レベル記号は、一文字である信号の単位時間のレベルを規定します。

"_"：ローレベル
"~"：ハイレベル(※)
"-"：ハイ・インピーダンス(high-Z)
"="：２値もしくはバス信号

補助記号は、以下の３文字です。

":"：単位時間の空白を挿入
"X"：バスの遷移を挿入
"|"：縦線を挿入

それ以外の文字の集合は、自動的に書き込み文字列として認識されます。 レベル記号、補助記号も含めて、書き込み文字列としたい場合は、「"」でくくります。
書き込み文字列は、前後のレベル記号(含む"X")の中間の時刻を基準としてチャートに書き込まれます。 標準では、文字列の中央が基準点に来るようにセンタリングされます。文字列が"_<_"で始まる場合は基準点に文字列の左端がそろうように、"_>_"で始まる場合は右端がそろうように挿入されます。
(※：一部記号、漢字などに、仕様上記述できないものがあります)

なお、図の横幅は最長のレベル文字列(書き込み文字列は除外)によって、自動的に規定されます。長さが不揃いの場合は、短い信号の後ろに空白があきます。

パラメータ設定

@[非空白文字列] [空白文字列] [非空白文字〜文字列]

補足：

• 線のスタイルは

  [数値(0-1)] [数値(0-1)] [数値(0-1)] setrgbcolor [数値] setlinewidth

  で行う。前半３個の数値はそれぞれ赤、緑、青の輝度であり、０〜１で指定。「0 0 0」が黒、「1 1 1」が白、「1 0 0」が赤となる。線幅は0.1ポイント単位で指定。
• フォントは、UNIX環境(gs)では一般的なPostScriptフォントが使用できる。 WindowsではWindowsにインストールされているTrueTypeフォントが使用可能(デフォルトはtcbmp内でArialに変換される)。「ＭＳ ゴシック」のように、スペースを含むフォントの場合は「ＭＳ\ ゴシック」のように、半角「\」を追加する。
  ただし、基本的に日本語はサポートしていない(日本語まわりの特別な文字処理を加えていない)ことに留意されたし。

文字列書き込み

%[数値(y)] [空白文字列] [数値(x)] [空白文字列] [非空白文字〜文字列]