簡単グラフィックスライブラリ「SimpleX」

はじめに

まずは make

	% cat SimpleX-1.1.tar.gz | gzip -cd | tar xf -
	% cd SimpleX-1.1
	% xmkmf
	% make

とにかく使ってみる

	#include <stdio.h>
	#include <SimpleX.h>

	main () {
	  SimpleDrawCircle (300, 300, 200);
	  getchar ();
	}

さらに使ってみる

	#include <stdio.h>
	#include <SimpleX.h>

	void button (int x, int y, unsigned int n) {
	  printf ("button %d pressed at (%d, %d)\n", n, x, y);
	}

	void key (char c) {
	  printf ("key %c inputed\n", c);
	}

	main () {
	  SimpleDrawCircle (300, 300, 200);
	  SimpleSetButtonHandler (button);
	  SimpleSetKeyHandler (key);
	  getchar ();
	}

詳しい説明

int SimpleDrawLine (int x1, int y1, int x2, int y2)

(x1, y1) から (x2, y2) へ線分を引きます。
int SimpleDrawPoint (int x, int y);

(x, y) に点を打ちます。
int SimpleDrawString (int x , int y, char *s);

(x, y) が左上の端になるように、文字列 s を書きます。 s は '\0' で終わっていなければなりません。
int SimpleDrawRectangle (int x1, int y1, int x2, int y2);
int SimpleFillRectangle (int x1, int y1, int x2, int y2);

(x1, y1) を左上の端、(x2, y2) を右下の端とするような長方形を描きます。SimpleDrawRectangle は中を塗りつぶしませんが、 SimpleFillRectangle は中を塗りつぶします。
int SimpleDrawCircle (int x, int y, unsigned int r);
int SimpleFillCircle (int x, int y, unsigned int r);

(x y) を中心とする半径 r の円を描きます。SimpleDrawCircle は中を塗りつぶしませんが、SimpleFillCircle は中を塗りつぶします。
int SimpleDrawArc (int x, int y, unsigned int rx, unsigned int ry, int t1, int t2);
int SimpleFillArc (int x, int y, unsigned int rx, unsigned int ry, int t1, int t2);

(x, y) を中心、rx を横方向の半径、ry を縦方向の半径、t1 を開始角、 t2 を終了角とする楕円弧を描きます。t1, t2 の単位はラジアンではなく「度」です。角度は右方向を 0 として、反時計回りにはかります。 SimpleDrawArc は中を塗りつぶしませんが、SimpleFillArc は中を塗りつぶします。

int SimpleSetColorByPixel (unsigned short r, unsigned short g, unsigned short b);

図形の色を光の三原色（赤、緑、青）の強さによって指定します。ここ (ECC) の環境では sizeof (short) == 2 なので、r, g, b の最小値は 0、最大値は 65535 です。つまり、黒は (0, 0, 0)、白は (65535, 65535, 65535) となります。
int SimpleSetColorByName (char *s);

図形の色を名前によって指定します。名前の一覧は showrgb というコマンドで見られます。実際に色を見たかったら xco が便利です。デフォルトは白です。
int SimpleSetFont (char *s);

文字のフォントを名前によって指定します。フォント名の一覧は xlsfonts というコマンドで見られます。実際に文字を見たかったら xfontsel が便利です。デフォルトのフォントは、SimpleX.h の中で SimpleDefaultFont が "8x16" に #define されています。

int SimpleClear (void)

ウインドウをクリアします。それ以前に描いた絵は、再描画用の情報も含め、すべて消去されます。
int SimpleSetInterval (long i)

再描画とマウスクリック、キーボード入力のチェックを行う間隔を指定します。単位はマイクロ秒です（ミリ秒ではありません）。デフォルトの値は、SimpleX.h において SimpleDefaultInterval に 1000 が #define されています。
int SimpleSetButtonHandler (SimpleButtonHandler f)

ウインドウのなかでマウスのボタンがクリックされたときに呼び出される関数を登録します。f は「void f (int x, int y, unsigned int n);」のように宣言されていなければなりません。x と y にはマウスがクリックされた場所の x 座標と y 座標が、n にはクリックされたボタン番号が渡されます。ボタン番号は、左が 1 番、真ん中が 2 番、右が 3 番です（通常の場合）。NULL を登録すると、マウスのボタンがクリックされても関数は呼び出されなくなります。デフォルトでは NULL が登録されており、関数は呼び出されません。
int SimpleSetKeyHandler (SimpleKeyHandler g)

ウインドウ上でキーボードから文字の入力があったときに呼び出される関数を登録します。g は「void g (char c)」のように宣言されていなければなりません。c にはキー入力によって生成された文字が渡されます。NULL を登録すると、キーボードから文字の入力があっても関数は呼び出されなくなります。デフォルトでは NULL が登録されており、関数は呼び出されません。

注意事項

目次に戻る