情報家電のための分散ソフトウェアプラットフォームの構築
(JCGプロジェクト)

付録１． GUIミドルウェア機能の外部設計書

付録１． GUIミドルウェア機能の外部設計書

（１）機能説明

GUIに関連する機能を提供する。以下の機能がシステムコールの形で提供される。

（Ａ）イベント管理機能

入力機器からの入力をイベントに変換して蓄積し、順に取得する機能を提供する。

（Ｂ）パネル管理機能

画面への描画をおこなう機能を提供する。また、シーン・パネルの管理をおこなう機能を提供する。

（Ｃ）パーツ管理機能

パーツの管理をおこなう機能を提供する。パーツは画面に表示され、ユーザーからの操作を受け付けることができる。

（Ｄ）文字入力管理機能

文字の入力を受け付ける機能を提供する。

（Ｅ）データボックス管理機能

あらかじめ作成したデータボックスから、シーン・パネル・パーツを一括して生成する機能を提供する。

（２）入力データ

GUIミドルウェア機能には、アプリケーションから以下の入力データが渡される。

（Ａ）イベント管理機能の場合

（Ｂ）パネル管理機能の場合

（Ｃ）パーツ管理機能の場合

（Ｄ）文字入力管理機能の場合

※カレットは、文字を入力する位置を示すための縦棒である。カレット位置が0の場合、カレットは左端にある。

（Ｅ）データボックス管理機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。

（Ａ）イベント管理機能の場合

（Ｂ）パネル管理機能の場合

（Ｃ）パーツ管理機能の場合

（Ｄ）文字入力管理機能の場合

（Ｅ）データボックス管理機能の場合

※cntは、値が負の場合にはエラーコードを示し、値が0または正の場合には登録数を示す。

（４）例外条件及び制約条件

• 対応する中機能を参照。

（５）特記事項

対応する中機能を参照。

（６）機能ブロックの構成及び関連

GUIミドルウェア機能は、 「イベント管理機能」 「パネル管理機能」「パーツ管理機能」「文字入力管理機能」「データボックス管理機能」から構成される。

┌────┐                ┌───────┐
│データ  │───────→│パネル管理機能│
│ボックス│                └───────┘
│管理機能│                  ↑    ↑    ↑
│        │      ┌───────┐│    │
│        │──→│パーツ管理機能││    │
│        │      └───────┘│    │
│        │                  ↑    │  ┌────────┐
│        │────────────│→│文字入力管理機能│
└────┘                  │    │  └────────┘
            │    │          ↑
          ┌────────────────┐
          │        イベント管理機能        │
          └────────────────┘


      図 GUIミドルウェア機能の機能ブロック相互関係

パネル管理機能は、イベント管理機能・パーツ管理機能・文字入力管理機能・データボックス管理機能を使用する。

パーツ管理機能は、イベント管理機能・データボックス管理機能を使用する。

文字入力管理機能は、イベント管理機能・データボックス管理機能を使用する。

付録１．１ イベント管理機能

（１）機能説明

GUIミドルウェア機能のうち、 入力機器からの入力を「イベント」として蓄え、順に取り出す機能を提供する。

（Ａ）イベントキュー管理機能

イベントキュー管理機能は、イベントを順に蓄え、また順に取り出す機能を提供する。また、イベントを消去する機能を提供する。

（Ｂ）入力機器管理機能

入力機器管理機能は、PD・キーボードといった入力機器からの入力を加工し、イベントとして発生させる機能を提供する。また、イベントの加工に関する設定をおこなう機能を提供する。

（２）入力データ

詳細は小機能の該当する項目を参照。

（３）出力データ

エラーコードの内容:

詳細は小機能の該当する項目を参照。

（４）例外条件及び制約条件

• 同時に存在できる最大イベント数は、システム全体で16である。
• イベントはタスクを指定して受信させることができないため、複数のタスクが同時にイベントを受信することはできない。
• イベントの発生をおこなうプログラムであっても、割り込みハンドラから使用することはできない。
• 詳細は小機能の該当する項目を参照。

（５）特記事項

なし

（６）機能ブロックの構成及び関連

イベント管理機能は、小機能であるイベントキュー管理機能と、小機能である入力機器管理機能から構成される。

┌──────────────────────────┐
│イベント管理機能                                    │
│  ┌────────┐        ┌────────┐  │
│  │イベントキュー  │イベント│入力機器管理機能│  │
│  │        管理機能│←───│                │  │
│  └────────┘        └────────┘  │
└──────────────────────────┘

       図 イベント管理機能の機能ブロック相互関係

入力機器管理機能は、イベントキュー管理機能にイベントをわたす。

付録１．１．１ イベントキュー管理機能

（１）機能説明

イベント管理機能のうち、イベントの発生・取得・消去に関する機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）イベント発生機能

入力データで指定された「イベント」を、イベントキューに格納する。入力データで指定された「イベント」が「NULLイベント」または「キーリピートイベント」である場合には、それらをイベントキュー管理機能内部に記憶する。

（Ｂ）イベント取得機能

イベントキューから「イベント」を取得し、出力データとする。このとき、入力データで指定された「タイムアウト」の時間が経過しても「イベント」が取得できない場合は、「イベント」を取得せずに処理を中断する。「イベント」が取得できた場合で、入力データで指定された「クリア指定」が有効な場合には、取得した「イベント」をイベントキューから削除する。

（Ｃ）イベント消去機能

入力データで指定された「クリア方法」にもとづき、イベントキューからイベントを削除する。

（２）入力データ

イベントキュー管理機能には、アプリケーションから以下の入力データが渡される。

（Ａ）イベント発生機能の場合

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

EVENT構造体の内容:

※ statには、イベント時刻情報が含まれる。

EVENT構造体のtypeに指定できる値:

（Ｂ）イベント取得機能の場合

（Ｃ）イベント消去機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。

（Ａ）イベント発生機能の場合

エラーコードの内容:

（Ｂ）イベント取得機能の場合

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

エラーコードの内容:

（Ｃ）イベント消去機能の場合

エラーコードの内容:

（４）例外条件及び制約条件

• イベントキューには、最大で16のイベントを蓄積することができる。
• イベントはタスクを指定して受信させることができないため、複数のタスクが同時にイベントを受信することはできない。
• イベントの発生をおこなうプログラムであっても、割り込みハンドラから使用することはできない。

（５）特記事項

なし

付録１．１．２ 入力機器管理機能

（１）機能説明

イベント管理機能のうち、入力機器からの入力を加工し、イベントを発生させる機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）イベント生成機能

入力データで指定された「生イベント」を、あらかじめ設定されている「PD属性」「キー属性」「キーテーブル」にもとづいて加工し、「イベントキュー管理機能」を呼び出すことでイベントを発生させる。

（Ｂ）PD属性設定機能

入力データで指定された「PD属性」を、入力機器管理機能内に設定する。

（Ｃ）PD属性取得機能

入力機器管理機能内に設定されている「PD属性」を取りだし、出力データとする。

（Ｄ）キー属性設定機能

入力データで指定された「キー属性」を、入力機器管理機能内に設定する。

（Ｅ）キー属性取得機能

入力機器管理機能内に設定されている「キー属性」を取りだし、出力データとする。

（Ｆ）キーテーブル設定機能

入力データで指定された「キーテーブル」を、入力機器管理機能内に設定する。

（Ｇ）キーテーブル取得機能

入力機器管理機能内に設定されている「キーテーブル」を取りだし、出力データとする。

（２）入力データ

入力機器管理機能には、アプリケーションから以下の入力データが渡される。

（Ａ）イベント生成機能の場合

typedef struct  {
  W       type;
  W       x, y;
} RAWEVT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

RAWEVT構造体の内容:

RAWEVT構造体のtypeに指定できる値:

（Ｂ）PD属性設定機能の場合

typedef struct  {
  W       sense_x, sense_y;
} PD_ATTR;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PD_ATTR構造体の内容:

（Ｃ）PD属性取得機能の場合

typedef struct  {
  W       sense_x, sense_y;
} PD_ATTR;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PD_ATTR構造体の内容:

（Ｄ）キー属性設定機能の場合

typedef struct  {
  W       rep_delay, rep_int;
} KEY_ATTR;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

KEY_ATTR構造体の内容:

（Ｅ）キー属性取得機能の場合

typedef struct  {
  W       rep_delay, rep_int;
} KEY_ATTR;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

KEY_ATTR構造体の内容:

（Ｆ）キーテーブル設定機能の場合

（Ｇ）キーテーブル取得機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。

（Ａ）イベント生成機能の場合

エラーコードの内容:

（Ｂ）PD属性設定機能の場合

エラーコードの内容:

（Ｃ）PD属性取得機能の場合

エラーコードの内容:

（Ｄ）キー属性設定機能の場合

エラーコードの内容:

（Ｅ）キー属性取得機能の場合

エラーコードの内容:

（Ｆ）キーテーブル設定機能の場合

エラーコードの内容:

（Ｇ）キーテーブル取得機能の場合

※cntは、値が負の場合にはエラーコードを示し、値が0または正の場合にはキーテーブル数を示す。

エラーコードの内容:

（４）例外条件及び制約条件

• イベントキューには、最大で16のイベントを蓄積することができる。
• イベントの発生をおこなうプログラムであっても、割り込みハンドラから使用することはできない。

（５）特記事項

なし

typedef struct  {
  H       x, y;
} PNT;

typedef struct  {
  H       h, v;
} SIZE;

typedef union   {
  struct  {
    H       left, top;
    H       right, bottom;
  } c;
  {
    PNT     lefttop;
    PNT     rightbot;
  } p;
} RECT;

typedef struct  {
  PNT     off;
  RECT    vr;
  W       nfra;
  RECT    fra[0];
} GENVPAR;

typedef struct  {
  W       type;
  H       h, v;
  COLOR   fgcol, bgcol;
  UB      *mask;
} PAT;

typedef struct  {
  UW      planes;
  UH      pixbits;
  UH      rowbytes;
  RECT    bounds;
  UB      *baseaddr[PLANES];
} BMP;

typedef struct  {
  W       type;
  TC      start;
  TC      end;
  SIZE    size;
  UB      data[0];
} FONT;

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

┌────────────────────────────────────────┐
│パネル管理機能                                                                  │
│                                                                                │
│┌──────────────────────────────────────┐│
││                              描画環境管理機能                              ││
│└──────────────────────────────────────┘│
│┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐│
││直線        ││長方形      ││円          ││文字        ││ビットマップ││
││    描画機能││    描画機能││    描画機能││    描画機能││    描画機能││
│└──────┘└──────┘└──────┘└──────┘└──────┘│
│        ↑              ↑              ↑              ↑              ↑      │
│        ├───────┴───────┴───────┴───────┘      │
│        │                                                                      │
│┌───────────┐┌───────────┐                            │
││    パネル表示機能    ││    パネル消去機能    │                            │
│└───────────┘└───────────┘                            │
└────────────────────────────────────────┘



        図． パネル管理機能の機能ブロック相互関係

付録１．２．１ 描画環境管理機能

（１）機能説明

パネル管理機能のうち、描画環境の生成・削除・設定・取得をおこなう機能を提供する。また、パターンの生成・削除をおこなう機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）描画環境生成機能

入力データで指定された「描画環境生成情報」にもとづいて新たな描画環境を生成する。生成した描画環境の「描画環境ID」を、出力データとして返す。

（Ｂ）描画環境削除機能

入力データで指定された「描画環境ID」を削除する。

（Ｃ）描画オフセット設定機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「描画オフセット」を設定する。

（Ｄ）描画オフセット取得機能

入力データで指定された「描画環境ID」の描画オフセットを、入力データで指定された「描画オフセット」の領域に格納する。

（Ｅ）表示長方形設定機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「表示長方形」を設定する。

（Ｆ）表示長方形取得機能

入力データで指定された「描画環境ID」の表示長方形を、入力データで指定された「表示長方形」の領域に格納する。

（Ｇ）前置長方形配列設定機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「前置長方形配列」を設定する。

（Ｈ）前置長方形配列取得機能

入力データで指定された「描画環境ID」の前置長方形配列を、入力データで指定された「前置長方形配列」の領域に格納する。

（Ｉ）パターン生成機能

入力データで指定された「パターン生成情報」にもとづいて新たなパターンを生成する。生成したパターンの「パターンID」を、出力データとして返す。

（Ｊ）パターン削除機能

入力データで指定された「パターンID」を削除する。

（２）入力データ

描画環境管理機能には、アプリケーションから以下の入力データが渡される。

（Ａ）描画環境生成機能の場合

typedef struct  {
  PNT     off;
  RECT    vr;
  W       nfra;
  RECT    fra[0];
} GENVPAR;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

GENVPAR構造体の内容:

（Ｂ）描画環境削除機能の場合

（Ｃ）描画オフセット設定機能の場合

（Ｄ）描画オフセット取得機能の場合

（Ｅ）表示長方形設定機能の場合

（Ｆ）表示長方形取得機能の場合

（Ｇ）前置長方形配列設定機能の場合

（Ｈ）前置長方形配列取得機能の場合

（Ｉ）パターン生成機能の場合

typedef struct  {
  W       type;
  H       h, v;
  COLOR   fgcol, bgcol;
  UB      *mask;
} PAT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PAT構造体の内容:

※typeは0とすること。

※maskの内容は、1となっているビットは前景色を、0となっているビットは背景色を意味する。

（Ｊ）パターン削除機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。

（Ａ）描画環境生成機能の場合

※gidは、値が負の場合にはエラーコードを示し、値が0または正の場合には描画環境IDを示す。

エラーコードの内容:

（Ｂ）描画環境削除機能の場合

エラーコードの内容:

（Ｃ）描画オフセット設定機能の場合

エラーコードの内容:

（Ｄ）描画オフセット取得機能の場合

エラーコードの内容:

（Ｅ）表示長方形設定機能の場合

エラーコードの内容:

（Ｆ）表示長方形取得機能の場合

エラーコードの内容:

（Ｇ）前置長方形配列設定機能の場合

エラーコードの内容:

（Ｈ）前置長方形配列取得機能の場合

※cntは、値が負の場合にはエラーコードを示し、値が0または正の場合には長方形数を示す。

エラーコードの内容:

（Ｉ）パターン生成機能の場合

※pidは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパターンIDを示す。

エラーコードの内容:

（Ｊ）パターン削除機能の場合

エラーコードの内容:

（４）例外条件及び制約条件

• 描画環境の最大数は、システム全体で100である。
• 前置長方形配列数は、描画環境あたり、最大で16である。
• パターンの最大数は、システム全体で100である。
• パターンの最大の大きさは、幅が1〜8、高さが1〜16である。

（５）特記事項

なし。

付録１．２．２ 直線描画機能

（１）機能説明

パネル管理機能のうち、描画環境に直線を描画する機能を提供する。また、指定された点が直線と重なっているかどうかを調べる機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）直線描画機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「座標」「パターンID」「描画モード」にしたがって、直線を描画する。

（Ｂ）直線ピッキング機能

入力データで指定された「座標」が、入力データで指定された「座標」「線太さ」で示される直線上にあるかどうかを、出力データとして返す。

（２）入力データ

直線描画機能には、アプリケーションから以下の入力データが渡される。

（Ａ）直線描画機能の場合

modeに指定できる値:

（Ｂ）直線ピッキング機能の場合

※長方形領域は、システムコールによって構造体の場合とポインタの場合とがあるため、両方を記述している。

（３）出力データ

アプリケーションへは以下の出力データが渡される。また、「(A)直線描画機能」の場合、システムコールの副作用として画面への描画がおこなわれる。

（Ａ）直線描画機能の場合

エラーコードの内容:

（Ｂ）直線ピッキング機能の場合

※stsは、値が負の場合にはエラーコードを示し、値が0または正の場合にはピッキング結果を示す。

エラーコードの内容:

（４）例外条件及び制約条件

なし

（５）特記事項

なし。

付録１．２．３ 長方形描画機能

（１）機能説明

パネル管理機能のうち、長方形・角丸長方形の描画をおこなう機能を提供する。また、指定した点と長方形・角丸長方形が重なっているかどうかを調べる機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）長方形枠描画機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「長方形領域」「線属性」「パターンID」「描画モード」にしたがって、長方形の枠を描画する。

（Ｂ）長方形塗りつぶし機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「長方形領域」「パターンID」「描画モード」にしたがって、長方形の内部を描画する。

（Ｃ）長方形ピッキング機能

入力データで指定された「座標」が、入力データで指定された「長方形領域」「線太さ」で示される長方形枠上にあるかどうかを、出力データとして返す。「線太さ」が0の場合は、 長方形内部にあるかどうかを返す。

（Ｄ）角丸長方形枠描画機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「長方形領域」「水平角丸め指定」「垂直角丸め指定」「線属性」「パターンID」「描画モード」にしたがって、角丸長方形の枠を描画する。

（Ｅ）角丸長方形塗りつぶし機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「長方形領域」「水平角丸め指定」「垂直角丸め指定」「パターンID」「描画モード」にしたがって、角丸長方形の内部を描画する。

（Ｆ）角丸長方形ピッキング機能

入力データで指定された「座標」が、入力データで指定された「長方形領域」「水平角丸め指定」「垂直角丸め指定」「線太さ」で示される角丸長方形枠上にあるかどうかを、出力データとして返す。「線太さ」が0の場合は、角丸長方形内部にあるかどうかを返す。

（２）入力データ

長方形描画機能には、アプリケーションから以下の入力データが渡される。

（Ａ）長方形枠描画機能の場合

modeに指定できる値:

（Ｂ）長方形塗りつぶし機能の場合

modeに指定できる値:

（Ｃ）長方形ピッキング機能の場合

（Ｄ）角丸長方形枠描画機能の場合

modeに指定できる値:

（Ｅ）角丸長方形塗りつぶし機能の場合

modeに指定できる値:

（Ｆ）角丸長方形ピッキング機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。また、「(A)長方形行く描画機能」「(B)長方形塗りつぶし機能」「(D)角丸長方形枠描画機能」「(E)角丸長方形塗りつぶし機能」の場合、システムコールの副作用として画面への描画がおこなわれる。

（Ａ）長方形枠描画機能の場合

エラーコードの内容:

（Ｂ）長方形塗りつぶし機能の場合

エラーコードの内容:

（Ｃ）長方形ピッキング機能の場合

※stsは、値が負の場合にはエラーコードを示し、値が0または正の場合にはピッキング結果を示す。

エラーコードの内容:

（Ｄ）角丸長方形枠描画機能の場合

エラーコードの内容:

（Ｅ）角丸長方形塗りつぶし機能の場合

エラーコードの内容:

（Ｆ）角丸長方形ピッキング機能の場合

※stsは、値が負の場合にはエラーコードを示し、値が0または正の場合にはピッキング結果を示す。

エラーコードの内容:

（４）例外条件及び制約条件

なし

（５）特記事項

なし。

付録１．２．４ 円描画機能

（１）機能説明

パネル管理機能のうち、円・楕円を描画環境に描画する機能を提供する。また、指定された点と円・楕円が重なっているかどうかをチェックする機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）楕円枠描画機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「長方形領域」「線属性」「パターンID」「描画モード」にしたがって、楕円の枠を描画する。

（Ｂ）楕円塗りつぶし機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「長方形領域」「パターンID」「描画モード」にしたがって、楕円の内部を描画する。

（Ｃ）楕円ピッキング機能

入力データで指定された「座標」が、入力データで指定された「長方形領域」「線太さ」で示される楕円枠上にあるかどうかを、出力データとして返す。「線太さ」が0の場合は、楕円内部にあるかどうかを返す。

（２）入力データ

円描画機能には、アプリケーションから以下の入力データが渡される。

（Ａ）楕円枠描画機能の場合

modeに指定できる値:

（Ｂ）楕円塗りつぶし機能の場合

modeに指定できる値:

（Ｃ）楕円ピッキング機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。また、「(A)楕円枠描画機能」「(B)楕円塗りつぶし機能」の場合、システムコールの副作用として画面への描画がおこなわれる。

（Ａ）楕円枠描画機能の場合

エラーコードの内容:

（Ｂ）楕円塗りつぶし機能の場合

エラーコードの内容:

（Ｃ）楕円ピッキング機能の場合

※stsは、値が負の場合にはエラーコードを示し、値が0または正の場合にはピッキング結果を示す。

エラーコードの内容:

（４）例外条件及び制約条件

なし。

（５）特記事項

なし。

付録１．２．５ 文字描画機能

（１）機能説明

パネル管理機能のうち、描画環境に文字列を描画する機能を提供する。また、文字列のサイズを取得する機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）フォント設定機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「フォント」を設定する。

（Ｂ）文字列描画機能

入力データで指定された「描画環境ID」 に、 入力データで指定された「座標」「文字列」「文字列長」「パターンID」「描画モード」にもとづいて文字列を描画する。

（Ｃ）文字列サイズ取得機能

入力データで指定された「描画環境ID」 で、 入力データで指定された「文字列」「文字列長」を描画した場合の長方形領域を、入力データで指定された「長方形配列」の領域に格納する。

（２）入力データ

文字描画機能には、アプリケーションから以下の入力データが渡される。

（Ａ）フォント設定機能の場合

typedef struct  {
  W       type;
  TC      start;
  TC      end;
  SIZE    size;
  UB      data[0];
} FONT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

FONT構造体の内容:

※typeは0とすること。

（Ｂ）文字列描画機能の場合

modeに指定できる値:

（Ｃ）文字列サイズ取得機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。また、「(B)文字列描画機能」の場合、システムコールの副作用として画面への描画がおこなわれる。

（Ａ）フォント設定機能の場合

エラーコードの内容:

（Ｂ）文字列描画機能の場合

エラーコードの内容:

（Ｃ）文字列サイズ取得機能の場合

エラーコードの内容:

（４）例外条件及び制約条件

• フォントは設定後も参照されるため、解放してはならない。

（５）特記事項

なし。

typedef struct  {
  UW      planes;
  UH      pixbits;
  UH      rowbytes;
  RECT    bounds;
  UB      *baseaddr[PLANES];
} BMP;

付録１．２．７ パネル表示機能

（１）機能説明

パネル管理機能のうち、シーン・パネルの生成・表示・設定・取得をおこなう機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）シーン生成機能

入力データで指定された「シーン生成情報」にしたがって、シーンを生成する。生成したシーンの「シーンID」を、出力データとして返す。

（Ｂ）シーン設定機能

入力データで指定された「シーンID」の「項目番号」で指定された項目を、入力データで指定された「パーツ生成情報」のパーツで置き換える。生成されたパーツのパーツIDが、出力データとして返る。

（Ｃ）シーン表示機能

今まで表示されていたシーンを非表示状態とし、入力データで指定された「シーンID」を表示状態とする。

（Ｄ）シーン表示長方形設定機能

入力データで指定された「シーンID」の表示長方形を、入力データで指定された「長方形領域」に変更する。

（Ｅ）シーンキー座標設定機能

入力データで指定された「シーンID」のキー座標を、入力データで指定された「座標」に変更する。

（Ｆ）シーン動作機能

入力データで指定された「先頭シーンID」「末尾シーンID」の範囲のシーンに対するイベントを、「タイムアウト」の時間だけ受け付ける。イベントがシーンに登録されているパーツ上でおこなった場合には、パーツの動作もおこなう。動作の対象となったシーンID・項目番号・イベントが、入力データで指定された「シーンID」「項目番号」「イベント」の領域に格納される。

（Ｇ）パネル生成機能

入力データで指定された「シーン生成情報」にしたがって、シーンを生成する。生成したシーンの「シーンID」を、出力データとして返す。

（Ｈ）パネル設定機能

入力データで指定された「パネルID」の「項目番号」で指定された項目を、入力データで指定された「パーツ生成情報」のパーツで置き換える。生成されたパーツのパーツIDが、出力データとして返る。

（Ｉ）パネル表示機能

入力データで指定された「パネルID」を、最前面に表示する。

（Ｊ）パネル表示長方形設定機能

入力データで指定された「パネルID」の表示長方形を、入力データで指定された「長方形領域」に変更する。

（Ｋ）パネルキー座標設定機能

入力データで指定された「パネルID」のキー座標を、入力データで指定された「座標」に変更する。

（Ｌ）パネル動作機能

入力データで指定された「先頭パネルID」「末尾パネルID」の範囲のパネルに対するイベントを、「タイムアウト」の時間だけ受け付ける。イベントがパネルに登録されているパーツ上でおこなった場合には、パーツの動作もおこなう。動作の対象となったパネルID・項目番号・イベントが、入力データで指定された「パネルID」「項目番号」「イベント」の領域に格納される。

（２）入力データ

パネル表示機能には、アプリケーションから以下の入力データが渡される。

（Ａ）シーン生成機能の場合

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PARTS構造体の内容:

PARTS構造体のtypeに指定できる値:

※ほかに、パーツ管理プログラム・文字入力管理プログラムのパーツタイプも指定することができる。

（Ｂ）シーン設定機能の場合

（Ｃ）シーン表示機能の場合

（Ｄ）シーン表示長方形設定機能の場合

（Ｅ）シーンキー座標設定機能の場合

（Ｆ）シーン動作機能の場合

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

EVENT構造体の内容:

（Ｇ）パネル生成機能の場合

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PARTS構造体の内容:

PARTS構造体のtypeに指定できる値:

※ほかに、パーツ管理プログラム・文字入力管理プログラムのパーツタイプも指定することができる。

（Ｈ）パネル設定機能の場合

（Ｉ）パネル表示機能の場合

（Ｊ）パネル表示長方形設定機能の場合

（Ｋ）パネルキー座標設定機能の場合

（Ｌ）パネル動作機能の場合

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

EVENT構造体の内容:

（３）出力データ

アプリケーションへは以下の出力データが渡される。

（Ａ）シーン生成機能の場合

※widは、値が負の場合にはエラーコードを示し、値が0または正の場合にはシーンIDを示す。

エラーコードの内容:

（Ｂ）シーン設定機能の場合

※cidは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパーツIDを示す。

エラーコードの内容:

（Ｃ）シーン表示機能の場合

エラーコードの内容:

（Ｄ）シーン表示長方形設定機能の場合

エラーコードの内容:

（Ｅ）シーンキー座標設定機能の場合

エラーコードの内容:

（Ｆ）シーン動作機能の場合

※stsは、値が負の場合にはエラーコードを示し、値が0または正の場合には動作結果を示す。

エラーコードの内容:

（Ｇ）パネル生成機能の場合

※widは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパネルIDを示す。

エラーコードの内容:

（Ｈ）パネル設定機能の場合

※cidは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパーツIDを示す。

エラーコードの内容:

（Ｉ）パネル表示機能の場合

エラーコードの内容:

（Ｊ）パネル表示長方形設定機能の場合

エラーコードの内容:

（Ｋ）パネルキー座標設定機能の場合

エラーコードの内容:

（Ｌ）パネル動作機能の場合

※stsは、値が負の場合にはエラーコードを示し、値が0または正の場合には動作結果を示す。

エラーコードの内容:

（４）例外条件及び制約条件

• パネル・シーンの最大数は、システム全体でシーンとパネルを合わせて64である。
• パネル・シーンに登録できるパーツの数は、パネル・シーン毎に最大64である。
• 同時に表示できるパネルの数は、最大で16である。
• パネル・シーンの定義データは登録後も参照されるので、解放してはならない。
• 同時にイベントを待つタスクの数は、最大で64である。

（５）特記事項

なし。

付録１．２．８ パネル消去機能

（１）機能説明

パネル管理機能のうち、シーン・パネルの消去・削除をおこなう機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）シーン削除機能

入力データで指定された「シーンID」を削除する。

（Ｂ）パネル消去機能

入力データで指定された「パネルID」を消去状態とする。

（Ｃ）パネル削除機能

入力データで指定された「パネルID」を削除する。

（２）入力データ

パネル消去機能には、アプリケーションから以下の入力データが渡される。

（Ａ）シーン削除機能の場合

（Ｂ）パネル消去機能の場合

（Ｃ）パネル削除機能の場合

（３）出力データ

アプリケーションへは以下の出力データが渡される。

（Ａ）シーン削除機能の場合

エラーコードの内容:

（Ｂ）パネル消去機能の場合

エラーコードの内容:

（Ｃ）パネル削除機能の場合

エラーコードの内容:

（４）例外条件及び制約条件

なし。

（５）特記事項

なし。

付録１．３ パーツ管理機能

（１）機能説明

GUIミドルウェア機能のうち、パーツの管理をおこなう機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）モーメンタリスイッチ管理機能

モーメンタリスイッチの生成・削除・表示・設定・取得・動作をおこなう。モーメンタリスイッチは、スイッチ上でクリック動作がおこなわれたことを検出するパーツである。

（Ｂ）オルタネートスイッチ管理機能

オルタネートスイッチの生成・削除・表示・設定・取得・動作をおこなう。オルタネートスイッチは、スイッチ上でクリックすることでオン・オフが反転するスイッチである。

（Ｃ）スイッチセレクタ管理機能

スイッチセレクタの生成・削除・表示・設定・取得・動作をおこなう。スイッチセレクタは、いくつかの選択肢を表示し、選択することができるパーツである。

（Ｄ）スクロールセレクタ管理機能

スクロールセレクタの生成・削除・表示・設定・取得・動作をおこなう。スクロールセレクタは、いくつかの選択肢を、スクロール可能な領域に表示し、選択することができるパーツである。

（Ｅ）シリアルセレクタ管理機能

シリアルの生成・削除・表示・設定・取得・動作をおこなう。シリアルセレクタは、 いくつかの選択肢のうちの1つを表示し、スイッチによって前後の選択肢を選択することができるパーツである。

（Ｆ）ボリューム管理機能

ボリュームの生成・削除・表示・設定・取得・動作をおこなう。ボリュームは、連続したある範囲の値を表示・設定するパーツである。

（２）入力データ

パーツ管理機能には、アプリケーションから以下の入力データが渡される。

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

※パーツ文字列の終端には、TNULLを指定する。

PARTS構造体の内容:

※パーツ文字列の終端には、TNULLを指定する。複数の項目がある場合は、項目の間をMC_STRで区切る。

PARTS構造体のtypeに指定できる値:

※GC_NONOBはボリュームのみ、GC_NOSELはスイッチセレクタ・スクロールセレクタのみに使用されるため、同じ数値を割り当てていても問題は発生しない。

modeに指定できる値:

EVENT構造体の内容:

※statには、イベント時刻情報が含まれる。

EVENT構造体のtypeに指定できる値:

（３）出力データ

アプリケーションへは以下の出力データが渡される。

※パーツが有効動作をした場合には、valにGC_ACT(0x1000)がorされる。

エラーコードの内容:

（４）例外条件及び制約条件

• 生成可能な最大パーツ数は、システム全体で256個である。
• 指定された領域内に文字列が表示しきれない場合は、動作は保証されない。
• モーメンタリスイッチ・オルタネートスイッチ・スイッチセレクタ・スクロールセレクタ・シリアルセレクタの場合、 strで示される領域は、表示の際に参照されるので、パーツを削除するまで解放してはならない。

（５）特記事項

なし。

（６）機能ブロックの構成及び関連

パーツ管理機能は、 小機能である「モーメンタリスイッチ管理機能」「オルタネートスイッチ管理機能」「スイッチセレクタ管理機能」「スクロールセレクタ管理機能」「シリアルセレクタ管理機能」「ボリューム管理機能」から構成される。

┌────────────────────────┐
│パーツ管理機能                                  │
│                                                │
│┌──────────┐┌──────────┐│
││モーメンタリスイッチ││オルタネートスイッチ││
││            管理機能││            管理機能││
│└──────────┘└──────────┘│
│┌──────────┐┌──────────┐│
││スイッチセレクタ    ││スクロールセレクタ  ││
││            管理機能││            管理機能││
│└──────────┘└──────────┘│
│┌──────────┐┌──────────┐│
││シリアルセレクタ    ││ボリューム          ││
││            管理機能││            管理機能││
│└──────────┘└──────────┘│
└────────────────────────┘

        図 パーツ管理機能の機能ブロック相互関係

モーメンタリスイッチ管理機能・オルタネートスイッチ管理機能・スイッチセレクタ管理機能・スクロールセレクタ管理機能・シリアルセレクタ管理機能・ボリューム管理機能は、直接、他の小機能を呼び出してデータのやり取りをおこなうことはない。しかし、それぞれの小機能は、パーツの管理に関する情報を共有している。

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

付録１．３．２ オルタネートスイッチ管理機能

（１）機能説明

パーツ管理機能のうち、オルタネートスイッチの管理をおこなう機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）オルタネートスイッチ生成機能

入力データで指定された「パーツ生成情報」にしたがって、入力データで指定された「描画環境ID」上に、パーツを生成する。生成したパーツのパーツIDを、出力データとして返す。

（Ｂ）オルタネートスイッチ削除機能

入力データで指定された「パーツID」で示されるパーツを削除する。

（Ｃ）オルタネートスイッチ表示機能

入力データで指定された「パーツID」で示されるパーツの状態を、入力データで指定された「パーツ状態指定」にしたがって変更し、画面への表示をおこなう。

（Ｄ）オルタネートスイッチ設定機能

入力データで指定された「パーツID」で示されるパーツの内容を、入力データで指定された「パーツ文字列」「パーツ現在値」の内容で置き換える。

（Ｅ）オルタネートスイッチ取得機能

入力データで指定された「パーツID」で示されるパーツの内容を、出力データとして返す。

（Ｆ）オルタネートスイッチ動作機能

入力データで指定された「パーツID」で示されるパーツに対し、入力データで指定された「イベント」にもとづいた動作をおこなわせる。動作の結果を、出力データとして返す。

（２）入力データ

オルタネートスイッチ管理機能には、アプリケーションから以下の入力データが渡される。

（Ａ）オルタネートスイッチ生成機能の場合

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PARTS構造体の内容:

※パーツ文字列の終端には、TNULLを指定する。

PARTS構造体のtypeに指定できる値:

（Ｂ）オルタネートスイッチ削除機能の場合

（Ｃ）オルタネートスイッチ表示機能の場合

modeに指定できる値:

（Ｄ）オルタネートスイッチ設定機能の場合

※パーツ文字列の終端には、TNULLを指定する。

（Ｅ）オルタネートスイッチ取得機能の場合

※パーツ文字列の終端には、TNULLが格納される。

（Ｆ）オルタネートスイッチ動作機能の場合

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

EVENT構造体の内容:

※statには、イベント時刻情報が含まれる。

EVENT構造体のtypeに指定できる値:

（３）出力データ

アプリケーションへは以下の出力データが渡される。また、「(C)オルタネートスイッチ表示機能」の場合、システムコールの副作用として画面への表示がおこなわれる。

（Ａ）オルタネートスイッチ生成機能の場合

※cidは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパーツIDを示す。

エラーコードの内容:

（Ｂ）オルタネートスイッチ削除機能の場合

エラーコードの内容:

（Ｃ）オルタネートスイッチ表示機能の場合

エラーコードの内容:

（Ｄ）オルタネートスイッチ設定機能の場合

エラーコードの内容:

（Ｅ）オルタネートスイッチ取得機能の場合

※valは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパーツ現在値を示す。

エラーコードの内容:

（Ｆ）オルタネートスイッチ動作機能の場合

※valは、値が負の場合にはエラーコードを示し、値が0または正の場合にはパーツ現在値を示す。

※パーツが有効動作をした場合には、valにGC_ACT(0x1000)がorされる。

エラーコードの内容:

（４）例外条件及び制約条件

• 生成可能な最大パーツ数は、システム全体で256個である。
• 指定された領域内に文字列が表示しきれない場合は、動作は保証されない。
• strで示される領域は、 表示の際に参照されるので、パーツを削除するまで解放してはならない。

（５）特記事項

なし

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

typedef struct  {
  W       type;
  PNT     pos;
  TC      key;
  UW      stat;
} EVENT;

付録１．３．５ シリアルセレクタ管理機能

（１）機能説明

パーツ管理機能のうち、シリアルセレクタの管理をおこなう機能を提供する。

以下の機能がシステムコールの形で提供される。

（Ａ）シリアルセレクタ生成機能

入力データで指定された「パーツ生成情報」にしたがって、入力データで指定された「描画環境ID」上に、パーツを生成する。生成したパーツのパーツIDを、出力データとして返す。

（Ｂ）シリアルセレクタ削除機能

入力データで指定された「パーツID」で示されるパーツを削除する。

（Ｃ）シリアルセレクタ表示機能

入力データで指定された「パーツID」で示されるパーツの状態を、入力データで指定された「パーツ状態指定」にしたがって変更し、画面への表示をおこなう。

（Ｄ）シリアルセレクタ設定機能

入力データで指定された「パーツID」で示されるパーツの内容を、入力データで指定された「パーツ文字列」「パーツ現在値」の内容で置き換える。

（Ｅ）シリアルセレクタ取得機能

入力データで指定された「パーツID」で示されるパーツの内容を、出力データとして返す。

（Ｆ）シリアルセレクタ動作機能

入力データで指定された「パーツID」で示されるパーツに対し、入力データで指定された「イベント」にもとづいた動作をおこなわせる。動作の結果を、出力データとして返す。

（２）入力データ

シリアルセレクタ管理機能には、アプリケーションから以下の入力データが渡される。

（Ａ）シリアルセレクタ生成機能の場合

typedef struct {
  W       type;
  RECT    r;
  W       val;
  TC      *str;
} PARTS;

※名称の欄に「§」をつけた項目については、このあとにその内容の説明がある。

PARTS構造体の内容:

※パーツ文字列の終端には、TNULLを指定する。

PARTS構造体のtypeに指定できる値:

（Ｂ）シリアルセレクタ削除機能の場合

（Ｃ）シリアルセレクタ表示機能の場合

modeに指定できる値:

（Ｄ）シリアルセレクタ設定機能の場合

※パーツ文字列の終端には、TNULLを指定する。

（Ｅ）シリアルセレクタ取得機能の場合