一応、XWindow Realtime Simulation の略で、その名の通り、XWindow で
realtime simulation（または単なるグラフィック）をするためのプログラ
ムライブラリです。C＋＋ で書かれていますが、Cプログラムでも利用でき
ます。

XWindow コマンドでいちからプログラムを組むと結構厄介なうえ、させたい
仕事の計算は１０行で済んでいてもグラフィックのために数ページのプログ
ラムになってしまうことがあります。

XRS は
 ＊ウィンドウを気楽に開く。
 ＊パラメータの値を表示してプログラム実行中にチューニングする。
 ＊好みの色を用意する。（連続的に変化する色を作ることも可。）
 ＊簡単なマウスイベントの設定。
を個々のプログラムの中で簡単にできるようにするためのライブラリで、
XWindow グラフィックの補助ツールです。

内部の構造を C＋＋ らしく全面改装したため、XRS version 2 との互換性
はなくなってしまいました。（相済みません。） version 3 は
 ＊ウィンドウ、ダイアログのオブジェクト化。
    （個別の調節や機能拡張が可能。個数制限がなくなる。）
 ＊すべての設定がプログラムの途中でも変更可能。
 ＊ヘッダファイルが分割されている。
    （必要な部分だけをリンクできる。）
 ＊int,Complex 型変数が使える。
 ＊Xリソースによるカスタマイズ。
などなどの特徴があります。XRS ver.2 で何も困らなかった人には迷惑なだ
けかも知れませんが（今まで通り、ver.2 をお使い下さい。）、ちょっと複
雑なことをすると”違いがわかる”と思います。


＜今までの歴史＞

プログラムの元： 蔵本研の渡辺氏が書いた C のプログラムで、水口さん、
                 佐々さんを経て私の手に来ました。

初期のころ：そのプログラムからグラフィック関係の部分を取り出して
            ヘッダファイルにまとめて個人的に使っておりました。

XRS ver.0〜ver.1: 中身は基本的に C のままで外装に << や多重定義を使
                  って C＋＋ で書き直しました。

XRS ver.2 (1994.9.18〜) : ライブラリ化して内輪に公開。

XRS ver.3 (1996.4.  〜) : 内部を C++ で改装。オブジェクト化。

その後の変更点は See section バグ、変更点のメモ. を見て下さい。


＜今後の予定＞

当分、バグとり。（必要に応じて、新種のウィンドウを追加するかも。）
私の周りのワークステーションの性能が上がって、快適なコンパイルができ
るようになったら iostream.h や list.h などの C＋＋ 標準ライブラリを
使って書き換え、dialog クラスなどのテンプレート化をするかもしれない。
今回のような根本的なプログラムの構造の変更は（致命的なバグがない限り）
ないと思います。


＜おことわり＞

製造物責任は免除してください。
ただし、バグのお知らせ（マニュアルを含む）、改良案、相談、議論（本業
の方も） などなど歓迎です。 

マニュアルはほぼすべて昔書いたままですが、インストールの部分だけは
あまりにも記述が古いので書き直しました。(2009.12.6)

以下の組合せでコンパイルして無事に動くことは確認済みです。
書いてあるのは一番最近、動作確認した組合せです。手元にない OS では最近
テストしていませんが、XRS の最新のバージョンもバグとりしただけなので
おそらく動くでしょう。

  OS                       XRS       compiler       X11
Linux(Ubuntu 18.04)       3.3.0      gcc7.3.0      XOrg7.7
Linux(Vine 4.2)           3.2.17     g++3.2.0      XOrg 6.7
Linux(Vine 4.2)           3.2.17     intel_c++8.0  XOrg 6.7


!注意!

まずXWindow(XOrg,Xlib)を使ってプログラムをするための環境が必要です。
以下の手順で必要がコマンドやファイルがないというエラーがでた場合は、
たとえば Ubuntu OS なら　xorg-dev,libx11-dev,xutils,xutils-dev 
をパッケージマネージャを使ってインストールしてください。 

０）XRSver3.2.??.tar.gz をダウンロードして
     > tar xzvf XRSver3.2.??.tar.gz [return] で展開。
     > cd XRSver3.2.??

１）デフォルトの設定値は <XRS/define.h> で定義されているので必要なら
    適当に変えてください。（後でカスタマイズできないのはリソースファイ
    ル名の XRS_RESOURCE_FILE だけです。）

   Imakefile の中のインストール先ディレクトリ
      XRSBINDIR = /usr/local/bin
      XRSLIBDIR = /usr/local/lib
      XRSHDRDIR = /usr/include
   などと g++ のインクルードファイルへのパス
      GCCDIR = /usr/include/c++
   などを必要に応じて変更してください。

２）> xmkmf
    > make all     
    > make install または sudo make install 

３）マニュアル
    doc の下にこのマニュアルがあります。

miya.C というプログラムをコンパイルするなら、例えば以下のようにしてください。

[Linux-OS の場合]
g++ -O4 miya.C -o miya -lX11 -lXrs -lm
としてください。

!XRSver3.3.0からソースファイルに using namespace XRS; が必要になりました。

システムによっては、
g++ -O4 -I/usr/X11R6/include -o miya.C -o miya -lXrs -L/usr/X11R6/lib -X11 -lm
のようにXWindow 関係のファイルの場所を指定する必要がある場合があります。


※ オプション -lXrs は XRS ライブラリをリンクするオプションで、XRSは
   内部で XWindowライブラリ、数学関数ライブラリを使っているので
   -lX11,-lm も必要です。オプションの順番にも注意して下さい。

※ C++ライブラリのリンクオプション -lg++, -lstdc++ が gcc のバージョンに
   よっては <complex.h> を使う時に必要です。
   (-lstdc++ は complex.h 用の cmath.h の中の関数を使う時必要です。）

※ テンプレートを使っている場合(complex型など）、-O 以上の最適化をし
   ないととテンプレート展開されずリンクのときにエラーがでます。

——- test0-0.C ————-
#include <XRS/Simple.h>
using namespace XRS;
int main(){
  initialize();
  while(1) checkevent();
  exit(0);
}
—————————–

※このプログラムは実際に走らすとなにもせず走りっぱなしになります。
（Control-C で止めて下さい。）

XRSを使うにはこのように
（１）必要なファイルをインクルードする。（この場合は XRS/Simple.h)
（２）必要に応じて初期設定をしてから initialize();を実行する。
（３）計算ループのなかで checkevent(); を実行して変数の表示やマウス
      クリックの処理をさせる。
という手順が必要です。

幅２００pixel、高さ１００pixel のウィンドウを１つ開くなら 
Simple_Window型の変数を１つ宣言してください。
——- test0-1.C ————-
#include <XRS/Simple.h>
using namespace XRS;
Simple_Window A(200,100);
int main(){
  initialize();
  while(1) checkevent();
  exit(0);
}
—————————–

宣言だけしといてウィンドウの大きさを後で geometry(width,height) 関数
で決めても同じです。
——- test0-2.C ————-
#include <XRS/Simple.h>
using namespace XRS;
Simple_Window A;
int main(){
  A.geometry(200,100);
  initialize();
  while(1) checkevent();
  exit(0);
}
—————————–

これだけでは味気ないのでタイトルをつけてみます。タイトルの設定は <<
演算子で行ないます。（ <<演算子はふつうC＋＋では左辺に右辺を入力する
という意味で使います。）A.geometry(200,100)<<"How are you?"; のよう
に続けて書くこともできます。
——- test0-3.C ————-
#include <XRS/Simple.h>
using namespace XRS;
Simple_Window A(200,100);
int main(){
  A<<"How are you?";
  initialize();
  while(1) checkevent();
  
}
—————————–

途中で変更するときもおなじです。

２つ以上のウィンドウを開きたい時も同じように宣言してください。
——- test0-4.C ————-
#include <XRS/Simple.h>
using namespace XRS;
Simple_Window A,B;
int main(){
  A.geometry(200,100)<<"I’m not Windows.";
  B.geometry(400,50)<<"I’m a window.";
  initialize();
  while(1) checkevent();
  exit(0);  
}
—————————–

Control-C で止めるなんてことはせず、ちゃんとスタートと終りがあった方
がいいなら <XRS/Control.h> をインクルードして、 Control_Window型の変
数を宣言してください。
——- test0-5.C ————-
#include <XRS/Control.h>
using namespace XRS;
Control_Window C;
int main(){
  initialize();
  while(1) checkevent();
  
}
—————————–

実行すると initialize() でコントロールウインドウに "start" を表示し
て一時停止します。"start" がクリックされると "quit" に表示が変わり
実行を再開します。"pause" 欄をクリックするとプログラムの実行を一時停
止し（"cont" を押すと再開）、"quit" をクリックすると終了します。
マウスクリックの検出は while ループの中で checkevent() を実行するた
びに行なわれます。


さきほどのプログラムと組み合わせるとこうなります。
——- test0-6.C ————-
#include <XRS/Control.h>
#include <XRS/Simple.h>
using namespace XRS;
Control_Window C;
Simple_Window A(200,100);
int main(){
  A<<"I am A.";
  initialize();
  A.geometry(100,200);
  while(1) checkevent();
  exit(0);  
}
—————————–

タイトルの設定は "start" クリック前に、リサイズはクリック後に行なわ
れます。

<XRS/Graphic.h> をインクルードすると Graphic_Window という２次元グラ
フィック専用ウィンドウを使えます。Graphic_Window も geometry関数やタ
イトル設定の<<演算子が使えます。

これはランダムに点を打つプログラムです。( drand48()は 0〜1 の
一様乱数を返す C の関数。)
——- test0-7.C ————-
#include <stdlib.h>
#include <XRS/Graphic.h>
using namespace XRS;
#define RANDOM (int)(200*drand48())
Graphic_Window A;
int main(){
  A.geometry(200,200)<<"random plot";
  initialize();
  while(1){ checkevent(); A.draw_point(1.0,RANDOM,RANDOM);}
  exit(0);  
}
—————————–

draw_point(double c,int i,int j) は点を打つ関数で、(i,j) の位置に c
の値で決まる色の点を描きます。 
A.geometry(200,200) を A.geometry(200,200,2) に変えてみてください。
ウィンドウのサイズが２倍になり 2 x 2 pixel を点とみなして描画します
。（Simple_Window にはこの３番目の引数はありません。）

その他に (i1,j1)から(i2,j2)まで直線を引く
draw_line(double c,int i1,int j1,int i2,int j2) と
(i,j) を中心とする半径 r の円を描く
draw_circle(double c,int i,int j,double r) があり同じように使えます。


c の値をまとめて配列で与えて画面全体を一度に描画する場合は
draw_2D(double **c) が使えます。 c[i][j]に座標(i,j)に描く色を代入し
て与えます。ただし、draw_2D には動的にメモリーを確保したdouble**型の
２次元配列を与えてください。
——- test0-8.C ————-
#include <XRS/Graphic.h>
using namespace XRS;
Graphic_Window A(200,200);
int main(){
  A<<"sin";
  initialize();

  int i,j;
  double  **c; array(c,200,200);
  for(i=0; i<200; i++)
     for(j=0; j<200; j++) c[i][j]=sin(M_PI*(double)i/50);

  A.draw_2D(c);        
  while(1) checkevent();
  exit(0);  
}
—————————–

array 関数は動的２次元配列をとる関数で、double 型だけでなく
任意の型の動的２次元配列をとることができます。（たとえば、int型の配
列をとるなら int **c; array(c,200,100); とする。）

描かれる色はオリジナルに用意して使うことも簡単にできますが、単色で濃
淡（飽和度）が段階的に変わる配色と色相（赤→緑→青→赤）が変わる配色
はそれぞれ <<に続けて MONO(double h,int n) とPHASE(double h, int n)
を書くだけで使えます。( h は色相、nは色数です。n は省略するとデフォ
ルトのままです。）たとえば、上のプログラムの A<<"sin"; を
    A<<"sin"<<MONO(0.4);     //白→黄緑のmonotone
や  A<<"sin"<<PHASE(0.5,10); //水色からはじまるphasetone
と変えるとそれに応じて色が変わります。

引数に与える数値 c と色の対応（グラデーション）は double を返す関数
を定義して << で設定することで変更できます。関数の返り値は ０〜１の
範囲になるようにしてください（デフォルトでは１を越えると黒が０以下な
ら白になります）。例えば、上のプログラムでは -1<=c<=1 なので
    double f(double c){ return 0.5*(c+1); }
    A<<"sin"<<f;
とすると飽和度が線形に変化するグラデーションが得られます。デフォルト
の状態ではこの関数は double f(double c){ return AMPF*c*c; } (AMPF
はXRS/define.hで定義されている定数）になっています。


同じように << で void (*)(int)型関数を設定するとウィンドウがクリック
された時、引数に押されたマウスボタンの番号を与えてその関数が実行され
ます。（これは Simple_Window でも同様です。）
——- test0-9.C ————
#include <XRS/Simple.h>
using namespace XRS;
void g(int n){ printf("Oh!,%d’th mouse button was clicked.\n",n);}
Simple_Window A;
int main(){
  A.geometry(300,100)<<g<<"Please, click a mouse button.";
  initialize();
  while(1) checkevent();
  exit(0);  
}
—————————–


Control_Window では << の後に続けて複数の void (*)(int) 関数を登録
して欄を作り、<<"文字列" で欄のタイトルを設定できます。同様に、<<で
 double型、int型変数を設定するとその変数値の realtime 表示をする欄を
作ります。

<<PARAMETER の後ろに double 型または int 型変数を設定するとはマウス
クリックで変数の値を変えることができます。（PARAMETER を使うたびに
realtime 表示 ⇔ パラメータチューニング が切り替わります。）
——- test0-10.C ————-
#include <XRS/Control.h>
using namespace XRS;

Control_Window C;
int    b=0;
double a=12,answer;

void   clear(int){ answer=a=b=0; }
void   print(int){ printf("(double)%f+(int)%d=%f\n",a,b,answer);}

int main(){
  C<<answer<<clear<<"answer"<<"clear"
   <<PARAMETER<<a<<b<<"a"<<"b"<<print<<"print";
  initialize();
  while(1){ checkevent(); answer=a+b; }
  exit(0);  
}
—————————–

このプログラムでは answer(=a+b) の値をreal time で表示する欄と a 、 
b の値をチューニングする欄ができ、マウスクリックで a や b の値を変え
ると answer の値がそれに応じて変わります。

たとえば実数の変数 a は普通、初めの変化の刻み幅 dx は 1.0 で
 ┌─────┐      
 │　　ａ　　│← タイトル欄を右ボタンでクリックすると dx 増える。
 ├─────┤
 │１２．００│← 変数欄を右ボタンでクリックすると dx 減る。
 └─────┘
  タイトル欄をまん中ボタンでクリックすると 0.1*dx 増える。
      変数欄をまん中ボタンでクリックすると 0.1*dx 減る。
  タイトル欄を左ボタンでクリックすると dx が１０倍になる。
      変数欄を左ボタンでクリックすると dx が １／１０になる。

というふうになります。整数型の b は dx=10 が初期値なのが普通で、dxは
10 以下にはなりません。右ボタンで変化する桁は色をかえて表示してあり
ます。（Control_Window は double型とint型の変数を設定できます。Compl
ex型も使いたい人は Complex_Control_Window を使って下さい。）

clear をクリックすると answer=a=b=0; となり answer の表示は０になり
ますが a,b 欄は次に欄がクリックされるまでは前の値を表示し続けます。
これが realtime 表示と普通の表示との違いです。一度 "pause" をすると
変数は正しく表示し直されます。

XRSについている描画関数はそれほど複雑なことはできません。そのかわ
り、XWindow の豊富なコマンドを簡単に使えるようにしています。
（ただし、XWindow のコマンドを使って書いた絵は XRS とは無関係なので
ウィンドウが隠されたときの再描画などは普通おこなわれません。）

XWindow のコマンドを使うには
（１）ディスプレイID  Display*
（２）ウィンドウID    Window
（３）グラフィックコンテキスト（色や線幅などの属性）GC

を引数で指定する必要がありますが、XRSではウィンドウ名を W とすると
（１）Display *d=W.disp();   disp()関数の返り値
（２）(Window)W;             そのまま使うと型変換される
（３）GC gc=graphic_context("blue");  graphic_context関数で作る
という風にすると使えます。

例えば、(i1,j1)から(i2,j2)への直線を引く XWindow コマンドは
 XDrawLine(Display*,Window,GC,int i1,int j1,int i2,int j2); 
なので、
——- test0-11.C ————-
#include <XRS/Simple.h>
using namespace XRS;
Simple_Window W(100,100);
int main(){
  GC gc;
  gc=graphic_context("blue");
  initialize();
  XDrawLine(W.disp(),W,gc,10,10,90,90);
  while(1) checkevent();
  exit(0);  
}
—————————–

とすると青の直線が引けます。

graphic_context関数は graphic_context(char "色名",int 線幅,
int 線のタイプ,char "フォント名"); を引数で指定できます（省いたら
デフォルトのまま）。たとえば、上の gc を
  gc=graphic_context("red",3,LineOnOffDash); //太さ３の赤の点線
などとできます。（ LineOnOffDash は #define で定義されているマクロ
で他に LineSolid, LineDoubleDash があります。）
  
Simple_Window や Graphic_Window では黒と白の GC だけは既に bgc,wgc
という名前でウィンドウごとに持っているので、gc=graphic_context("blac
k");とする代わりに gc=A.bgc; などとしてもいいです。


XWindow コマンドで良く使うものは 

• (i,j)に点を書く。
  XDrawPoint(Display*,Window,GC,i,j);  
  
  

• まとめて N 個点を書く。（早い）
  XPoint p[N]; と宣言して
  p[i].x、p[i].y に i 番目の点の x、y 座標を代入した後
  XDrawPoints(Display*,Window,GC,p,N,CoordModeOrigin);
  
  

• (i1,j1)から(i2,j2)まで直線を書く。
  XDrawLine(Display*,Window,GC,i1,j1,i2,j2);
  
  

• まとめて N 個直線を書く。（早い）
  XPoint p1[N],p2[N]; と宣言して
  XDrawPoints(Display*,Window,GC,p1,p2,N,CoordModeOrigin);
  
  

• 左上の隅が(i,j)の幅 width、高さ height の長方形を書く。
  XDrawRectangle(Display*,Window,GC,i,j,width,height);
  
  

• 中が塗りつぶされた長方形を書く。
  XFillRectangle(Display*,Window,GC,i,j,width,height);
  
  

• 左上の隅が(i,j)の幅 width、高さ height で角度(angle1,angle2)の
  範囲の円弧を描く。角度は 1/64 度単位の整数で指定する。ちなみに
  円を書きたいなら、arg1=0,arg2=360*64=23040 にする。
  XDrawArc(Display*,Window,GC,x,y,width,height,angle1,angle2);
  
  ※円を描く関数はないので、
  #define XCircle(D,W,G,x,y,r) XDrawArc(D,W,G,x-r,y-r,2*r,2*r,0,23040);
  とでもマクロ定義すればいいでしょう。
  
  

• 塗りつぶされた扇型を書く。
  XFillArc(Display*,Window,GC,x,y,width,height,angle1,angle2);
  

ぐらいです。消すときは普通、白で書き直します。Window 全体の
クリアーは XClearWindow(Display*,Window); でできます。

まぁ、もっといろいろやりたい人は XWindow のマニュアルを見て下さい。

あと付け加えるとしたら、（W を Simple_Window型の変数として）
 * W.clear(); はウィンドウをクリアーします。

 * geometry 関数は正式には４つ引数があって
   W.geometry(width,height,i,j); のように (i,j) を与えると位置(i,j)
   へウィンドウを移動します。引数が負の値なら現状維持です。

ぐらいです。

イベントやウィンドウの基本操作はだいたい Simple_Window と同じです。
違うのは、大きさの指定に mesh size( draw_point や draw_2D で描画する
時の点の大きさ）が加わっていることです。

（ W を Graphic_Window型の変数として）
 * geometry 関数は正式には５つ引数があって
   W.geometry(i_max,j_max,ms,i,j); とすると、位置(i,j)、メッシュサ
  イズ ms ピクセル、幅 ms*i_max ピクセル,高さ ms*j_max ピクセルに変
  更されます。これは、W.resize(i_max,j_max,ms); W.move(i,j); とやっ
  ても同じです。引数が負の値なら変更されません。

 * int W.width(),W.height(); はそれぞれ ms*i_max, ms*j_max を返しま
   すが、その他に int W.mesh_size(),W.i_max(),W.j_max(); はそれぞれ
   ms,i_max,j_max を返す関数です。

‘色サンプルウインドウを作る’

void sample_window(Graphic_Window W) は引数で指定された Graphic_Wind
ow W に W.draw_point、W.draw_2D で使われる配色の簡単な色のサンプルを
描く関数です。

------- test1-4.C ------------- #include <XRS/Graphic.h> using namespace XRS; Graphic_Window A; void change_size(int n){ A.geometry(-1,-1,n); } int main(){ A.geometry(200,100)<<"color sample"<<PHASE(0.6,10)<<change_size; initialize(); sample_window(A); while(1) checkevent(); exit(0); } -----------------------------

このプログラムはマウスがクリックされるとボタンの番号 n を与えて、
A.geometry(-1,-1,n);が実行され、メッシュサイズが n に変更されます。
（同時にウィンドウはリサイズされる。） sample_window(A) や 
draw_point ,draw_2D で書いた内容なら同時にリサイズされます。

‘色の決まり方’

draw_point(double w,int i,int j); などで与えた数値 w から実際に描か
れる色が決まる方法は次のようになります。

各 Graphic_Window は内部に
  "色関数" double f(double);     
  "色配列" unsigned long color[i]; i=0,,,N+1; （Nは色数）
を持っています。"色配列" は MONO,PHASE などで設定でき、"色関数"は 
<< 演算子で設定できるのは初泣編で説明した通りです。

"色配列" に入っているのが実際に表示される色に対応するカラーピクセル
と呼ばれる番号です。w を与えると
  n=(int)(f(w)*colornumber);
  if(n<0) i=N+1; else if(n>=N) i=N; else i=n;
によって描かれる色 color[i] が決まります。color[N]は黒、color[N+1]
は白が普通ですが変更することもできます。
（カスタマイズでやるのが一番楽）

‘オリジナルな色を使う’

「MONO,PHASE などの標準的な配色では使えん」という場合、オリジナルな
配色を作る一番手軽な方法は使いたい色名を並べたテキストファイルを作っ
てCOLOR("ファイル名")で読み込ませることでしょう。

ファイルには１行に１つの色名を書いて並べてください。( ’!’ から始まる
行はコメントとみなされます。）例えば、

----- color0 ------- ! color resource sample red blue green --------------------

というようなファイルを作ります。色名は XWindow で使える形式すべてで
す。次のファイルは色名をRGB値形式で書いた例です。（#に続いて１６進数
２桁ずつで red,green,blue の輝度を書く形式 #rrggbb)

----- color1 ------- #ff0000 #2a00ff #00ff54 #f6ff00 --------------------

このファイルは gimp か xcoloredit を利用すると簡単に作れます。

gimp の場合は、gimp を起動して、新規画像を[種類] RGB で [サイズ]を
ピクセルで(幅)欲しい色数 x(高さ)1 と指定して開いてから、拡大表示(16:1な
ど)で見ながら各ピクセルに使いたい色を順に並べてください。
出来たファイルを[保存]で Xpm 形式を選んで適当な名前(例えば gomi.xpm)で
保存してください。あとは、コマンドラインで
 perl -nle ’print $1 if /(#\w+)/;’ gomi.xpm > color1 など
と打てばできあがりです。

xcoloreditの場合は、UNIX のコマンドラインで xcoloredit >color1 [return]
 として、画面に出てくるパレットに作った色を並べて終了すればファイルが
出来上がります。

プログラム中でこれを読み込ませるには例によって << を使って、

------- test1-5.C ------------- #include <XRS/Graphic.h> using namespace XRS; Graphic_Window A(200,100); int main(){ A<<COLOR("color1"); initialize(); sample_window(A); while(1) checkevent(); exit(0); } -----------------------------

とします。

自分で色配列 unsigned long color[i]; i=0,,,N-1; を作って直接指定す
ることも可能です。
  A<<COLOR(color,N);
  
欲しい色のカラーピクセルは色の名前を指定して
  color[0]=color_pixel("red");
あるいは、色相 h,飽和度 s,明度 v を指定して
  color[1]=color_pixel(h,s,v);
のようにして得ることができます。

このようにして取った色の番号を直接指定して描画させるには
  point(int c,int j,int j);
  line(int c,int i1,int i2,int j1,int j2);
  circle(int c,int i,int j,double r);
  draw_2D(int **c);
を使って下さい。 c が色の番号であることを除けば、
draw_point(double,,)、draw_line(double,,,,)、
draw_circle(double,,,)、draw_2D(double **)
と使い方は同じです。

‘位相を色で振幅を濃淡で表示する’

それ用の色配列を unsigned long* colordisk(int nr,int np) 関数で取
ることができます。 ここで、nr は振幅方向の色の数、np は位相方向の
色の数です。返ってきた配列は nr*np 個の要素を持ちます。

この色配列の中の振幅 r（0<r<1）、位相 phi(２π周期）に対応する色
の番号を返す関数が int diskcolor(double r,double phi,int nr,
int np) です。

この２つの関数を使うと例えば、

------- test1-15.C ------------- #include <XRS/Graphic.h> using namespace XRS; int main(){ W<<COLOR(colordisk(6,8),6*8); initialize(); double r,phi; for(int i=-50; i<50; i++) for(int j=-50; j<50; j++){ if(i || j){ r=sqrt((double)(i*i+j*j))/50; phi=atan2((double)i,(double)j); W.point(diskcolor(r,phi,6,8),i+50,j+50); } } while(1) checkevent(); exit(0); } -----------------------------

のように色配列が２次元であるかのように色を出せます。

ちなみに、 colordisk と diskcolor の中身は

unsigned long* colordisk(int ni,int nj){ unsigned long *cp=new unsigned long [ni*nj]; for(int i=0; i<ni; i++) for(int j=0; j<nj; j++) cp[i*nj+j]=color_pixel((double)j/nj,(double)i/ni,1); return cp; } int diskcolor(double r,double phi,int ni,int nj){ phi/=2*M_PI; if( phi>=1 || phi<0 ) phi-=floor(phi); return (int)(nj*((int)(r*ni)+phi)); }

  という簡単なものです。ただし、関数 diskcolor は変数が振幅と位相な
ので、一々 sqrt とか atan とかを使って振幅、位相の計算を毎回すると
効率が悪すぎます。
  用途に応じてもっと効率の良い似たような関数を作って使ってください。
  例えば、Complex 変数を使っているなら、実部と虚部から簡単に計算でき
るように色配列を並べると早くなります。以下は、複素平面を一辺
2*Color+1 個の正方格子に区切って各 site にその振幅と位相に対応する
色を与えて並べているものです。

#define Color 5 unsigned long* colordisk(){ unsigned long *cp=new unsigned long [(2*Color+1)*(2*Color+1)]; double r,phi; int i,j,k; for(i=-Color; i<Color+1; i++) for(j=-Color; j<Color+1; j++){ k=i+Color+(j+Color)*(2*Color+1); r=sqrt((double)(i*i+j*j))/(double)Color; if(i==0 && j==0) phi=0; else phi=atan2((double)i,(double)j)/(2*M_PI); cp[k]=color_pixel(phi,r,1); } return cp; } int diskcolor(Complex w){ static int cn=2*Color+1; w+=Complex(1,1); w*=Color; return (int)real(w)+(int)imag(w)*cn; } これは、 #define ColorNumber (2*Color+1)*(2*Color+1) W<<COLOR(colordisk(),ColorNumber); W.point(diskcolor(w[i][j]),i,j); のように使えます。

‘メモリーの節約’

Graphic_Window は内部に画面に描いた色を記憶しておく配列を動的に確保
して、描画の高速化や画面の再描画に利用しています。そのため、大きな画
面を何個も開くと各個人が使えるメモリーの限界を越えてしまうことがあり
ます。

特に描画の高速化や再描画が必要でなければ、<<MEMORY を書くことで内部
の配列のメモリーを解放してメモリーを節約できます。（もう一度、
<<MEMORY を書くと再び配列を確保する。）

例えばプログラム test16.C に A<<MEMORY; を加えるとマウスクリックでの
リサイズ後の再描画は行なわれません。（そのかわり、プログラムが使って
いるメモリーは小さくなる。）

Plane_Window は Graphic_Window の親戚で、色ごとに仮想的なプレーンを持
っていて重ね書きができます。複数のグラフを１つのウィンドウに重ねて書く
ときなどに便利だと思います。

宣言のし方や色のとり方は Graphic_Window と同じですが、描画関数の使い方
が少し異なり、
draw_point(int plane,int i,int j);
draw_line(int plane,int i1,int j1,int i2,int j2);
draw_circle(int plane,int i,int j,double r);
draw_2D(int **plane);

のように第一引数には描くプレーンの番号（色配列の色の番号）を与えて下さ
い。このように直接、色を指定するので Graphic_Window のような色関数は
ありません。また、Plane_Window には描いた図形を消すための
erase_point(int plane,int i,int j);
erase_line(int plane,int i1,int j1,int i2,int j2);
erase_circle(int plane,int i,int j,double r);
erase_2D(int **plane);
clear(int plane);

関数があります。描かれている図形を消すと下のプレーンに描かれて隠れてい
た図形が現れます。

ただし、Plane_Window で使えるプレーン数（色数）はメモリーの関係上３０
色までです。また、仮想的なプレーンのメモリー操作のために描画スピード
（特に図形を消去するスピード）がやや遅いのが欠点です。

------- test1-6.C ----------------
#include <XRS/Plane.h>
using namespace XRS;
Plane_Window A(100,100,3);
int main(){
  A<<"plane window"<<COLOR();  
  initialize();
  A.draw_line(1,0,0,100,100);
  A.draw_circle(2,50,50,40.0);
  A.draw_line(3,0,100,100,0);
  while(1) checkevent();
  exit(0);  
}
-----------------------------

コントロールウィンドウも宣言の時や、geometry 関数で大きさの指定がで
きますが引数の意味が少し違います。

Control_Window A(imax,jmax); あるいは
Control_Window A; A.geometry(imax,jmax);
のように int imax,jmax で大きさが指定されている時、コントロールウィ
ンドウはダイアログを以下のように並べてそれに合わせてウィンドウをリサ
イズします。
[imax > jmax の場合]
  1. ダイアログを登録順に縦に並べていき、並べたダイアログの高さの合
     計が jmax を越えるなら次の列に移る。
  2. ウィンドウの幅が imax を越えるなら、先頭の列に戻る。
  3. 1に戻る。（新しい段が足される。）
[imax < jmax の場合]
  横に並べて行を足していき、ウィンドウの高さが h を越えたら先頭の行
  に戻る。

geometry 関数は正式には４つ引数があって A.geometry(imax,jmax,i,j) と
(i,j) を書くとウィンドウを (i,j) に移動します。

int i_max(),j_max() はそれぞれ上の imax,jmax を返す関数です。

‘"start⇔quit、pause⇔cont"ダイアログを作らない。’

"start⇔quit、pause⇔cont" ダイアログは最初に宣言されたコントロール
ウィンドウに自動的に作られます。これをやめたければ、普通の宣言の場合
、３番目の引数に０を指定します。（０を指定せずに宣言した最初のコント
ロールウィンドウに作られる。）例えば、Control_Window A(100,50,0);。

‘Complex_Control_Window’

Complex型の変数も登録できることをのぞくと Control_Window と同じです
。使う時は、<XRS/Complex_Control.h> をインクルードしてください。
Complex 型の変数は"実部／虚部表示"か"極座標表示"のどちらかを選べ、デ
フォルトまたは <<RC<< の後に設定した変数は"実部／虚部表示"、<<PC<<の
後に設定した変数は"極座標表示"になります。極座標の角度の値はπで割っ
た値を表示します。

------- test1-7.C ------------- #include <XRS/Complex_Control.h> using namespace XRS; Complex_Control_Window A; int main(){ Complex a=0; A<<PARAMETER<<a<<"re/im"<<PARAMETER<<PC<<a<<"r/arg"; initialize(); while(1) checkevent(); exit(0); } -----------------------------

このプログラムでは変数 a を実部／虚部表示（デフォルト）して、マウス
クリックで値を変えられるようにし(PARAMETERを前に挟む）、次の欄で極
座標(PC)で値を realtime 表示(もう一度 PARAMETER を入れる)します。

XRS/Exec.h、XRS/DataSocket.h を使えば、gnuplot などのグラフィックソ
フトにデータを送り込んでリアルタイムシミュレーションをすることがで
きます。


class Exec は与えられたコマンドを子プロセスで実行して、その標準入力
との間にパイプを作ります。
例えば、

------- test1-8.C -------------
#include <XRS/Exec.h>
using namespace std;
using namespace XRS;
int main(){ 
  Exec cat("/bin/cat","cat","gomi"); 
  cat<<"This is a test."<<endl;
  exit(0);  
}
-----------------------------

は bin/cat の cat を実行し、標準入力に "This is a test.\n"( 自動的に
’\n’ が付け加えられます。）を送り込み、cat の出力をファイル "gomi" 
に書き出します。Exec の引数は ( コマンドの path 名、コマンド、
標準出力を書き出すファイル、標準エラー出力を書き出すファイル）です。
ファイル名を省略または NULL にするとリダイレクトをしません。


class DataSocket は与えられた名前のソッケトを開き、ファイルに書き込む
のと同様にそのソケットにデータを出力できます。出力されたデータは専用
のコマンド datasocket で受けっ取って標準出力に書き出すことができます。
（datasocket コマンドが実行されるまでプログラムの実行は中断します。）
例えば、

------- test1-9.C -------------
#include <iostream>
using namespace std;
#include <XRS/DataSocket.h>
using namespace XRS;
DataSocket S("gahaha");

int main(){
  int i,k;
  for(i=1; i<5; i++)
  { S.open();  for(k=0; k<i; k++) S<<k<<endl;  S.close();}
  return 0;
}
-----------------------------

は "gahaha" という名前のソッケト（！注意！ 同名のファイルが実行ディ
レクトリに作られるので、既にあるファイルと同じ名前にならないようにして
ください。）を開き、S.open() で datasocket コマンドからの接続要求を待
って datasocket との間に接続を作り、S.close() までに (FILE*)S に出力さ
れたデータを datasocket に送り込みます。

このプログラムを"test" という名前でコンパイルしてコマンドラインで
> test & [return]
とバックグラウンドで走らせた後、
> datasocket gahaha [return]
を４回実行すると順番にデータが書き出されます。

この２つを応用すると、

------- test1-10.C -------------
#include <math.h>
#include <XRS/Exec.h>
#include <XRS/DataSocket.h>
using namespace std;
using namespace XRS;

Exec gnuplot("gnuplot","gnuplot",NULL,"/dev/null");
DataSocket S("gomi_socket");

int main(){
   double t,x,y;
   gnuplot<<"set zrange [-1:1]"<<endl;
   gnuplot<<"set style data lines"<<endl;
   gnuplot<<"set pm3d"<<endl;
   gnuplot<<"set hidden3d"<<endl;
   
   for(t=0; t<20; t+=0.1){
      gnuplot<<"splot '< datasocket gomi_socket'"<<endl;
      S.open();
      for(x=0; x<10; x+=0.5){
        for(y=0; y<10; y+=0.5) S<<cos(x+y+t)<<endl;
        S<<endl;
      }
      S.close();
   }
  return 0;
}
-----------------------------

のように３次元シミュレーションもできます。
この例では "xrs_gomi_data" という名前のソケットを開き、gnuplot の
パイプ機能を利用して、"splot ’< datasocket xrs_gomi_data’" という
コマンドを実行させることで、splot に datasocket の出力を渡してい
ます。（S.open() は datasocket の実行を待つので datasocket を実行
する命令を出してから実行する必要があります。）

標準エラー出力を "dev/null" にすると gnuplot からの警告メッセージ
は一切出力しません。パイプ機能を使うと splot をするたびに 
Notice: 〜
というメッセージが出てくるので、プログラムにバグがないことを確認
したら "dev/null" を指定した方がいいでしょう。

！日本語バージョンの gnuplot+ はパイプ機能にバグがあって動きません。
  使う gnuplot が gnuplot+ でないことを確認してください。

Simple_Window や Graphic_Windowのマウスイベントや、コントロールウィ
ンドウの各ダイアログの動作は XRS では"dialog型"の変数で行なっていま
す。

"dialog型"はダイアログの動作の基本となる関数や変数をセットにした型（
クラス）で、dialog型を元にして作られた型（派生クラス）に void (*)(in
t)関数を扱う"f_dialog型"、double,int,complexをそれぞれ扱う"d_dialog
型","i_dialog型","c_dialog型"が変数の表示やマウスイベント処理を担当
しています。

したがって、これらのdialog型を直接扱うことでダイアログを個々に扱えま
す。ここでは、幾つかの例を上げて説明します。

‘Simple_Window のダイアログを表示する。’

Simple_Window や Graphic_Window は１つのダイアログを登録できます。普
通、<< で void (*)(int)関数を登録した時には自動的にその関数に対する
マウスイベント処理をする"f_dialog型"変数が宣言され、ダイアログの大き
さ（＝マウスクリックを受け付ける範囲）がウィンドウ全体にリサイズされ
ます。登録されたダイアログは表示(redraw)されないので見えません。

内部で宣言されたダイアログのポインタは dialog *event()関数で取り出せ
るので必要ならリサイズや表示ができます。

------- test1-11.C ------------- #include <XRS/Simple.h> using namespace XRS; void f(int n){ printf("%d\n",n); } Simple_Window A(200,200); int main(){ A<<"drawing a dialog"<<f; initialize(); dialog *p=A.event(); p->move(50,10); p->resize(120,40); p->title("F"); while(1) checkevent(); exit(0); } -----------------------------

この例では取り出したポインタ p の関数 
void move(i,j);            ダイアログの移動
void resize(width,height); ダイアログのリサイズ
void title(char *s);       タイトルを s に設定して redraw();
void redraw();             ダイアログの描画
を使ってウィンドウの一部にダイアログを表示しています。

‘Simple_Window で１つの変数を表示する。’

関数を処理する"f_dialog" の代わりに、別のダイアログを登録すれば変数
表示も可能です。（複数表示したいときはコントロールウィンドウを子ウィ
ンドウで開けばいいでしょう。）

------- test1-12.C ------------- #include <XRS/Simple.h> #include <XRS/d_dialog.h> using namespace XRS; Simple_Window A(200,200); int main(){ double t=0; A<<"display a variable"; initialize(); d_dialog p(A,t); p.title("t"); while(1){ checkevent(); p.draw(); t+=0.01;} exit(0); } -----------------------------

Simple_Window では普通 f_dialog しか使わないので、d_dialog 型のダイ
アログを使うには <XRS/d_dialog.h> をインクルードする必要があります。

d_dialog p(A,t); はダイアログの宣言です。引数は（登録される親ウィン
ドウ、処理の対象になるdouble変数）という形式です。タイトルを設定、表
示して、ループの中で変数の値を表示する void p.draw(); 関数を実行して
います。

‘Control_Window のダイアログの削除。’

コントロールウィンドウは複数の"dialog"を登録できます。普通は自動的に
<< で並べた関数や変数に応じて一つずつダイアログができます。ダイアロ
グへのポインタは 
 dialog *event(int n);   //  n 番目の dialog（負なら最後からの順番）
 dialog *event(char *s); // タイトルが s の dialog
で取り出せます。

--------- test1-13.C --------------------- #include <XRS/Control.h> using namespace XRS; Control_Window A; double x; void f(int){ dialog *d=A.event("X"); if(d){ delete d; d=NULL; A.redraw(); }else{ A<<x<<"X"; } } int main(){ A<<f<<"parameter"<<PARAMETER; initialize(); while(1) checkevent(); exit(0); } ---------------------------------------

この例では "parameter" 欄がクリックされるたびに "X" 欄があるか調べて
あれば delete で消滅させ（登録が削除されただけなので、コントロールウ
ィンドウを redraw() で書き直す必要がある。）、なければ新しく作ります
。

‘タイトルだけのダイアログを作る。’

ダイアログのポインタ dialog *d を取り出した後、変数 d.chev を調べる
とウィンドウがクリックされたときそのダイアログのどの欄がクリックされ
たか（クリックされていなかったら０）がわかります。それで、タイトルだ
けのダイアログも時には役に立ちます。

"f_dialog" 型の変数は通常、f_dialog p(親ウィンドウ,処理する関数); と
いう形で宣言しますが、処理する関数を与えないとタイトルだけのダイアロ
グが作れます。（ 残念ながら、<< では作れません。）

--------- test1-14.C --------------------- #include <XRS/Control.h> using namespace XRS; double a; Control_Window A(0,0,0); /*第１、第２引数の大きさは０以下を指定するとデフォルトのまま*/ int main(){ A<<PARAMETER<<a<<"A"; initialize(); f_dialog q(A); /* 第２引数を与えないで宣言 */ q.title("quit"); A.redraw(); while(!(A.chev && q.chev)) checkevent(); exit(0); } ---------------------------------------

この例では Control_Window の宣言時に三番目の引数に０を指定してデフォ
ルトの "start⇔quit"ダイアログ を使うことをやめ、自分で "quit" とい
うタイトルの空ダイアログを作っています。d.chev を調べてその欄がクリ
ックされていたら終了します。

 XRS のウィンドウの表示は Xリソース（.Xdefaults など）でいくらか好み
に合わせてカスタマイズできます。（Xリソースの書き方は XWindow のマニ
ュアルに書いてあるのでそっちを見てください。）

スタンダードな方法は各自のホームディレクトリにある".Xdefaults"ファイ
ルを使う方法です。".Xdefaults"ファイルに書いた場合その設定はすべての
プログラムで使われます。

また、プログラムのあるディレクトリの下に ".xrsrc" というファイル(こ
の名前はインストール時に変更されている可能性がある。）を作って書くこ
ともできます。この場合はそのディレクトリで走らせたプログラムでのみそ
の設定になります。

<例>

‘ダイアログのフォントをもう少し大きい 10x20 にする。’

--------------------------------- Xrs.Window.Control.Height: 60 Xrs.Dialog*Width: 120 Xrs.Dialog*Height: 30 Xrs*Font: 10x20 ---------------------------------

最初の３行でフォントが収まるようにダイアログの大きさ調節しています。

‘ダイアログを縦に並べる。’

--------------------------------- Xrs.Window.Control.Width: 240 Xrs.Window.Control.Height: 800 Xrs.Dialog*Width: 120 Xrs.Dialog*Height: 30 Xrs.Dialog*Shape: 1 ---------------------------------

最初の２行でコントロールウィンドウを縦長にして、
最後の Shape でダイアログに横長の形を指定しています。

class window を派生させて作ったウィンドウや class dialog から作った
ダイアログは自動的に XRS の基本的な機能を引き継ぎます。C＋＋の特徴
を生かせば、新しいウィンドウやダイアログを自由に付け加えることができ
ます。

この編では C＋＋使いのために機能拡張編を書こうかと思っていましたが、
 ＊ C＋＋使いならプログラムを読んだ方が早い。
 ＊ このマニュアル自身がプログラム本体より既に長い。
のでやめることにしました。

XRSver2 と XRSver3 は中身が全く違い、互換性もなくなってしまったので
、 ver.2 用のプログラムは手直しないと動きません。しかし、あまりマニ
アックなことをしていない限り、以下の書き換えをすれば済むはずです。
書き換えの例を ver.2のプログラム ⇒ ver.3 のプログラム というふうに
示します。

‘インクルードファイル’

#include <XRS/XRS.h> ⇒  #include <XRS/Control.h>
                         #include <XRS/Graphic.h>
※ draw_point() や draw_2D() を使っていない場合は <XRS/Graphic.h> よ
   り <XRS/Simple.h> のほうが軽くて便利。

‘ウィンドウの宣言’

XRS   X;             ⇒  Control_Window  CW;
                         Graphic_Window  W0,W1,,,;
※ Graphic_Window は必要なウィンドウの数だけ宣言する。

‘<<演算子の設定、初期化’

X<<EVENT<<func<<"FUNC"<<PARAMETER<<x<< "X"
 <<UNMAP(1)
 <<WINDOW(i,j,k)<<"title";
X.initialize(t); 
⇒ 
CW<<t<<"t"<<func<<"FUNC"<<PARAMETER<<x<<"X";
W0.geometry(i,j,k)<<"title"<<MEMORY;
initialize();  

※ X.、EVENT はいらない。
※ ウィンドウごと(CW,W0,,,)に設定。
※ X.initialize の引数はコントロールウィンドウ(Control)のPARAMETERの
   前に書く（タイトルが必要）。initialize() は引数をとらない。
※ サイズ指定 WINDOW(i,j,k) は (ウィンドウ名).geometry(i,j,k)。
※ <<UNMAP(1) を使っていたら、ウィンドウごとに <<MEMORY を指定。
※ MONO,PHASE の色は xcoloredit コマンドと同じになるように変更されま
   した。
    MONO(θ,n )  ⇒ MONO(θ/2π-1/6, n)
   とすればだいたい同じ色になります。

‘関数’

X.checkevent();       ⇒ checkevent(); 
X.draw_point(w,i,j);  ⇒ W0.draw_point(w,i,j);
X.draw_2D(P,0);       ⇒ W0.draw_2D(P);
X.clear_window(0);    ⇒ W0.clear();
sample_window(X,0);   ⇒ sample_window(W0);

gc=X.graphic_context(X.color_pixel("blue")); 
                      ⇒ gc=graphic_context("blue");
n=X.graphic_context(gc,"filename");
                      ⇒ n=graphic_context(gc,"filename");

P=array(i,j);         ⇒ array(P,i,j);

※ X.は要らない。
※ ウィンドウ番号はなくなり、各ウィンドウごとの変数を使う。
※ X.graphic_context(X.color_pixel("色名")) は graphic_context("色名
   ") でよい（もとのままも可）。
※ array 関数は返り値が void になり、引数で配列のポインタを渡す。

‘変数’

d=X.d;         ⇒  d=W0.disp();
black=X.bgc;   ⇒  black=W0.bgc;
white=X.wgc;   ⇒  white=W0.wgc;

XDrawPoint(d,X.win[0],gc,i,j); ⇒ XDrawPoint(d,W0,gc,i,j); 

※ ディスプレイIDは (ウィンドウ名).disp()。（直接、コマンドの中に
   W0.disp()と書いても遅くはならない。）
※ black,white のグラフィックコンテキストは Simple_Window か 
   Graphic_Window の bgc,wgc（または graphic_context関数)を使う。
※ ウィンドウIDを書く場所にはウィンドウ変数をそのまま書く。

+++++++++++++ 各頁の構成 +++++++++++++++++++++++++++++++++++++

仕様の各頁はだいたい次のような構成です。

各頁はそれぞれ１つのインクルードファイルの中身の説明になっています。
たとえば、window の頁の関数、クラスを使うためには始めに書かれている
ように XRS/window.h のインクルードが必要です。

‘グローバル変数、関数’

グローバルな変数や関数がそのインクルードファイルで定義されていたら、
その仕様を説明します。（ただし、マニピュレーターの説明は後）

‘クラスの宣言’

クラスの説明でははじめにそのクラスの変数の宣言の仕方が書かれています
。クラスの定義というのは新しい型を作ることなので、宣言された変数は d
ouble型変数などと同じようにそのクラスの型をもつ１つの変数として扱わ
れます。従って、スコープや寿命は普通の変数と全く同じです。

‘public変数、関数’

プログラム中で使える公開メンバーです。"(宣言したクラスの変数名).(変
数、関数名)"という書式でプログラム中で使うことができます。
  基底クラスの public(公開)変数 や public関数は（同名の関数が定義さ
れていない限り）派生クラスの public変数、public関数でもあるので派生
クラスからも同様に使えます。

‘マニピュレータ’

マニピュレータは << 演算子の中で使われ、そのクラスに特定の処理をする
特別なグローバル関数です。

‘protected変数、関数’

非公開メンバーでプログラム中では使えません。（XRS の仕掛けを知るため
に重要なので "protected" 関数の説明も載せましたが、実際のプログラミ
ングには関係ありません。）

•  † 
  各関数の説明の後ろには / に続けて使用例を書いてあります。
  
  

•  † 
  同名の関数との混乱を避けるために、文章中では別のクラスの関数は ”ク
  ラス名::関数名”、グローバル関数は ”::関数名”と表記します。（例え
  ば、window::event() と書いてあったら、class window の節に説明のある 
  event() 関数のことです。）
  
  

•  † 
  関数の引数で int w=0 などと書かれているものは、その引数は省略可能で
  、省略した場合 = の後の値が代入されることを示しています。
  （例えば、move(int i=0,int j=0) と書かれていたら、move(100); とする
  と move(100,0); が、move(); とすると move(0,0) が実行されます。）
  
  

•  † 
  デフォルト値とその変更については、”デフォルト値とカスタマイズ” の
  節を御覧下さい。
  
  

•  † 
  戻り値の型の前に virtual がついている関数は仮想関数です。仮想関数は
  派生先のクラスで同名同型で関数を定義しなおすことができます。
    例えば、virtual int window::redraw() は class window から派生して
  いる class graphic_window の int graphic_window::redraw() で上書きさ
  れています。従って、
     / graphic_window A(100,100);   と graphic_window を宣言し、
     / window *W=&A;                class window のポインタに代入し、
     / W->redraw();                 window::redraw() 関数を使った時、
  実行されるのは graphic_window::redraw() です。
  

 window                              class window
  │ 
  ├ simple window                   class simple_window
  │ │└Simple Window               class Simple_Window
  │ │      
  │ ├graphic window                class graphic_window
  │ │└Graphic Window             class Graphic_Window
  │ │
  │ └plane window::                class plane_window
  │   └Plane Window::              class Plane_Window
  │ 
  └ control window                  class control_window
     ├ Control Window               class Control_Window
     └ Complex Control Window       class Complex_Control_Window

  dialog                           class dialog
  │
  ├ function dialog                      class f_dialog
  ├ double dialog                        class d_dialog
  ├ int dialog                           class i_dialog
  └ complex dialog                       class c_dialog

 ダイアログは表示される（ redraw() )と
   ┌─────┐      
   │１タイトル│のように描かれます。（幅 width,高さheight)
   └─────┘

表示は   type=0             type=1
      ┌─────┐      
      │１タイトル│   ┌─────┬─────┐        
      ├─────┤   │１タイトル│２変数の値│ 
      │２変数の値│   └─────┴─────┘     
      └─────┘

          １欄 で n==1 → x+=step;
                  n==2 → x+=0.1*step;
                  n==3 → step*=10;
          ２欄 で n==1 → x-=step;
                  n==2 → x-=0.1*step;
                  n==3 → step*=0.1;

表示は   type=0             type=1
      ┌─────┐      
      │１タイトル│   ┌─────┬─────┐        
      ├─────┤   │１タイトル│２変数の値│ 
      │２変数の値│   └─────┴─────┘     
      └─────┘

          １欄で   n==1 → x+=10*step;
                   n==2 → x+=step;
                   n==3 → step*=10;
          ２欄で   n==1 → x-=10*step;
                   n==2 → x-=step;
                   n==3 → if(step>=10) step/=10;

表示は   type=0             type=1
      ┌─────┐     ┌──┬──┐    
      │１　　２　│     │１　│３　│
      ├──┬──┤     │　　├──┤
      │３　│４　│     │２　│４　│
      └──┴──┘     └──┴──┘

        <実部／虚部表示の場合> (polar_cordinate==0）
          １欄  n==1 → f.re+=step.re;    
                n==2 → f.re+=step.re*0.1;
                n==3 → step.re*=10.0;    
          ２欄  n==1 → f.im+=step.im;    
                n==2 → f.im+=step.im*0.1;
                n==3 → step.im*=10.0;     
          ３欄  n==1 → f.re-=step.re;    
                n==2 → f.re-=step.re*0.1;
                n==3 → step.re*=0.1;    
          ４欄  n==1 → f.im-=step.im;    
                n==2 → f.im-=step.im*0.1;
                n==3 → step.im*=0.1;     

         <極座標表示の場合> (polar_cordinate!=0）
          １欄  n==1 → f=polar(abs(f)+step.re    ,arg(f));
                n==2 → f=polar(abs(f)+0.1*step.re,arg(f));
                n==3 → step.re*=10.0;
          ２欄  n==1 → f=polar(abs(f),arg(f)+M_PI*step.im    );
                n==2 → f=polar(abs(f),arg(f)+0.1*M_PI*step.im);
                n==3 → step.im*=10.0; 
          ３欄  n==1 → f=polar(abs(f)-step.re    ,arg(f));
                n==2 → f=polar(abs(f)-0.1*step.re,arg(f));
                n==3 → step.re*=0.1;  
          ４欄  n==1 → f=polar(abs(f),arg(f)-M_PI*step.im    ); 
                n==2 → f=polar(abs(f),arg(f)-0.1*M_PI*step.im);
                n==3 → step.im*=0.1;   

†#include <XRS/color.h> が必要

†<XRS/color.h>の中で <XRS/window.h> がincludeされる。

‘カラーピクセル取得のための関数’

• unsigned long color_pixel(W,h,s,v);
    window &W;     ウィンドウ
    double h;      色相(Hue)           h<0 || h>1 ⇒ h-=floor(h)
    double s=1;    飽和度(Saturation)  s<0 ⇒ s=0,  s>1 ⇒ s=1
    double v=1;    明度(Value)         v<0 ⇒ v=0,  v>1 ⇒ v=1
      ディスプレイID W.disp() とカラーマップ W.cm からHSV値(h,s,v)
      の色のカラーピクセルを用意して返す。
  
  

• unsigned long color_pixel(h,s,v);
    上の関数の省略形。color_pixel(XRS_ROOT,h,s,v) と同じ。
                     / unsigned long c=color_pixel(0.5);
  
  
  

• unsigned long color_pixel(W,name);
    window  &W;          ウィンドウ
    const char *name;    色名
      ディスプレイID W.disp() とカラーマップ W.cm から name 色
      のカラーピクセルを用意して返す。
  
  

• unsigned long color_pixel(name);
    上の関数の省略形。color_pixel(XRS_ROOT,name) と同じ。
                     / unsigned long c=color_pixel("green");
  
  
  

• int color_pixel(W,color,filename);
    window        &W;         ウィンドウ
    unsigned long *&color;    カラーピクセルが入る配列へのポインタ
    const char    *filename=NULL; カラーリソースファイルの名前
      ファイル filename の色名に従ってカラーピクセルの配列をとる。
      返り値は確保された色の数（配列の要素数）。
      filename=NULL ⇒ デフォルトのファイル
  
  

• int  color_pixel(c,filename);
    上の関数の省略形。color_pixel(XRS_ROOT,c,filename) と同じ。
           / unsigned long *c; color_pixel(c,"color_file");
  
           
  

• unsigned long* colordisk(W,nr,np);
    window        &W;    ウィンドウ
    int           nr;    半径方向（飽和度）の色数
    int           np;    角度方向（色相）の色数
      色相（角度方向）と飽和度（半径方向）が連続的に変わるディス
      ク状のカラーピクセル配列を作って返す。
  
  

•     
  unsigned long* colordisk(nr,np);
    上の関数の省略形。colordisk(XRS_ROOT,nr,np) と同じ。
                        / Graphic_Window W(100,100);
                        / W<<COLOR(colordisk(6,8),6*8);
      
  

• int  diskcolor(double,double,int,int);
    double     r;   飽和度（半径、0=<r<1、r=0 は白）
    double   phi;   色相（角度、２π周期）
    int       nr;   半径方向（飽和度）の色数
    inr       np;   角度方向（色相）の色数
      colordisk 関数で用意した配列で (r,phi) に対応する色の番号
      を返す。
      ※ phi/=2π; if( phi>=1 || phi<0 ) phi-=floor(phi);
         return (int)(nj*((int)(r*ni)+phi)); をしてるだけ。
                       / W.point(diskcolor(0.8,0.5,6,8),50,50);
  

‘グラフィックコンテキスト取得のための関数’

• GC  graphic_context(W,color,line_width,line_style,font);
    window        &W;                   ウィンドウ
    unsigned long color;                色（カラーピクセル）
    unsigned int  line_width=0;         線幅
    int           line_style=LineSolid; 線のスタイル
    const char*   font=NULL;            フォント
      色 color, 線幅 lw, ラインスタイル ls, フォント font の
      グラフィックコンテキストを作って返す。background色は
      W.white になります。
      font=NULL ⇒ デフォルト値
  
  

• GC graphic_context(color,line_width,line_style,font);
    上の関数の省略形。graphic_context(XRS_ROOT,color,line_width,
    line_style,font); と同じ。
           / GC gc=color_pixel(color_pixel(0.5),0,LineOnOffDash);
  
  
  

• GC  graphic_context(W,name,line_width,line_style,font);
    window        &W;                   ウィンドウ
    char          *name;                色名
    unsigned int  line_width=0;         線幅
    int           line_style=LineSolid; 線のスタイル
    const char*   font=NULL;            フォント
      色 color, 線幅 lw, ラインスタイル ls, フォント font の
      グラフィックコンテキストを作って返す。background色は
      W.white になります。
      font=NULL ⇒ デフォルト値
  
  

• GC graphic_context(name,line_width,line_style,font);
    上の関数の省略形。graphic_context(XRS_ROOT,name,line_width,
     line_style,font); と同じ。
           / GC gc=graphic_context("red");
  
  
  

• int  graphic_context(W,gc,filename);
    window   &W;    ウィンドウ
    GC      *&gc;   グラフィックコンテキストが入る配列へのポインタ
    const char *filename=NULL; カラーリソースファイルの名前
      ファイル filename の色名に従ってグラフィックコンテキストの
      配列をとる。返り値は確保された色の数（配列の要素数）。
      line_width=0,line_style=LineSolid,font=デフォルト値,
      background=W.white になる。
      filename=NULL ⇒ デフォルトのファイル
  
  

• int  graphic_context(gc,filename); 上の関数の省略形。
      graphic_context(XRS_ROOT,gc,filename) と同じ。
           / GC *gc; graphic_context(gc,"color_file");  
  

†#include <XRS/XResource.h> が必要

‘定義されている関数’

• void mergeDatabases(d,DB,filename);
    Display      *d;  ディスプレイID
    XrmDatabase &DB;  確保されるデータベース
    char  *filename;  リソースファイル名
      上述の手順にしたがってデータベース DB を作る。
  
  

• int extractOpt(DB,name,class,opt);
    XrmDatabase &DB; データベース
    const char     *name; インスタンス名
    const char     *class; クラス名
    char       *opt; データを書き込む文字列へのポインタ
      DB からインスタンス名 name、クラス名 class と一致する最も
      優先順位の高いデータを取り出して opt に代入する。
      もし一致するものがあれば １を返し、なければ０を返す。
  
      / —– ファイル "testrc" の中身 ——
      /   miya:  Takashi Ichinomiya
      / ————————————-  
  
      / #include <stdio.h>
      / #include <XRS/XResource.h>
      / using namespace XRS;
      / int main(){
      /  Display *d=XOpenDisplay(NULL);
      /  XrmDatabase DB;
      /  mergeDatabases(d,DB,"testrc");
      /  char opt[126];
      /  if(extractOpt(DB,"miya","Miya",opt)) printf("%s\n",opt);
      /  XCloseDisplay(d);
      /  exit(0);
      / }
  

†#include <XRS/List.h> が必要

‘テンプレートクラス List’

• List<T> a; T型変数を要素とするリストaの宣言 / List<double> a;
  
  

• T& operator[](int n);  n番目の要素。      / double a[3];   
  

• int  number();         要素数を返す。     / int n=a.number();
  
  

• void splice(int n,T x); リストのn番目にxを追加 /a.splice(3,4.0);
  

• T splice(int n); n番目の要素を取り除いて返す
                                          /double x=a.splice(1);
  

• 以下の関数は上のsplice関数の簡易版です。
  

• T pop();         最後の要素を取り去って返す。/double x=a.pop();
  

• void push(T x);    末尾に x を加える。       /a.push(2.4);
  

• void unshift(T x); 先頭に x を加える。       /a.unshift(3.5); 
  

• T shift();       先頭の要素を取り去って返す。/double x=a.shift();
  

‘反復子クラス ListIter’

•  
  ListIter i(a,n); または ListIter i=a;
    const List<T> &a;   T型リスト
    int          n=0;   要素の番号
      リスト a を与えて反復子を作る。
      現在の要素(i.curr())がa[n]になる。
  
  

•  
  int  empty();  現在の要素が空であれば１、空でなければ０を返す。
  

• void next();   次の要素に移動。
  

• void prev();   前の要素に移動。
  

• T& curr();     現在の要素。
  

   / for(ListIter i=a; !i.empty(); i.next())   forループ
   /     printf("%f\n",i.curr());              現在の要素

†#include <XRS/Array.h> が必要

‘定義されている関数’

• template <class T> void array(T **&M,int imax,int jmax);
     imax x jmax の T 型２次元動的配列を M に確保する。
     ※ if(i && j){ M=new T* [i]; add_dimension(M,i,j);} と同じ。
     / double **x;
     / array(x,100,50);     double型の２次元配列をとる。
  
  

• template <class T> void delete_array(T **&M);
     T 型２次元動的配列 M のメモリーを解放する。
     ※ delete_dimension(M);  delete [] M; M=NULL; と同じ。
     /  delete_array(x);    
  
  

•  
  template <class T> void add_dimension(T **M,int imax,int jmax);
     全要素数 imax、先頭のアドレス M の配列に要素数 jmax の新しい
     次元を加えて行列を作る。
     / 10x20x30x40 の double型 の４次元配列を取る例。
     / double ****x;                          
     / array(x,10,20);                     
     / add_dimension(x[0],10*20,30);        
     / add_dimension(x[0][0],10*20*30,40);
  
    
  

• template <class T> delete_dimension(T **M);
     M[0] のメモリーの解放 
     ※ delete [] M[0]; M[0]=NULL; をしているだけ。
     / ４次元配列のメモリーの解放。
     / delete_dimension(x[0][0])         
     / delete_dimension(x[0]);
     / delete_array(x);
  
  

†#include <XRS/Exec.h> が必要

‘class Exec の宣言’

Exec A(path,command,filename1,filename2);
  const char *path;            コマンドのパス名
  const char *command;         コマンド（スペースを含んでもいい）
  const char * filename1=NULL; stdout 出力を書き込むファイル名
  const char * filename2=NULL; stderr 出力を書き込むファイル名
  パス path にあるコマンド command を実行し、その標準入力との間
  にパイプを作る。ファイル名が与えられたら、stdout や stderr を
  そのファイルにリダイレクトする。
   / Exec A("bin/cat","cat","kuzu");
  

‘class Exec の public 関数’

• operator FILE*();           / fprintf(A,"test\n");
       作ったパイプに出力するファイル構造体への型変換。
                    
  
  

• template<class T> Exec& operator<<(const T& s);
  Exec& operator<<(std::ostream& (*pf)(std::ostream &));
       変数またはマニピュレーターをパイプに出力しバッファリングする。
       / A<<"test"<<endl;
       ※ver.3.3.0から改行を自動的につけるのをやめました。
  

†#include <XRS/Socket.h> が必要

‘class Socket の宣言’

Socket A(name);
  const char *name; ソケットの名前（同名のファイルができる。）
  name という名前のソッケト（AF_UNIX,SOCK_STREAM)を作り、bind,listen
  システムコールをする。ただし、同名のファイルでソケットでもパイプで
  もないものが既に存在していればソケットを開かずにエラー終了する。

‘class Socket の public 関数’

•  
  const char *title();   name を返す。  / char *s=A.title();
  

•  
  operator int();  ディスクリプタへの型変換。 
  
  

• int open();  accept システムコールを実行し、クライアントからの
               接続要求を待つ。接続後ディスクリプタを返す。
                                / FILE *fp=fdopen(A.open(),"w");
  
  

•      
  void close();   accept で作られたディスクリプタを閉じる。
                                  / A.close();
  

‘class ClientSocket の宣言’

ClientSocket B(name);
  const char *name; ソケットの名前
  name という名前のソケットと接続し、ディスクリプタを得る。

‘class ClientSocket の public 関数’

•  
  operator int();  ディスクリプタへの型変換。 
                                  / FILE *fp=fdopen(B,"r");
  

†#include <XRS/DataSocket.h> が必要

†内部で <XRS/Socket.h> をインクルードしている。

‘class DataSocket の宣言’

DataSocket A(name);
  const char *name; ソケットの名前
  name という名前のソッケトを作る。

‘class DataSocket の public 関数’

• FILE *open();  クライアント "datasocket" からの接続要求を待つ。
            接続後、そのソケットへの write only のファイル構造体
            を返す。     / A.open();
  
  

•  
  operator FILE*(); ファイルディスクリプタへの型変換。 
                              / fprintf(A,"test\n");
  
  

• template<class T> DataSocket& operator<<(const T& s);
  DataSocket& operator<<(std::ostream& (*pf)(std::ostream &));
       変数またはマニピュレーターをパイプに出力しバッファリングする。
       / A<<"test"<<endl;
       ※ver.3.3.0から改行を自動的につけるのをやめました。
  
  

• void close(); データ終了のコントロールコード ’\x44’ を送った後、
                バッファリングしてからディスクリプタを閉じる。
                              / A.close();
  

‘コマンド datasocket’

UNIX のコマンドラインで datasocket <socketname> とすると、そのソ
ケットからデータを受けとり、標準出力に出します。コントロールコー
ド ’\x44’ を受信すると、’\n’ を出して終了します。
※ 先に、サーバ ( class DataSocket を持つプログラム）を走らせてから
   実行しないと、接続するソケットを見つけられずにエラーになります。

•  ※ 
  ただし、リソースファイルのデフォルト名 XRS_RESOURCE_FILE だけは変更
  できません。（インストール時にdefine.h を変更していない限り XRS_RES
  OURCE_FILE = ".xrsrc" です。）
  
  

•  ※ 
  Xリソースの書き方は XWindow のマニュアルに載っています。
  
  

•  ※ 
  リソースデータベースのでき方と読み込むファイルについては 
  See section XResource.h. を御覧下さい。
  

クラス名:                         意味(変数の型）

•  ♪  
  <XRS/color.h> (color_pixel,graphic_context関数）
  Xrs.Font:                        フォント名(s)
  Xrs.Color_Resource:              カラーリソースファイルの名前(s)
  
  

•  ♪  
  <XRS/window.h> 関係
  Xrs.Window.Boder_Width:          ウィンドウの境界線の幅（int）
  
  

•  ♪  
  <XRS/control.h> （コントロールウィンドウ）
  Xrs.Window.Control.Title:        タイトル(s)
  Xrs.Window.Control.Width:        幅（int)
  Xrs.Window.Control.Height:       高さ(int）
  
  

•  ♪  
  <XRS/graphic.h> （グラフィックウィンドウ）
  Xrs.Window.Graphic.Meshsize:     格子サイズ(int)
  Xrs.Window.Graphic.Maxcolor:     色番号が大き過ぎた時の色の名前(s)
  Xrs.Window.Graphic.Mincolor:     色番号が小さ過ぎた時の色の名前(s)
  Xrs.Window.Graphic.Color_Type:   色のタイプ
                         (monotone/phasetone/color_resourceのいずれか)
  Xrs.Window.Graphic.Color_Number: 色数
  Xrs.Window.Graphic.Color_H:      色相(double)
                                   †monotone/phasetone で使われる
  Xrs.Window.Graphic.Color_Resource: カラーリソースファイルの名前(s)
  
  

•  ♪  
  <XRS/plane.h> （プレーンウィンドウ）
  Xrs.Window.Plane.Meshsize:     格子サイズ(int)
  Xrs.Window.Plane.Maxcolor:     色番号が大き過ぎた時の色の名前(s)
  Xrs.Window.Plane.Mincolor:     色番号が小さ過ぎた時の色の名前(s)
  Xrs.Window.Plane.Color_Type:   色のタイプ
                         (monotone/phasetone/color_resourceのいずれか)
  Xrs.Window.Plane.Color_Number: 色数
  Xrs.Window.Plane.Color_H:      色相(double)
                                   †monotone/phasetone で使われる
  Xrs.Window.Plane.Color_Resource: カラーリソースファイルの名前(s)
  
  

•  ♪  
  <XRS/f_dialog.h> (関数用ダイアログ）
  Xrs.Dialog.Function.String:   タイトルの最大文字数(int)
  Xrs.Dialog.Function.Xoffset:  文字の書き始めの位置のx座標(int)
  Xrs.Dialog.Function.Yoffset:  文字の書き始めの位置のy座標(int)
  Xrs.Dialog.Function.Width:    欄の幅(int)
  Xrs.Dialog.Function.Height:   欄の高さ(int)
  Xrs.Dialog.Function.Font:     フォント(s)
   
  

•  ♪  
  <XRS/d_dialog.h> （double変数用ダイアログ）
  Xrs.Dialog.Double.String:     タイトルの最大文字数(int)
  Xrs.Dialog.Double.Xoffset:    文字の書き始めの位置のx座標(int)
  Xrs.Dialog.Double.Yoffset:    文字の書き始めの位置のy座標(int)
  Xrs.Dialog.Double.Width:      欄の幅(int)
  Xrs.Dialog.Double.Height:     欄の高さ(int)
  Xrs.Dialog.Double.Step:       パラメータチューニングの刻み幅(double)
  Xrs.Dialog.Double.Format:     double型変数用のprintf書式文字列(s)
  Xrs.Dialog.Double.Color:      インディケータの色(s)
  Xrs.Dialog.Double.Shape:      形(0 縦長／1 横長)
  Xrs.Dialog.Double.Font:       フォント(s)
  
  

•  ♪ 
  <XRS/i_dialog.h>（int変数用ダイアログ）
  Xrs.Dialog.Int.String:        タイトルの最大文字数(int)
  Xrs.Dialog.Int.Xoffset:       文字の書き始めの位置のx座標(int)
  Xrs.Dialog.Int.Yoffset:       文字の書き始めの位置のy座標(int)
  Xrs.Dialog.Int.Width:         欄の幅(int)
  Xrs.Dialog.Int.Height:        欄の高さ(int)
  Xrs.Dialog.Int.Step:          パラメータチューニングの刻み幅(int)
  Xrs.Dialog.Int.Format:        int型変数用のprintf書式文字列(s)
  Xrs.Dialog.Int.Color:         インディケータの色(s)
  Xrs.Dialog.Int.Shape:         形(0 縦長／1 横長)
  Xrs.Dialog.Int.Font:          フォント(s)
  
  

•  ♪  
  <XRS/c_dialog.h> （complex変数用ダイアログ）
  Xrs.Dialog.Complex.String:    タイトルの最大文字数(int)
  Xrs.Dialog.Complex.Xoffset:   文字の書き始めの位置のx座標(int)
  Xrs.Dialog.Complex.Yoffset:   文字の書き始めの位置のy座標(int)
  Xrs.Dialog.Complex.Width:     欄の幅(int)
  Xrs.Dialog.Complex.Height:    欄の高さ(int)
  Xrs.Dialog.Complex.Real.Step: 実部／半径の刻み幅(double)
  Xrs.Dialog.Complex.Imaginary.Step: 虚部／角度の刻み幅(double)
  Xrs.Dialog.Complex.Format:    double型変数用のprintf書式文字列(s)
  Xrs.Dialog.Complex.Color:     インディケータの色(s)
  Xrs.Dialog.Complex.Shape:     形(0 or 1)
  Xrs.Dialog.Complex.Font:      フォント(s)
  

‘ver.3 ⇒ ver3.1 (1996 4/13)’

• class plane_window,Plane_Window の追加。
  

•  
  class graphic_window に draw_line,draw_circle を追加。
  

• マニピュレータ COLOR,MONO,PHASE の構造を変えてヘッダに分離。
  

•  
  マニュアルの書き直しとバグとり。
  

‘ver.3.1 ⇒ ver3.2 (1996 4/22)’

• Socket.h, Socket.C Exec.h Exec.C, DataSocket.h, datasocket.C を
  追加。gnuplot などへ接続してグラフィックができるようにした。
  

‘ver.3.2 ⇒ ver3.2.1 (1996 5/16)’

• Socket.C を修正。ソケットを開く際に、同名でソッケトでもパイプで
  もないファイルがあったらエラー終了するように変更（上書きの防止の
  ため）。
  

• Socket.C XResource.h を微修正。Makefile.SUN を追加。
  SUN-OS でコンパイルできるようにした。
  

‘ver.3.2.1 ⇒ ver3.2.2 (1996 8/2)’

• dialog の resize 関数のバグ取り。virtual に変更し、d_dialog,
  i_dialog,c_dialog それぞれに resize 関数を追加。
  

• f_dialog,d_dialog,i_dialog,c_dialog に string,xoffset,yoffset,
  offset 関数を追加。（細かなカスタマイズ用。）
  

• Makefile 中の gcc のインクルードパスに -nostdinc++ オプションを
  付けて g++-include より . が優先されるように変更。
  

‘ver.3.2.2 ⇒ ver3.2.3 (1996 11/11)’

• つまらないバグ取り。Graphic.h の中の
  inline Graphic_Window& operator<<(Graphic_Window &s,
  COLOR_A_Uli m) 関数の定義で return s; が抜けていた。
  

• initialize() 関数を実行する前のウィンドウに不可視状態を指定
  （あるいは unmap() 関数の実行）が有効になるように改善。
  

‘ver.3.2.3 ⇒ ver3.2.4 (1996 11/15)’

• Imakefile を作る。（といっても、xmkmf で得た X のインクルー
  ドファイルの位置の変数を使った程度で Makefile とほとんど違
  いがない。）これで運がよければどの OS でもコンパイルできる。
  

‘ver.3.2.4 ⇒ ver3.2.5 (1996 12/24)’

• Graphic_Window の描画関数に色番号を直接指定して書かせる関数
  point(int,,)、line(int,,,,)、circle(int,,,)、draw_2D(int**)
  を追加。
  

• color.h に色相と飽和度が連続的に変わる disk 状の色配列を取
  るたの関数 colordisk とその逆関数 diskcolor を追加。
  上の変更と合わせると、位相と振幅を同時に表示したいシミュレ
  ーションも比較的簡単にできるようになった。
   ( "使い方" の "Graphic_Window 応用編" を見て下さい。 ) 
  

• バグ取り：XRS/plane.h の頭が #ifndef XRS_graphic_H だった。
  

• マニュアルのバグ取りと整理
  

‘ver.3.2.5 ⇒ ver3.2.6 (1997 3/25)’

Linux-OS できちんと動作確認したところバグが発覚。慌ててバグ
取り。（かなり重要＆なさけないバグだったので、自分で先に見つ
けて助かった。）
また、gcc version 2.6.? でも問題なく動くようになりました。

• d_dialog,i_dialog,c_dialog で使っていた Field_Width に
  sprintf フォーマットの最小フィールド幅を使っていたため、
  書式によっては segmentation fault が起きることがあった。
  最小フィールド幅を使用しないように改めた。
    ダイアログに表示される文字数は前回の表示文字数と今回の文
  字数の大きい方に合わせ、不足分はスペースで補われる。
    この改善によって、string_format.C の
  関数 field_width() がなくなり、関数 void parameter_string
  が文字数 int を返すように変更された。また、各 dialog class
  の変数 Field_Width がなくなり、作業用の変数 fw,real_fw,
  imag_fw が作られた。
  

• class control_window のデストラクタ内でのダイアログリストの
  後始末が重複して行なわれていたので改善する。
  (exit 処理のし方によっては segmentation fault となることが
  あった。）
  

• class Complex_Control_Window の geometry 関数のリサイズ機能
  が引数の書き間違いでうまくいっていなかったので直す。
  

• class DataSocket の close 関数に void の付け忘れがあった。
  (-Wall で warning が出ていた。）
  

• Imakefile の INCS 変数に XRS/XRS.color が抜けていた。
  

• サンプルプログラムの -Wall コンパイル時の warning をなくす。
  サンプルプログラムのための Imakefile の作成。
  

• サンプルプログラム XRSver3sample2D.C、XRSver3sampleGnuplot.C
  中で配列の初期化が完全でなかったので改める。
  

• gcc 2.6.? で問題なくコンパイル出来るように template 宣言をした
  ファイル(template.C)を追加。
  また、XRS/*.h 中の inline を無くし、-DNOINLINE オプションを
  つけると *.C 中の inline を使わないように変更した。
  

• class Exec の中で実行する execv を execvp に変更。shell でコマ
  ンドを実行するので full path を与えなくて良くなった。
  

‘ver.3.2.6 ⇒ ver3.2.7 (1997 5/17)’

•  
  バグ取り。class graphic_window で char * 型のメンバー関数
  の初期化(=NULL)が不十分だった。new なのでウィンドウを動的配列と
  して取った時、segmentation fault が出る場合があった。
  

• 位相と振幅を同時に表示したいシミュレーションのための色の取
  り方についてのマニュアルの記述をもう少し追加。
   ( "使い方" の "Graphic_Window 応用編" を見て下さい。 ) 
  

• マニュアルにLinux でのコンパイルの仕方の記述を追加。
  

‘ver.3.2.7 ⇒ ver3.2.8 (1997 6/28)’

FreeBSD、X11R6.3 で試したところいくつか修正しなければいけない所
が発覚。

•  
  <X11R6.3 への移植で見つかったバグ>
  class window の変数 XrmDatabase rDB; が最初のウィンドウ XRS_ROOT 
  を作る時に初期化されていなかった。window.C の window のコンスト
  ラクタ window:window(char *,char *) に :rDB(NULL) を追加。
  

• <FreeBSDへの移植>
  struct sockaddr_un の定義に u_char が使われているため、Socket.C 
  の中にあった #include <sys/types.h> の行を Socket.h に移す。
  また、Socket.C の中で bind,connect 関数に渡す構造体 sockaddr の
  長さ int len に +1 が必要。
  

• Imakefile 中の all: を all:: に変更。
  また、ライブラリのバージョンを調べられるように中身のない名前だけ
  のファイル __version_XX__.o を作って libXrs.a の先頭に追加するよ
  うにした。
  

‘ver.3.2.8 ⇒ ver3.2.9 (1997 7/1)’

FreeBSD+XFree68-3.3+X11R6.3 の載ったマシンで Xlib の関数 
XDrawPoint がうまく動かないことがわかった（X のバグかどうかは？
？？）。 とりあえず、-DWITHOUT_XDRAWPOINT をつけてコンパイルする
と XDrawPoint の代わりに XFillRectangle を使うように改造した。

‘ver.3.2.9 ⇒ ver3.2.10 (1998 3/29)’

StataboWare-1.0 の載ったマシンでもコンパイル出来るようにした。
Imakefile を編集して -DStataboWare オプションをつけてコンパイ
ルしてください。

• Socket.h と Socket.C で使うインクルードファイルが微妙に違うので、
  -DStataboWare オプションを追加して場合分けしました。
  

• c_dialog.C と sample/XRSver3Complex.C の中で使われた、
  g++ の複素数ライブラリの polar 関数の多重定義がうまく動かず、
  明示的に型指定 polar(double,double) をしなければならなかった。
  

‘ver.3.2.10 ⇒ ver3.2.11 (1998 5/29)’

バグ発見したので修正。f_dialog を << を使わずに直接型宣言して
control_window に登録した時、終了時に記憶領域を解放しようとし
て Segmentation Fault を起こすことがあることがわかった。
これも結構おろかなバグで、プログラミングの素人であることを実感
してしまった。

•   << で作った dialog の記憶領域の解放は作った場所（Control.h)
  の中で行なうようにした。具体的には control.C のデストラクタの記述
  を消し、Control.h の中で Control_Window のデストラクタを作った。
  

‘ver.3.2.11 ⇒ ver3.2.12 (1998 7/15)’

gcc-2.8.1 に対応。

•   
  List.h の最初に必要なテンプレートの宣言を2行忘れていたことが判明。
  それを直したら無事に通った。ついでに、Makefile.sample を書きかえ、
  DEC-OS でもちゃんと動くことを確認した。
  

• Linux で datasocket.o のリンク時に _IO_putc が未定義だと言われて
  失敗する。これは、C の標準ヘッダの stdio.h でなく g++ の stdio.h
  をインクルードしている為らしい。とりあえず、Imakefile を変更して、
  datasocket.o を作る時には g++ をインクルードパスからはずすように
  しておいた。（もっといい方法があるかもしれない。）
  

‘ver.3.2.12 ⇒ ver3.2.13 (1999 4/28)’

libg++ の新しいバージョンに対応。
#include <Complex.h> を #include <complex> に変更。
typedef complex<double> Complex; を追加した。

‘ver.3.2.13 ⇒ ver3.2.14 (2000 4/9)’

gcc-2.95.2 に対応。
コンパイル時にエラーが出たので修正。

•  今はコンパイラがやってくれるのでほとんど必要なくなった register を無くし、すべて int で統一。
  

•  いくつかの関数の extern "C" をコメントアウト。
  

•  Socket.C の accept関数の3番目の引数を (socklen_t *)&fromlen とした。
  

‘ver.3.2.14 ⇒ ver3.2.15 (2001 1/26)’

•  Compaq C++コンパイラ(cxx)に対応。
  

•  デフォルトの色のファイル XRS.colorの検索パスの設定が変だったので修正。
  

•  socklen_t という型がなくエラーがでる場合のために、Imakefile に         
        -DUNDEF_socklen_t というコンパイルオプションを追加。
  

‘ver.3.2.15 ⇒ ver3.2.16 (2002 3/17)’

•  島氏から報告された xcoloredit_color.C の中の変数 rgb.r, rgb.g, rgb.b の代入文の型変換のバグを修正(short -> unsigned short)。
  

•  変数表示のバグを修正: d_dialog.C, f_dialog.C, i_dialog.C で使って
  いた f_old を static 変数からメンバー関数に変更した。 
  

•  xcoloredit が最近使えないので、マニュアルにgimpを使った色ファイルの作り方を追加。
  

‘ver.3.2.16 ⇒ ver3.2.17 (2004 8/12)’

•  gcc ver.3 にするとコンパイルエラーが出るとの茶碗谷さんの報告を
  受け、namespace std の宣言などを修正。ver.3 は標準C++の仕様に忠実です。
  

•  Intel C++ コンパイラも通り、サンプルプログラムは無事動くことを
  確認（細かなwarning は山ほどでる）。
  

•  もう不要と思われる Stataboware 用のコンパイルオプションと、
  NOINLINE のオプションを削除。
  

•  Imakefile, Makefile などを一部修正。インクルードファイルのデフ
  ォルトのインストール先を /usr/include に変更。 
  

‘ver.3.2.17 ⇒ ver3.2.18 (2009 12/6)’

•  Ubuntu 9.10(g++ 4.4.4-1)でコンパイルできるように微修正。
  

•  char* と const char* の型変換のせいで　warning が大量に出ていたので修正。
  特に　Color, Socket 関係の関数で引数を const char * に変更したものがあります。
  エラーが出る場合は型変換してください。
  

‘ver.3.2.18 ⇒ ver3.3.0 (2018 11/30)’

•  ソース全体を namespace XRS の中に入れる。このため、このバージョン
  以降は XRSを使用する際に using namespace XRS; と最初に宣言するか、関数
  の前にXRS::をつける必要があります。以前に作ったプログラムをコンパイルする
  際は修正をお願いします。
  

•  Exec.h, DataSocket.h で << を型に制限なく使えるように変更。
  <<で文字列を出力した後の自動改行をやめました。このため、以前のバージョンで
  動いたプログラムをコンパイルする際は、最後に <<endl を追加する必要があります。
  

•  ヘッダファイルの名前の変更: simple.h, graphic.h, plane,h, control.h
  –> simple_.h, graphic_.h, plane_,h, control_.h とする。
  

•  デフォルトで XRS.color を読まない場合があるバグを修正。
  

•  Ubuntu 18.04 (gcc 7.3.0) でwarning なくコンパイルできるように微修正。
  

•  サンプルファイルを微修正。