亀場サーバー操作マニュアル

１. 亀場サーバーを使ったプログラミング

亀場サーバーは、タートルグラフィックスなどを行うための独立したアプリケーションで、あなたがこれから作成する（あるいはしている） Cのプログラムは、サーバーと通信しながら、亀場に指令を発することで、「亀」を操る。 そのための手順（関数）をまとめたファイルがturtle.hになる。 このturtle.hの内容を少しでも変更すると、コンパイルできなくなったり、予期せぬ動作を引き起こす可能性があるので、 中身は覗くだけにして、決して編集、保存しないこと。

このturtle.hは、作成中のCのソースファイル（何々.c）と同じディレクトリ（フォルダー）に置いておく。 そしてCのプログラムのはじまりの箇所に、必ず

#include "turtle.h"

の行が必要。

２. 亀を操るための機能（Ｃ言語用）

基本的に、亀場関係の関数名は全て大文字で記述するようになっている。 例えば FD(100.0);のつもりでfd(100.0);と記述しても、コンパイルエラーになるので注意。
亀や亀場から情報を得るための関数名はQ_で始まる。

描画関数一覧

CON("localhost");

CLR();

RST();

HOME();

FD(100.0);

BK(i*3);

JUMP(x+10,y-10);

RJUMP(dx,dy);

RT(90.0);

LT(rad*180/M_PI);

SOUTH();

LW(2.0);

PD();

PU();

SAY("I'm smart.");

TPRINTF("x=%f y=%f",x,y);

COL(0.7,1.0,0.0);

BGC(1.0,1.0,0.0);

FILL();

BRUSH();

POINT();

LINE();

CARD(16,100,-20);

CLRCARD();

float x,y ;
...
Q_POS(&x,&y);

float a ;
...
Q_DIR(&a);

「対戦」のための機能

BMODE();

GMODE();

FIRE();

NM("KAME");

TM(3);

int n;
...
Q_NT(&n);
printf("%d alive turtles\n",n) ;

float angle ;
...
Q_RADAR(&angle);
printf("angle= %f\n",angle) ;

int yn ;
...
Q_FINDER(&yn);
if (yn==1) printf("found!¥n") ;

RF(100.0);
			

int team ;
...
Q_TM(&team);
			

BCAS("COME ALL") ;

int tm ;
char msg[129] ;
...
Q_BCAS(&tim,msg) ;

int now ;
...
Q_TIME(&now);
			

int left,front,right ;
...
Q_SONAR(&left, &front, &right);

int score ;
...
Q_SCORE(&score);
			

int myid ;
...
Q_ID(&myid);
   		

IDLE(1.0);

ROBOT();

DONUT();

COIN();

BORROWCOIN();

DROPCOIN();

PICKCOIN();

int ncoin ;
...
Q_COIN(&ncoin);

int nmycoin ;
...
Q_MYCOIN(&nmycoin);

３. さらに進んだ使い方のヒント

ここでは、腕に覚えのある諸君に向けて、少しマニアックな説明をしたい。

亀場サーバーとの通信

亀場のプログラム(tfield-*)はTCP/IPのサーバーとして動作していて、外部からのコネクションを待ち受けている状態になっている。 一方で、ファイル"turtle.h"の中には、このサーバーと通信するためのプログラム（関数）が記述してある。 あなたが書いたCのプログラムは、TCP/IPのクライアントとして動作することになる。 そして、両者がプロトコルを交換しながら、描画が進むという仕掛けだ。

亀場サーバーは他のパソコンからの接続を受け付けることができるように設定できる。 亀場ウィンドウのタイトルのところは、 "Private Turtle Field @ 何々"のように表示されているはずだ。この「何々」にはそのサーバーのアドレス（正確には、アドレスに対応する xxx.ac.jp のような「ホスト名」）が表示される。

そこで、クライアント側（描画を行うソフト）の最初のところの、いつもは"localhost"にしている箇所を

CON("そのホスト名") ;

と変更するだけで、そのアドレスの亀場に対して描画や操作を行うことができる。 ただし、迷惑行為の防止のため、事前に接続先の亀場サーバーを「パブリックモード（誰でも接続可能なモード）」 に変更しておく（してもらう）必要がある。変更は、亀場サーバーのメニューかキーボードで行う（以下の「亀場サーバーの機能」を参照）。

通信ポート

ユーザープログラムが亀を操るためにTCP 2222番ポート、亀場の様子をモニターするためにTCP 2280番ポートが使われる。 セキュリティー対策ソフトやパソコンのファイアウォールから警告が出る場合があるので、そのときは、これらの ポートの使用を「許可」する必要がある。

亀場サーバーの機能

亀場サーバーの動作は、メニューやキーボードから直接操ることができる。 亀場のウィンドウがアクティブ（全面に出ている）状態で、マウスの右クリック、またはキーボードから半角文字をタイプする。

基本的な数値