Tonyu System 1 - wiki

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (11/11)

ネットランキング対応にする

このゲームのハイスコアをWeb上で登録できるようにします。

※ ネットランキングを行うには、PerlによるCGIが実行可能なWebサーバが必要です。
  この項では、Webサーバは各自が既に利用できていることを前提としています。

1. ランキング用CGIを設置する
2. ネットランキング対応のランタイムを作成する

←前 次→ チュートリアル Wikiトップ

←前 目次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (11-2 / 11)

ネットランキング対応にする

ネットランキング対応のランタイムを作成する

先ほどまでで作成したシューティングをネットランキング対応にしましょう。

シューティングゲームのページを開いた状態で、メニューの「ウィンドウ」→「ネットランキング」を選びます

URLに、前項でアップロードしたCGIのURLを設定します。

自機が死んだときにランキングのページを開くようにしましょう

メニューの「オブジェクト」→「新規」を選んで新しくオブジェクトを作成します。
オブジェクトの種類は「テキスト」です

テキストオブジェクトを選択します。 オブジェクトインスペクタで、文字を変更します

テキストをダブルクリックして、次のように入力します。

extends TextChar;
setVisible(0);
while(!$MyChar.isDied()) {
  update();
}
setVisible(1);
while(getkey(13)==0) {
  update();
}
$ranking.setParam("score",$score);
$ranking.openBrowser();

このプログラムについて解説します。

setVisible(0);

↑これはこのテキストを一旦非表示にするための命令です。

while(!$MyChar.isDead()) {
  update();
}

↑これは、$MyCharつまり自機が死んでいない間、update()を繰り返します。
isDead は、オブジェクトが死んでいる( die()メソッドがよばれている)かを検査するメソッドです。

setVisible(1);
while(getkey(13)==0) {
  update();
}

↑この部分では、 setVisible(1);によりテキスト("Press Return to Regist Hiscore")を表示します。
さらにEnterキーが押されるまでupdate()を繰り返しながら待機します。

$ranking.setParam("score",$score);
$ranking.openBrowser();

↑この部分で実際にWeb上にスコア登録をおこないます。

$ranking.setParam(name,value)は、登録の際のパラメータを設定します。ここでは、scoreという名前のパラメータに$scoreの値（つまり得点)を設定します。

$ranking.openBrowser(); は、ブラウザから登録画面を開きます。

試しに一回実行してみましょう。
自機が死んだ後、Press Return to Regist Hiscore が表示されます。
ここでEnterを押すとブラウザが開いて登録画面が表示されますが....

エラーが発生しました。実は、開発環境からはハイスコア登録できないようになっています。
ここでは、ブラウザが開くのとCGIが正常動作するのを確認するだけにします。
（この後ランタイムを作成するとハイスコア登録が可能になります）

この状態で、配布するを参考にランタイムを作成します。
このとき、ネットランキングランキング管理者パスワードの欄に、
前項で設定したネットランキング管理者パスワードを入力します。

作成したランタイムをWebサーバ上に上げて、ダウンロード可能な状態にしておきます

テストします。
Webサーバからアーカイブをダウンロード、解凍し、ゲームをやってみましょう。
自機が死んだらEnterを押して登録画面に入ります

←前 目次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (11-1 / 11)

ネットランキング対応にする

ランキング用CGIを設置する

1. Tonyu Systemのアーカイブに添付されている"Perl"ディレクトリを開きます。

hiscore.cgi をテキストエディタで開きます

• 1行目の #!/usr/bin/perlを、サーバのPerlの置いてある場所に設定します。
• 8行目の $password='pass';の値を変更します。任意の英数文字列です。
  これが「ネットランキング管理者パスワード」なります。パスワードを忘れないようにしてください。
• タイトルや、最初に表示されるHTMLの内容をお好みで変更します。

2. Perlディレクトリの内容をサーバにコピーします。(FTPを使用する場合、アスキーモードで転送してください)

3. パーミッションを設定します

hiscore.cgi  :  755(-rwxr-xr-x , 第三者による実行許可)
data/hiscore :  666(-rw-rw-rw- , 第三者による書き込み許可)

4. hiscore.cgiをブラウザで開いて、ランキングのページが表示されるのを確認します

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (10/11)

配布する

これでゲームは一通り完成です。このゲームを配布したいとします。
他の人にTonyuをダウンロードさせるのは大変なので、単体で動くプログラム（ランタイム）を作成しましょう。

「ファイル」＞「ランタイム作成」を選びます。

タイトル、作者等の情報を入れます。

• 「メインページ」
  $page_indexを選択します。

• 「ネットランキング管理者パスワード」
  ここでは空白にしておいてください。詳しくは次項のネットランキング対応にするで説明します。

• 「アイコン」
  配布する実行ファイルのアイコンを変更できます。
  右下「アイコン」の隣の「変更...」を押し、ファイルを選択してください。
  ただし次のような制限があります。

  • 読み込めるのはbmpまたはpngファイル
  • 画像の左上32*32の部分だけが使用される。
  • 左上端の色が透過色になる。

  なお、実行ファイル名はPlayer.exeとなりますが、この名前は変更してもかまいません。

• 「配布条件」
  このランタイムには、今までつくったプログラムのソースファイルがそのまま含まれます。
  このため、他のユーザが簡単にプログラムの中身を書き換えることができます。
  内容を書き換えたゲーム（または今あなたがつくったゲームそのもの）を、他の人が勝手に配っていいかを決めるのが配布条件です

  • 再配布、改造ともに無断で許可
    プログラムの中身を変えようと変えまいと、他の人が勝手に配ってよいという、いちばん緩い条件です
  • 内容を変更しない再配布を無断で許可、改造は不可
    プログラムの中身を変えなければ、勝手に配ってよいという条件です
  • 再配布、改造は要連絡
    他の人が配布したい場合、作者への連絡が必要、という条件です。
    この場合メールアドレス等、あなたの連絡先を書いてください。
  • 再配布、改造は不可
    勝手に配るな、といういちばんきつい条件です。
  • その他
    どれにもあてはまらない場合は、条件を自分で書くことができます。

最後に、ランタイムを作成するディレクトリを選び、OKを押します。

ランタイム作成が完了したら、「OK」を選んでフォルダを開いてみます

このフォルダのPlayer.exeを実行すれば、作ったゲームが実行できます。 このフォルダを圧縮ツール等でまとめたものを配布してください。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (9/11)

弾、爆発を削除する

ゲーム開始後、設計時においてあった弾と爆発パターンのオブジェクトが動くのが見えます。
これらのオブジェクトはゲーム中に作成されるものなので、実際には設計時においておく必要はありません。

これらのオブジェクトを削除してしまいましょう。 弾のオブジェクトをクリックし、Deleteキーを押します。

弾が消えました。同様に爆発パターンも削除します

オブジェクトを消してしまっても、そのクラスがなくなってしまうことがありません。
実行してみると、弾も出ますし、爆発も表示されます。

これらの消してしまったオブジェクトのクラスを編集したいときは、
エディタ左側の、クラスの一覧から、編集したいクラスを選ぶと、そのクラスのソースファイルが表示されます。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (8/11)

得点を表示する

文字オブジェクトを作る

やっつけた敵に応じて得点を表示するようにしましょう。

まず得点を表示するためのオブジェクトを作ります。オブジェクトを作るを参考にオブジェクトを作成します。
「オブジェクトの種類」を「テキスト」にします。

• 間違えて「テキスト」でなく、「スプライト」でオブジェクトを作ってしまったら....
  
  この場合、オブジェクトをダブルクリックし、プログラム先頭の extends SpriteChar; を extends TextChar; に変更し、
  一回実行し停止させるとテキストオブジェクトに変わります。
  

オブジェクトをダブルクリックして、次のように入力します。

extends TextChar;
$score=0;
while(1) {
  text="Score:"+$score;
  update();
}

文字を表示する

テキストオブジェクトは、文字をするためのオブジェクトです。
変数textに文字列を代入すると、その内容が画面に表示されます。
上のプログラムでは、文字列"Score:"の後ろに変数$scoreの内容を 付け加えたものをtextに代入しています。

グローバル変数を使う

$scoreという変数には頭に"$"がついています。$で始まる変数はグローバル変数といい、どのオブジェクトからも参照できる変数です。
逆に、$がついていない変数は、そのオブジェクトが固有にもっている変数です。これをオブジェクト変数と呼びます。
オブジェクト変数は、同じ名前でもオブジェクトが違っていれば全く別の変数となります。

$scoreをグローバル変数にしたのは、敵などの他のオブジェクトが得点計算を行う必要があり、
表示をこの得点表示用のオブジェクトが行う必要があるからです。

とりあえず実行させてみると、画面上にScore : 0という文字が出ています。

得点計算をする

敵が弾にあたってやられた時に得点が増えるようにしましょう。
敵をダブルクリックし、次のように変更します。

extends SpriteChar;
function onDie() {
  appear(new Bomb(x, y, $pat_Sample+4));
}
function atariHantei() {
  for (t in $chars) {
    if (t is Tama && crashTo(t)) {
      die();
      $score=$score+10;
    }
  }
  if (crashTo($MyChar)) $MyChar.die();
}
nexty=rnd(50)+100;
while (y<nexty) {
  y=y+2;
  atariHantei();
  update();
}
if (x<$MyChar.x) vx=2; else vx=-2;
while (y<$screenHeight) {
  y=y+3;
  x=x+vx;
  atariHantei();
  update();
}

実行すると、敵をやっつけるたびに得点がふえていきます。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (7/11)

敵の動きに変化をつける

新しい動きを追加する

今の敵は、上から下に直線で飛んでくるだけなので、ちょっと変わった動きをつけましょう

途中までは今までどおり下に飛んできて、その後自機のいる方向に曲がって飛んでくるようにします。
敵をダブルクリックして、次のようにかきかえましょう。

extends SpriteChar;
function onDie() {
  appear(new Bomb(x , y ,$pat_Sample+4));
}

nexty=rnd(50)+100;
while (y< nexty ) {
  y=y+2;
  for (t in $chars) {
    if ( t is Tama && crashTo(t) ) die();
  }
  if (crashTo($MyChar)) $MyChar.die();
  update();
}

if (x<$MyChar.x) vx=2; else vx=-2;
while (y<$screenHeight) {
  y=y+3;
  x=x+vx;
  update();
}

変更した部分を順番に見ていきましょう

 nexty=rnd(50)+100;

まず rnd(50)は、敵を出現させるでも登場した、乱数を返すメソッドです。
この場合、0から49の整数の乱数が返されます。
それに100が加算されるので結果として、nextyには100から149の乱数が代入されます。
次のwhileの条件が変わっています

 while (y< nexty ) {

yがnextyより小さい(nextyより上)にいるまでは、先ほどまでと同じ処理をするようになります。
つまり、上のほうにいるときはまっすぐ降りてきます。

そして、動きが変化するところでは、次のような処理を行います

 if (x<$MyChar.x) vx=2; else vx=-2;

vxは、後で説明するように、移動方向のx成分です。

x<$MyChar.xならば（つまり、敵の位置が自機より左なら）右に移動するために、
vx=2のように移動方向を正の値(右方向)にします。

その後ろについている elseは「そうでなかったら」という意味です。
すなわち x<$MyChar.xでないならば（つまり、敵の位置が自機より右なら）左に移動するために、
vx=-2のように移動方向を負の値(左方向)にします。

上のようにしてvxを設定し、次の処理で実際に移動を行います。

while (y<$screenHeight) {
  y=y+3;
  x=x+vx;
  update();
}

追加した部分でも当たり判定を行う

しかし、これで実行させるとわかりますが、敵が曲がった後、当たり判定（自機が破壊される、弾にあたるとやられる）がまったくなくなってしまいます。
曲がった後のwhileの中で当たり判定の処理を書き忘れているためです。
そこで、最初のwhileで書いてある当たり判定の処理をコピーして持ってきましょう。

extends SpriteChar;
function onDie() {
  appear(new Bomb(x , y ,$pat_Sample+4));
}
nexty=rnd(50)+100;
while (y<nexty) {
  y=y+2;
  for (t in $chars) {
    if ( t is Tama && crashTo(t) ) die();
  }
  if (crashTo($MyChar)) $MyChar.die();
  update();
}
if (x<$MyChar.x) vx=2; else vx=-2;
while (y<$screenHeight) {
  y=y+3;
  x=x+vx;
  for (t in $chars) {
    if ( t is Tama && crashTo(t) ) die();
  }
  if (crashTo($MyChar)) $MyChar.die();
  update();
}

メソッドを使うともっと整理できます。
当たり判定を行うatariHanteiメソッドを作成してみましょう。

extends SpriteChar;
function onDie() {
  appear(new Bomb(x, y, $pat_Sample+4));
}

function atariHantei() {
  for (t in $chars) {
    if ( t is Tama && crashTo(t) ) die();
  }
  if (crashTo($MyChar)) $MyChar.die();
}

nexty=rnd(50)+100;
while (y<nexty) {
  y=y+2;
  atariHantei();
  update();
}
if (x<$MyChar.x) vx=2; else vx=-2;
while (y<$screenHeight) {
  y=y+3;
  x=x+vx;
  atariHantei();
  update();
}

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (6/11)

敵を破壊する

敵と弾がぶつかったら、敵が死ぬ

自機がやられっぱなしではゲームになりませんので、敵も破壊されるようにしましょう。
敵が弾に当たったら敵が死ぬようにすればいいのですから、自機を破壊するを参考にこんなプログラムを思いつくかもしれません。
敵をクリックして、次のような行を追加します。

extends SpriteChar;
while (y<$screenHeight) {
  y=y+2;
  if (crashTo($tama)) die();
  if (crashTo($MyChar)) $MyChar.die();
  update();
}

しかし、これで実行しても、敵は死んでくれません。
この文は「$tamaが当たったら(敵が)死ぬ」ということを意味しています。
$tamaとは、設計時に作った弾(実行を止めても画面上にいるオブジェクト)で、
しかも$tamaは実行するとすぐ上に飛んで行って消えてしまいます。

一方、自分が撃つ弾は、実行時に新しく発生しているものなので、$tamaというように名前をつけることができません。
しかも弾が画面上にいくつあるのかも状況によって変わってきます。
そこで、実行時に作られたオブジェクトを参照するための仕組みが必要となります。
それが

for (xx in $chars) {}

という文です。さっきの行を消して次のように書いてみましょう。

extends SpriteChar;
while (y<$screenHeight) {
  y=y+2;
  for (t in $chars) {
    if ( t is Tama && crashTo(t) ) die();
  }
  if (crashTo($MyChar)) $MyChar.die();
  update();
}

まず、最初の行

  for (t in $chars) {

について解説します これは、今画面上にいる全部のオブジェクトを調べ上げて、変数tに順番代入しながら、内の文を実行します。
例えば、今画面に自機と敵が１つづつ、弾が２つあるとします。
すると、 for (t in $chars) {は まずtに自機オブジェクトを代入し、{ }内の文を実行します。
それが終わると今度はtに敵オブジェクトを代入し、同様に実行し、
さらに弾オブジェクトの１個目を代入し実行
さらに弾オブジェクトの２個目を代入し実行
という処理を行います。
(※ただし、どのオブジェクトが何番目に代入されるかは決まっていません)

次に{}内の処理について解説します。

    if ( t is Tama && crashTo(t) ) die();

ifの条件部が&&で区切られているので、"t is Tama"と、"crashTo(t)"が両方成り立ったときだけ、ifの条件部が成立します（自機を動かす参照)
t is Tama という式は、オブジェクトtのクラスがTamaであるかという判定を行います。
前述のとおり、 for (t in $chars) {は、画面上の「全部の」オブジェクトを順番に代入していくので、そこには弾以外の自機や敵も含まれます。
弾に当たった場合にだけ破壊されなければならないので、tが弾オブジェクトであるかの判定が必要となります。
つまり ( t is Tama && crashTo(t) )は、tが弾で、その弾にぶつかっていれば、という意味になります。
そして、この条件が成り立つと die();によって敵自身が死にます。

実行してみましょう。敵を弾に当てると敵が死ぬようになりました。

敵の爆発パターンを作る

敵にも爆発パターンつけてみましょう（自機を破壊する参照)

extends SpriteChar;
function onDie() {
  appear(new Bomb(x , y ,$pat_Sample+4));
}
while (y<$screenHeight) {
  y=y+2;
  for (t in $chars) {
    if ( t is Tama && crashTo(t) ) die();
  }
  if (crashTo($MyChar)) $MyChar.die();
  update();
}

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (5/11)

自機を破壊する

敵と自機がぶつかったら、自機が死ぬ

敵を作りましたが、このままでは弾があたっても、自機がぶつかっても何もおきません。
まず、敵が自機にあたると自機が破壊されるようにしましょう

敵オブジェクトをダブルクリックして、次の行を追加します

extends SpriteChar;
while (y<$screenHeight) {
  y=y+2;
  if (crashTo($MyChar)) $MyChar.die();
  update();
}

まずifの条件部から見ていきましょう

if (crashTo($MyChar)) ...

crashToは、この敵が自機($MyChar)に当たっているかという判定を行います。 当たっている場合はif文の後ろが実行されます。
なお、自機の名前は、自機をクリックし、オブジェクトインスペクタで確認できます。

ぶつかった場合の処理は次のようになります

... $MyChar.die();

これによって自機が死にます。

xx.die();は、xxで表されるオブジェクトを殺す命令で、殺されたオブジェクトはただちに処理が止まり、画面上からいなくなります。

それでは実行してみましょう。敵が自機にふれると、自機が消えてしまいました。

爆発パターンを作る

しかし、いきなり消えるのはあっけないので、爆発するアニメーションをつけてみましょう。

新規オブジェクトを作成します。

キャラクタパターンを、爆発パターンの一番先頭のパターンにします。

ダブルクリックして、動作を次のように書きます

extends SpriteChar;
wait(5);
p=p+1;
wait(5);
p=p+1;
wait(5);
p=p+1;
wait(5);

新しくwait(5);という命令が出てきました。これはupdate();に似ています。

書式

wait(待機フレーム数);

これを行うことにより待機フレーム(コマ)数で指定しただけオブジェクトの動作が止まります。
ここでは5フレーム(5コマ)待機します。

その後、変数pの値を１増やしています。変数pは、このオブジェクトのキャラクタパターンを表します。
つまり、pを1増やすことにより、キャラクタパターンが次のように変化していきます

実行してみると、爆発しているようなアニメーションを見ることができます。

爆発パターンを出現させる

爆発パターンを、自機が死んだときに発生させるようにしましょう。
自機オブジェクトをダブルクリックして、次のように変更します

extends SpriteChar;

function onDie() {
  appear(new Bomb($MyChar.x , $MyChar.y ,$pat_Sample+4));
}

while(1) {
  if (getkey(39)>0 && x<$screenWidth ) x=x+3;
  if (getkey(37)>0 && x>0) x=x-3;
  if (getkey(32)==1) appear(new Tama(x,y,$pat_Sample+1));
  update();
}

敵を出現させるで出てきたメソッドを使いました。
しかし、先ほどと違ってこの onDieというメソッドはプログラム中から呼ばれていません。

実はこの onDieという名前をつけたメソッドは特別な意味を持ち、そのオブジェクトが死んだときに行わせる処理を記述できます。
実際には、敵のオブジェクトが$MyChar.die(); を呼んだときに、自動的にこの onDieメソッドが呼ばれます。

onDieメソッドの中では、次の処理によって爆発オブジェクトを出現させています。

 appear(new Bomb($MyChar.x , $MyChar.y ,$pat_Sample+4));

appearの使い方をもう一度復習しておきましょう

• Bombは、出現させたいオブジェクトのクラスです。
• $MyChar.x , $MyChar.y は、オブジェクトの出現する座標です。
• $pat_Sample+4は、オブジェクトのキャラクタパターンを指定します。ここではです。

$MyChar.xは、「$MyCharのx」と解釈できます。
このように、オブジェクトに続いてドット(.)と変数名書くと、そのオブジェクトが持っている変数を参照することができます。
ここでは、自機のいる場所に爆発を出現させるのにこの参照を用いています。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (4/11)

敵を出現させる

UFOを作る

この敵はすぐ下に消えてしまうので、次々と新しいオブジェクトを出現させる仕組みを作ります。

ここでは、UFOを作り、UFOから敵があらわれるという設定にします。 オブジェクトを作るを参考にUFOのオブジェクトを作成します

キャラクタパターンを設定します。

ダブルクリックして次のように動きを記述します。

extends SpriteChar;
while(1) {
  while(x<$screenWidth) {
    x=x+2;
    update();
  }
  while(x>0) {
    x=x-2;
    update();
  }
}

実行させると、UFOが画面を横方向に往復します。

UFOから敵が出現する

さらに、このUFOから敵が出現するようにします。

extends SpriteChar;
while(1) {
  while(x<$screenWidth) {
    x=x+2;
    if (rnd(100)==0) appear(new Enemy(x,y,$pat_Sample+2));
    update();
  }
  while(x>0) {
    x=x-2;
    update();
  }
}

追加した部分について解説します。

 if (rnd(100)==0) ..

rnd(100)は、0から99までの整数乱数を返します。その値が0のとき、つまり100分の１の確率でifの後ろが実行されます。

 .. appear(new Enemy(x,y,$pat_Sample+2));

これによって、敵クラス(Enemy)のオブジェクトが作成されます。 出現場所はUFOのいる場所、キャラクタパターンは $pat_Sample+2 です (弾を撃つ参考)

上の処理では、左から右に移動しているときしか敵が出現しません。 右から左に移動中にもこの処理を挿入する必要があります。

extends SpriteChar;
while(1) {
  while(x<$screenWidth) {
    x=x+2;
    if (rnd(100)==0) appear(new Enemy(x,y,$pat_Sample+2));
    update();
  }
   
  while(x>0) {
    x=x-2;
    if (rnd(100)==0) appear(new Enemy(x,y,$pat_Sample+2));
    update();
  }
}

メソッドを定義する

このプログラムでは敵を出現させるために、全く同じ処理を２箇所に書いたことになります。
これでもプログラムは正しく動くのですが、いくつか不便な点があります。
例えば出現確率を変えたいとか、敵のキャラクタパターンを変えたいとかいったときに、両方書き換える必要があります。

そこで、この敵出現処理をまとめることを行います。

extends SpriteChar;

function appearEnemy() {
  if (rnd(100)==0) appear(new Enemy(x,y,$pat_Sample+2));
}

while(1) {
  while(x<$screenWidth) {
    x=x+2;
    appearEnemy();
    update();
  }
  while(x>0) {
    x=x-2;
    appearEnemy();
    update();
  }
}

まず、一番上に書いた部分について解説します。

function appearEnemy() {
  if (rnd(100)==0) appear(new Enemy(x,y,$pat_Sample+2));
}

これはメソッドと呼ばれ、ある処理に名前をつけて何度も使えるようにしたものです。
ここでは、1/100の確率で敵を出現させる処理に appearEnemyという名前（メソッド名）をつけています。
この部分は、最初にいきなり実行されるわけではなく、あとからこのメソッドを呼び出すことによって実行されます。

その呼び出しを行うのが、下のほうに書いた

appearEnemy();

です。このように

書式メソッドの呼び出し

メソッド名();

と書くことで、いつでもメソッドを呼ぶことができます。

試しに、敵の出現確率を1/50に変えてみましょう。それにはappearEnemyの一箇所を書き換えればよいのです。
このようにメソッドを使って、よく使う処理をまとめておくと、後で修正が楽になります。

extends SpriteChar;
function appearEnemy() {
  if (rnd(50)==0) appear(new Enemy(x,y,$pat_Sample+2));
}
while(1) {
  while(x<$screenWidth) {
    x=x+2;
    appearEnemy();
    update();
  }
  while(x>0) {
    x=x-2;
    appearEnemy();
    update();
  }
}

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (3/11)

敵を動かす

今度は敵を作ってみましょう。オブジェクトを作るを参考にオブジェクトを作成します

キャラクタパターンを指定します

とりあえず、上から下に飛んでくる動きにしてみましょう。敵をダブルクリックして次のように入力します。

extends SpriteChar;
while (y<$screenHeight) {
  y=y+2;
  update();
}

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (2/11)

弾を撃つ

弾を作る

オブジェクトを作るを参考に弾のオブジェクトを作ります。

オブジェクトのキャラクタパターンを指定するを参考に、弾のパターンを指定します

弾をダブルクリックし、次のように入力します。

extends SpriteChar;
while(y>0) {
  y=y-8;
  update();
}

実行すると、弾が上に飛んでいくのが見えます。 よく見えなかった場合、F2で止めて、弾をドラッグして下の方にもっていくと見やすいでしょう。

スペースキーを押すと弾が出る

しかし実際には弾は自機から発射するものです。 スペースキーを押すと自機から弾が出るようにしましょう。

自機をダブルクリックし、次のように変更します

extends SpriteChar;
while(1) {
  if (getkey(39)>0 && x<$screenWidth) x=x+3;
  if (getkey(37)>0 && x>0) x=x-3;
  if (getkey(32)==1) appear(new Tama(x,y,$pat_Sample+1));
  update();
}

まず前半部(if文の条件)から解説します

if (getkey(32)==1) ...

これは、自機を動かすでも出てきましたが、キーの状態を判定します 32はスペースキーを表す番号です。
スペースキーが押された瞬間だけ if文のあとの処理を行います(押しっぱなしでは弾が撃てません)

そして、スペースキーがおされていた場合の、弾を撃つ処理です

... appear(new Tama(x,y,$pat_Sample+1));

これは、新しいオブジェクトを作るときの決まり文句で、次のような パラメータを指定します。

書式

appear(new クラス名 ( x座標 , y座標 ,キャラクタパターン ))

クラス名には、作成したいオブジェクトのクラス名を指定します。
...といっても、クラスの話は少し難しいので、ここでは次の手順でクラス名を決めてください。

まず、今は弾を出したいのですから、とりあえず画面上の弾をクリックします。

すると、オブジェクトインスペクタに弾の内容が表示されますが、「クラス名」という欄に注目してください。
ここに「Tama」とかいてあります。これが弾のクラス名になります

x座標 , y座標

作成するオブジェクトの位置を指定します。ここでは、自機から発射されるので、自機のx,y座標をそのまま使います

キャラクタパターン

作成するオブジェクトのキャラクタパターンを指定します。
キャラクタパターンを指定するには、下図のように、キャラクタパターンウィンドウからキャラクタパターンを選ぶと、ステータスバーのところにキャラクタパターンの値が表示されます。
この値（$pat_Sample+1）をパラメータとして記述します。
同時に、この値がクリップボードにコピーされます。

さて、これで実行させてみましょう。スペースキーを押すと弾が発射されるようになりました。

←前 次→ チュートリアル Wikiトップ

←目次 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - シューティングゲーム (1/11)

自機を動かす

まず、「ファイル」＞「メインメニュー」で最初の画面に戻ってください。

新規プロジェクトを参考に新規ページを作成してください。

自機を作る

自機を作ってみましょう。オブジェクトを作るを参考にオブジェクトを作成します

オブジェクトのキャラクタパターンを指定するを参考に、自機のパターンを指定します。
先ほど用いた"Projects"フォルダの下のSample.bmpを使います

自機の動きを定義する

自機をダブルクリックし、次のように入力します。

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x=x+3;
  if (getkey(37)>0) x=x-3;
  update();
}

自機の位置は画面下のほうがよいので、ドラッグして移動しておきます。 実行してみましょう。カーソルキーの右と左で自機を動かせます。

まず

while(1) {...

について解説します。
whileは()内の条件が成り立っている間、次の{}内を実行するものですが、条件のところに 1と書いてあります。
1というのは「いつでも成り立つ」といった意味があります。
つまりwhile(1)と書くと、その後ろの処理を永久に行うことになります。(参考：while)

次に、その永久に繰り返される処理の内容を解説していきます。

getkey(x)は、キーが押されているかどうかの判定を行います。
xは調べたいキーの番号で 39がカーソルキーの右, 37が左です

getkey(x)はキーの状態によって、次のような値を表します

• 0:押されていない
• 1:今押されたばかり
• 2以上:押しっぱなしになっている

※ 他のキーの状態を調べたい場合はgetkeyを参照してください

以上をふまえて、移動の仕組みをまとめると、次のようになります。

  if (getkey(39)>0)   x=x+3;
     ↑右がおされたら ↑右に移動
  if (getkey(37)>0)   x=x-3;
     ↑左がおされたら ↑左に移動

画面はみだし判定

ところで、このままだと右端や左端にはみだしてもそのまま画面外を移動できてしまうので、次のように変更します

extends SpriteChar;
while(1) {
  if (getkey(39)>0 && x<$screenWidth) x=x+3;
  if (getkey(37)>0 && x>0) x=x-3;
  update();
}

このように && で条件をつなげると「～かつ～ならば」という記述ができます。

  if (getkey(39)>0 && x<$screenWidth)                  x=x+3;
     ↑右がおされて ↑かつ、画面右端に到達してないなら ↑右に移動
  if (getkey(37)>0 && x>0)                             x=x-3;
     ↑左がおされて ↑かつ、画面左端に到達してないなら ↑左に移動

←目次 次→ チュートリアル Wikiトップ

←前 目次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (7/7)

配布する

これでゲームは一通り完成です。 このゲームを配布したいとします。
他の人にTonyuをダウンロードさせるのは大変なので、単体で動くプログラム（ランタイム）を作成しましょう。

ファイル＞ランタイム作成を選びます。

「メインページ」を $page_startにします。
これにより、最初にタイトルページが開くようになります。

タイトル、作者等の情報を入れます。

「ネットランキング管理者パスワード」は空欄にしてください。

「配布条件」について説明します。

このランタイムには、今までつくったプログラムのソースファイルがそのまま含まれます。
このため、他のユーザが簡単にプログラムの中身を書き換えることができます。
内容を書き換えたゲーム（または今あなたがつくったゲームそのもの）を、他の人が勝手に配っていいかを決めるのが配布条件です

• 再配布、改造ともに無断で許可
  プログラムの中身を変えようと変えまいと、他の人が勝手に配ってよいという、いちばん緩い条件です
• 内容を変更しない再配布を無断で許可、改造は不可
  プログラムの中身を変えなければ、勝手に配ってよいという条件です
• 再配布、改造は要連絡
  他の人が配布したい場合、作者への連絡が必要、という条件です。この場合メールアドレス等、あなたの連絡先を書いてください。
• 再配布、改造は不可
  勝手に配るな、といういちばんきつい条件です。
• その他
  どれにもあてはまらない場合は、条件を自分で書くことができます。

最後に、ランタイムを作成するディレクトリを選び、OKを押します。

ランタイム作成が完了したら、「OK」を選んでフォルダを開いてみます

このフォルダのTonyuRun.exeを実行すれば、作ったゲームが実行できます。
このフォルダを圧縮ツール等でまとめたものを配布してください。

←前 目次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (6/7)

次の面に移る

敵をすべて倒すと、次の面に移る処理を行いましょう。

2面を作る

といっても、今のところゲーム画面が１つしかないので もう１つ面をつくることにしましょう。
今までのゲーム画面を１面、これから新しく作る面を２面とします。

まず１面のページを開きます。 そして「ファイル」の「名前をつけて保存」を選びます。

ここではstage2.cmmlという名前で保存します。

これで、１面の内容が２面にコピーされました。
今は２面が開いているので、２面のパターンを作ってみましょう
敵の数をふやしたり、はしごの配置をかえたり、いろいろ変更をくわえてみてください。

1面をクリアしたら、2面を開始する処理を作る

さらに、1面をクリアしたらこの2面が始まるようにしましょう
プロジェクトマネージャを開き、再び１面を開きます。

まず、クリアしたかどうかの判定を行いましょう
クリアしたら２面に移動するという動作を行うオブジェクトを作ります。

オブジェクトを作るを参考にオブジェクトを作成します。ここでは $stage1 という名前にします。

さらに、「オブジェクトの種類」を「シークレット」にします。
このオブジェクトは、クリアしたかどうかの判定だけを行うので、実行中は表示する必要がありません。
「シークレット」にすると実行中に表示されないオブジェクトになります。

オブジェクトをダブルクリックし、次のように入力します。

extends SecretChar;
enemyLives=1;
while (enemyLives==1) {
  enemyLives=0;
  for (e in $chars) {
    if (e is Enemy) enemyLives=1;
  }
  update();
}
$projectManager.loadPage( $page_stage2 );

$page_stage2の部分は、２面のページの名前です。
これはプロジェクトマネージャで確認して、もし違う名前だったらその名前にしてください。

実行してみると、敵が全滅すると２面が開始します。

ここで、 $stage1オブジェクトの動作を説明します。

まず、敵が全滅するまでは、この部分を実行します:

enemyLives=1;
while (enemyLives==1) {
  enemyLives=0;
  for (e in $chars) {
    if (e is Enemy) enemyLives=1;
  }
  update();
}

while文の働きにより、enemyLivesが１のときは次の部分(while文の中)を実行します。

  enemyLives=0;
  for (e in $chars) {
    if (e is Enemy) enemyLives=1;
  }
  update();

↑この処理は、enemyLivesが０になるまで繰り返します。

enemyLivesは

  enemyLives=0;

によって、一旦０になりますが

  for (e in $chars) {
    if (e is Enemy) enemyLives=1;
  }

によって、画面内に敵が１つでもいる場合、１になります

結果として、敵がまったくいなくなると、enemyLivesが０になり、while文以降の処理に以降します。

while文以降の処理では、２面を読み込みます。

 $projectManager.loadPage($page_stage2);

2面をクリアしたときの処理を追加する

今回は簡単のため、２面クリアしたら終わりにして、タイトルに戻るようにしましょう。

まず２面を読み込みます

オブジェクトを作るを参考にオブジェクトを作成します。
ここでは $stage2 という名前にします。
また、先ほどと同じく、「シークレット」を選択します。

オブジェクトをダブルクリックし、次のように入力します。

extends SecretChar;
enemyLives=1;
while (enemyLives==1) {
  enemyLives=0;
  for (e in $chars) {
    if (e is Enemy) enemyLives=1;
  }
  update();
}
$projectManager.loadPage( $page_start );

$page_startの部分は、スタート画面のページの名前です。
これはプロジェクトマネージャで確認して、もし違う名前だったらその名前にしてください。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (5/7)

スタート画面を作る

ゲーム開始前のスタート画面を作ってみましょう

まずスタート画面用の新規ページを作ります。
メニューの「ファイル」＞「プロジェクトに新規ページを追加」を選びます。

ゲーム画面のファイルがあるディレクトリと同じディレクトリに、 start.cmmlというファイル名のページを作成します。

ここでは単に"Press Space Key"と表示させ、スペースキーの入力が あったらゲーム画面に移動しましょう

Press Space Key という文字を表示する

オブジェクトを作るを参考にオブジェクトを作成します ただし、「オブジェクトの種類」に「テキスト」を選択してください。

オブジェクトクリックし、オブジェクトインスペクタでtextの値を編集します。

オブジェクトをダブルクリックし、次のように入力します。

extends TextChar;
while(1) {
  update();
}

実行させると、画面にPress Space Keyと出ます。

ページを変える

さらに、スペースキーを押すと先ほどのゲーム画面に移動するようにします。

まず少し準備が要ります。ツールメインウィンドウのを選んでください。
すると、このように $page_index、 $page_start といった２つの項目が現れます。
これは、このゲームが使用するページの一覧です

ここでは、

• スタート画面のページを$page_start
• ゲーム画面のページを$page_index

としてすすめていきます。

先ほどPress Space Keyを表示させるオブジェクトをダブルクリックし、次のように変更します。

extends TextChar;
while(1) {
  if (getkey(32)>0) $projectManager.loadPage($page_index);
  update();
}

実行させてみましょう。
スペースキーをおすと、先ほどのゲーム画面に移動します。
プログラムを停止させ、もう一度プロジェクトマネージャを開いてください。
"$page_start"の欄をダブルクリックして、スタート画面に移動してください。

さきほどのプログラムの解説です。

if (getkey(32)>0)

この部分は、自機を動かすで説明したように、キーボードの入力を判定します。
32はスペースキーを表します。
スペースキーが押されると、次の部分を実行します。

$projectManager.loadPage($page_index);

これは、他のページを読み込む命令で、次のような使い方をします

書式

$projectManager.loadPage(ページ名);

ページ名は、さきほどプロジェクトマネージャで確認したページの名前です。

自機が死んだらスタート画面に戻る

先ほどのページを読み込む命令を使って、自機が死んだらスタート画面に戻るようにしましょう

プロジェクトマネージャを開いてください。
"$page_index"の欄をダブルクリックして、ゲーム画面に移動してください。

敵をダブルクリックし、次のように変更します。

extends SpriteChar;
vx=2;
while(1) {
  x+=vx;
  if (x<0) vx=2; if (x>$screenWidth) vx=-2; if (rnd(500)==0) vx=-vx;
  if (crashTo($MyChar)) {
  //↑敵と自機がぶつかったときに
    if ((vx>0 && $MyChar.x<x) || (vx<0 && $MyChar.x>x)) {
    //↑敵が右方向、自機が左　または 敵が左方向、自機が右
      die();
      //↑ならば、敵が死ぬ
    } else {
      $MyChar.die();
      //↑そうでなければ自機が死ぬ」
      $projectManager.loadPage($page_start);
    }
  }
  if (vx<0) f=1; else f=0;
  update();
}

これにより、自機が死ぬとスタート画面($page_start)が読み込まれます。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (4/7)

自機や敵を破壊する

このゲームでは、敵をやっつける方法が少々変わっていて 「敵の背後から体当たりする」という方法を使います

敵と自機がぶつかったら、自機が死ぬ

とりあえず、敵にぶつかったら自機が死ぬようにしましょう

敵オブジェクトをダブルクリックして、次の行を追加します

extends SpriteChar;
vx=2;
while(1) {
  x+=vx;
  if (x<0) vx=2;
  if (x>$screenWidth) vx=-2;
  if (rnd(500)==0) vx=-vx;
  if (crashTo($MyChar)) $MyChar.die();
  if (vx<0) f=1; else f=0;
  update();
}

まずifの条件部から見ていきましょう

 if (crashTo($MyChar)) ...

crashToは、この敵が自機($MyChar)に当たっているかという判定を行います。
当たっている場合はif文の後ろが実行されます。

なお、自機の名前は、自機をクリックし、オブジェクトインスペクタで確認できます。

敵と自機がぶつかったら、敵が死ぬ

このままだと必ず自機が死ぬので、自機が敵の背後からぶつかった場合には、
敵のほうが死ぬようにしましょう。

　ところで「背後からぶつかる」というのをもう少し詳しく説明すると

　「敵の進行方向と反対側から自機がぶつかる」

ということになります、もうすこし具体的にいうと

　「敵が右(左)に進んでいるとき、自機が左(右)からぶつかる」

となります。

さらに、「自機が左(右)からぶつかる」は、いいかえると

「敵と自機がぶつかったとき、自機が敵より左(右)にいる」

となります。

　これらのことをまとめると

「敵と自機がぶつかったときに、
　　敵が右に進んでいて、自機が左にいる　または
　　敵が左に進んでいて、自機が右にいる
　　ならば、敵が死ぬ。そうでなければ自機が死ぬ」
という条件を記述すればよさそうです。 これらを踏まえて、プログラムは次のようになります。

extends SpriteChar;
vx=2;
while(1) {
  x+=vx;
  if (x<0) vx=2; if (x>$screenWidth) vx=-2; if (rnd(500)==0) vx=-vx;
  if (crashTo($MyChar)) {
  //↑敵と自機がぶつかったときに
    if ((vx>0 && $MyChar.x<x) || (vx<0 && $MyChar.x>x)) {
    //↑敵が右方向、自機が左　または 敵が左方向、自機が右
      die();
      //↑ならば、敵が死ぬ
    } else {
      $MyChar.die();
      //↑そうでなければ自機が死ぬ」
    }
  }
  if (vx<0) f=1; else f=0;
  update();
}

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (3/7)

敵を動かす

敵を作ってみましょう 敵は次にあげるようなごく単純な動きしかしないものとします

• 左右移動しかしない
• 画面端にくるか、一定の確率で移動方向が反転する

敵を作る

オブジェクトを作るを参考にオブジェクトを作成します

オブジェクトのキャラクタパターンを指定するを参考に、自機のパターンを指定します。
先ほど用いたSamplesの下のMaze.bmpを使います

敵の動きを定義する

敵をダブルクリックし、次のように入力します。

extends SpriteChar;
vx=2;
while(1) {
  x+=vx;
  if (x<0) vx=2; 
  if (x>$screenWidth) vx=-2;
  if (rnd(500)==0) vx=-vx;
  update();
}

実行してみましょう。
左に進んでいるとき、向きが反対になっています。
そこで、次のような部分を追加してください

extends SpriteChar;
vx=2;
while(1) {
  x+=vx;
  if (x<0) vx=2;
  if (x>$screenWidth) vx=-2;
  if (rnd(500)==0) vx=-vx;
  if (vx<0) f=1; else f=0;
  update();
}

変数fは、0以外の値を設定すると、パターンが左右反転します。

敵をたくさん配置する

敵が１匹ではおもしろくないので、敵をたくさん配置してみましょう。
まず敵をクリックし、そのあとメニューの 「オブジェクト」＞「コピー」を選んでください
さらに、 「オブジェクト」＞「貼り付け」を選んでください
敵がふえました。 この要領で敵をいくつか配置してみてください。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (2/7)

自機を動かす

自機を作る

自機を作ってみましょう。オブジェクトを作るを参考にオブジェクトを作成します

オブジェクトのキャラクタパターンを指定するを参考に、自機のパターンを指定します。
先ほど用いたSamplesの下のMaze.bmpを使います

自機の動きを定義する

自機をダブルクリックし、次のように入力します。

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  update();
}

実行してみましょう。カーソルキーの右と左で自機を動かせます。

下に落ちる

しかし、これだと自機が空中に浮いています。
下に落ちる処理を付け加えて見ましょう。

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  y+=3;
  update();
}

これで実行すると、自機はどんどん下におちていきます。

床やはしごの判定を加える

今度は、ずっと落ちっぱなしですね。
床やはしごにあたったら止まるようにしないといけません。

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  if ($map.getAt(x,y)==$pat_Maze+1) y+=3;
  update();
}

ここで新しく$map.getAt(x,y)という命令がでてきますが、これは

「(x,y)地点にあるマップのキャラクタパターンを返す」

という働きがあります

(x,y)とは自分のいる地点ですから、
自分が床でもはしごでもない場所（紺色の空間）にいる場合だけ落ちるようにすればよいのです。

めり込みを修正する

さて、実行させてみると、確かに床で止まるのですが、
ちょっとめりこんだ格好になっています。

この仕組みを説明しましょう。次の図をみてください。

これで、すこしめりこんだ理由はわかったでしょうか
めりこまないようにするには、もう少し下の点で判定をすればよいのです。

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  if ($map.getAt(x,y+16)==$pat_Maze+1) y+=3;
  update();
}

さて、これでうごかしてみましょう。 まだ足りないものがあります。
はしごを使っての上下移動ができません。

そこで、自分がはしごの上にいたら上下キーで移動できるようにしましょう

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3; 
  if (getkey(37)>0) x-=3;
  if ($map.getAt(x,y+16)==$pat_Maze+1) y+=3;
  if ($map.getAt(x,y)==$pat_maze+2) {
     if (getkey(40)>0) y+=3;
     if (getkey(38)>0) y-=3;
  }
  update();
}

追加した部分の解説をします。

 if ($map.getAt(x,y)==$pat_maze+2) {

↑ここは、自分のいる場所にはしご（キャラクタパターン番号：$pat_maze+2)があるかどうかの判定です

はしごがある場合はif文の中の処理を行います

if (getkey(40)>0) y+=3;   
if (getkey(38)>0) y-=3;

↑それぞれ、上や下がおされたら上または下に移動します。

実行させてみましょう。
とりあえずはしごを使って上下移動ができるようですが...
ずっと下を押していたら、壁にめりこんでしまいました。

プログラムをもう一度みてみましょう

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  if ($map.getAt(x,y+16)==$pat_Maze+1) y+=3;
  if ($map.getAt(x,y)==$pat_maze+2) {
    if (getkey(40)>0) y+=3;
    if (getkey(38)>0) y-=3; 
  }
  update();
}

下を押したら、下に移動するという処理は

 if (getkey(40)>0) y+=3;

でやっていますが、 ここに「下のほうに壁があったらとまる」という 判定を加えたほうがよさそうです。
逆にいえば「下が押されていて、かつ下に壁がなかったら、下に移動できる」と書けばよいのです。
先ほどの

 if ($map.getAt(x,y+16)==$pat_Maze+1) y+=3;

という処理は 「下になにもない空間があった場合、下に移動する（落ちる）」 という処理でした。
これにならって、次のようにかきなおします

extends SpriteChar;
 while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  if ($map.getAt(x,y+16)==$pat_Maze+1) y+=3;
  if ($map.getAt(x,y)==$pat_maze+2) {
    if (getkey(40)>0 && $map.getAt(x,y+16)!=$pat_Maze+0) y+=3; 
    if (getkey(38)>0) y-=3;
  }
  update();
}

実行させてみましょう。自機の動きはひとまず完成です。

←前 次→ チュートリアル Wikiトップ

←目次 次→ チュートリアル Wikiトップ

チュートリアル - 実践編 - 迷路ゲーム (1/7)

マップを描く

今回作るゲームは、下の図のように横からみた4階建ての建物のなかを主人公が移動し、
画面上の敵をすべて退治するものです。

まず、「ファイル」＞「メインメニュー」で最初の画面に戻ってください。

迷路ゲーム用の新規プロジェクトを作ります。 新規プロジェクトを作るを参考にしてください。

まず迷路用のマップを描きましょう メニューの「ウィンドウ」から「マップ作成」を選びます。

次のように値を入力し、OKを押します

ツールウィンドウの をクリックし、キャラクタパターンウィンドウを表示します。

「追加」をクリックし、"Projects"フォルダのmaze.bmpを選びます。

追加された欄をダブルクリックします。このなかで、左から２番目のの紺色のパターンをクリックします

さらに、ツールウィンドウの左端のリストから"Bold"を選びます。
メインウィンドウ上でのマウスカーソルがペンの形になります。

とりあえず画面中をこの紺色のパターンでぬりつぶしましょう。
メインウィンドウ上で左ボタンを押しながらドラッグすると、パターンが塗られます。

次に、ツールウィンドウで"Fine"を選択します。

キャラクタパターンウィンドウで、左端のブロックのパターンを選びます

次の図のようにマップを描きます

同様に、３番目のはしごのパターンを選び、次のようにマップを描きます
※右クリックでマウスと重なっているマップのパターンを拾えます。

マップを描き終わったら、ツールウィンドウで"Object"を選んでおきましょう

←目次 次→ チュートリアル Wikiトップ

←前 目次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (付録)

キャラクタパターン用ビットマップの作り方

Tonyuに読み込むキャラクタパターンは、bmpファイルまたはpngファイルから読み込みます。
その際、bmp/png画像は次の規則に従って描画してください。

まず、全体を同じ色で塗ります。これがこの画像全体の「背景色」になります

キャラクタパターンを描画するには、まず描画したい矩形領域全体を同じ色で塗ります。
これがこのパターンの「透過色」になります。左上の1ドットは背景色を残して下さい。

この領域にキャラクタパターンを描くのですが、周囲1ドットは透過色以外を塗らないでください。

同様に他のパターンを描きます。このとき、パターン同士が隣接しないようにしてください。

※ここで書いた方式に従っていない画像を読み込むと、次のようにパターンの切り分けに失敗した場所に×が点滅します。
 この場合は全体を1枚のパターンとみなします。

←前 目次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (9/9)

オブジェクトを追いかけるオブジェクト

カーソルキーで動くオブジェクト で作成したオブジェクトを追いかけるオブジェクトを作ってみます。

まず、カーソルキーで動くオブジェクト で作成したオブジェクトをクリックしてください。
オブジェクトインスペクタで、このオブジェクトの名前を確認します。
下の図では $Cursorという名前になっています。

新しくオブジェクトを作成します

新しいオブジェクトをダブルクリックし、次のように入力します。

extends SpriteChar;

while(1) {
  if (x < $Cursor.x) x+=2;
  if (x > $Cursor.x) x-=2;
  if (y < $Cursor.y) y+=2;
  if (y > $Cursor.y) y-=2;
  update();
}

$Cursorの部分は、先ほど確認したカーソルキーで動くオブジェクトで作成したオブジェクトの名前にしてください。
実行させると、新しくつくったオブジェクトは、カーソルキーで動かせるオブジェクトのいる方にちかづいてきます。

プログラムの説明をします。

if (x < $Cursor.x) x+=2;

ここででてくる $Cursor.xの読み方は「オブジェクト$Cursorのxの値」、つまり、カーソルキーでうごかせるオブジェクト( $Cursor )のx座標です。

if文の条件は

「自分のx座標が $Cursorのx座標より小さければ 」

つまり

「自分が$Cursorより左にいれば」

となります。

さらに、その条件が成り立った場合はxを増やします。つまり右に移動します。 よって

「自分が$Cursorより左にいれば、右方向にうごく」 ということになります。 次の３行も同様に
「自分が$Cursorより右にいれば、左方向にうごく」
「自分が$Cursorより上にいれば、下方向にうごく」
「自分が$Cursorより下にいれば、上方向にうごく」 ということを表します。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (8/9)

カーソルキーで動くオブジェクト

基礎編のまとめとして、典型的なオブジェクトを２つほど作ってみます。まずカーソルキーを使って動かせるオブジェクトです。

オブジェクトを作るを参考に、新しいオブジェクトを作成します

オブジェクトをダブルクリックし、次のように入力します。

extends SpriteChar;

while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  if (getkey(40)>0) y+=3;
  if (getkey(38)>0) y-=3;
  update();
}

新しくgetkeyというものがでてきましたが、 これはキー入力を判定するのに用います。

getkey(x)は、キーが押されているかどうかの判定を行います。
xは調べたいキーの番号で
39がカーソルキーの右, 37が左です
38がカーソルキーの上, 40が下です

getkey(x)はキーの状態によって、次のような値を表します:

• 0:押されていない
• 1:今押されたばかり
• 2以上:押しっぱなしになっている

※他のキーの状態を調べたい場合はgetkeyを参照してください。 getkeyの部分は次のようにいいかえられます

if (右がおされた) 右に3だけ移動;
if (左がおされた) 左に3だけ移動;
if (下がおされた) 下に3だけ移動;
if (上がおされた) 上に3だけ移動;

実行してみましょう。カーソルキーをつかって動かせます。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (7/9)

オブジェクトいろいろ

オブジェクト作成時に、オブジェクトの種類を指定すると、いろいろなオブジェクトを作ることができます

DXスプライト

半透明、回転拡大縮小ができるオブジェクトです

メニューの「オブジェクト」→「新規」を選び、次の操作をしてみましょう

1. クラス名を入力

2. 「DXスプライト」をクリック

3. 「OK」をクリック

オブジェクトが表示されました

オブジェクトインスペクタで、次の値を変更してみましょう

• angle
  オブジェクトの回転角度を指定します。単位は度です
• alpha
  オブジェクトの透明度を指定します。値は0から255の範囲で、値が小さいほど透けて見えます
• scaleX
  オブジェクトの大きさを指定します。もとの大きさは1です

例：

テキスト

文字を表示するオブジェクトです

メニューの「オブジェクト」→「新規」を選び、次の操作をしてみましょう

1. クラス名を入力

2. 「テキスト」をクリック

3. 「OK」をクリック

オブジェクトが表示されました

オブジェクトインスペクタで、次の値を変更してみましょう

• text
  表示する文字列を指定します。

注意：textはかならず文字列を"(ダブルクォート)で囲んでください。

• size
  テキストの大きさを指定します。

• col
  テキストの色を指定します。色は次のいずれかを選びます

  ■	$clBlack	■	$clRed	■	$clGreen	■	$clBlue
  ■	$clWhite	■	$clYellow	■	$clAqua	■	$clPink

• font
  テキストのフォントを指定します。

例：

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (6/9)

オブジェクトのキャラクタパターンを指定する

今まではオブジェクトのグラフィックに緑色の四角を使用していましたが、別のグラフィックを表示する方法を示します。
まずページにグラフィックスを読み込む必要があります。左上の「ツールウィンドウから左端のボタンを押します。

追加をクリックします。

一階層上のフォルダに移動し、"Sample.bmp"を選択します。

このページからSample.bmpが使用できる状態になりました。 キャラクタパターンを変えたいオブジェクトをクリックします。

オブジェクトインスペクタで、変数pの欄をクリックします。

キャラクタパターンウィンドウの、Sample.bmpの欄をダブルクリックします。

キャラクタをクリックして選択します。キャラクタパターンの値が表示されるとともに、オブジェクトインスペクタ上でpの値が変化します。

実行させると、選択したキャラクタパターンのオブジェクトが動きます。

※キャラクタパターンを独自に作成する場合、キャラクタパターン用ビットマップの作り方に書いてある方法に基づいてパターンを作成してください

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (5/9)

オブジェクトをコピーする

すでに画面上にあるオブジェクトと同じ動きをするオブジェクトを作ることができます。

コピーしたいオブジェクトをクリックし、メニューの「オブジェクト」→「コピー」を選択します

メニューの「オブジェクト」→「貼り付け」を選択します。 新しいオブジェクトが現れます。

実行すると、貼り付けられたオブジェクトもコピー元のオブジェクトと同じ動作をします。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (4/9)

オブジェクトを動かす2

先ほど書いたプログラムについて解説します。

1: extends SpriteChar;
2: 
3: while(x<$screenWidth) {
4:   x+=1;
5:   update();
6: }

• 1行目は「おまじない」だと思ってとりあえず無視してください。
• 3行目は「自分のx座標が画面右端の座標($screenWidth)より小さい（$screenWidthより左側である）間、{}で囲まれた処理（4,5行目)を実行しなさい」という意味になります(参考：while文)
• 4行目は、x座標を1増加、つまり右に１ドット分移動します
• 5行目は、画面のかきかえを行います(参考：updateメソッド)

もう少し複雑な動きをするオブジェクトを作ってみましょう

オブジェクトを作るを参考に、新しいオブジェクトを作成します

新しいオブジェクトをダブルクリックして、次のように入力します(先頭のextends SpriteChar;は自動的に入力されているので新たに入力する必要はありません)

extends SpriteChar;

while(x<$screenWidth) {
  y+=vy;
  vy+=0.1;
  if (y>$screenHeight) {y=$screenHeight; vy=-vy;}
  x+=1;
  update();
}

実行してみましょう。オブジェクトが跳ねながら右に移動する様子が見えたと 思います。

さっきと違うのは、この３行が追加されたところです

4: y+=vy;
5: vy+=0.1;
6: if (y>$screenHeight) {y=$screenHeight; vy=-vy;}

• 4行目は、自分のy座標をvyだけ加算します。つまりvyはyの速度をあらわします
• 5行目は、vyに0.1を加えます。yの速度に0.1を加えるので、0.1はyの加速度（重力）をあらわします。
• 6行目は、跳ね返りの処理です。まず、

if (y>$screenHeight) ...

これは、もし( if )yが画面下端の座標($screenHeight)より大きくなったら、つまり yが画面下端より下になったら、その後ろの{と}で囲まれた部分を実行しなさい という意味です。

　そして、その{と}で囲まれた部分

 ... {y=$screenHeight; vy=-vy;}

これは、yを$screenHeightにして、下にはみ出ないようにします。 さらにvyの符号を反転(=移動方向のy成分を反転)します。

この「もし～なら～する」という記述はif文と呼ばれ、今後もよく出てくるので覚えておいてください

書式

if (条件) 処理

条件に書いた式が真であるときだけ処理を行います

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (3/9)

オブジェクトを動かす

作成したオブジェクトをダブルクリックします。 エディタが開きます。

ここでは、右方向に移動するという動きを定義してみます。エディタに次のように入力します。

extends SpriteChar;

while(x<$screenWidth) {
  x+=1;
  update();
}

メニューの「実行」→「実行(F9)」を選択すると、オブジェクトが動くのが確認できます。

メニューの「実行」→「実行(F2)」で実行を停止します。

←前 次→ チュートリアル Wikiトップ

←前 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (2/9)

オブジェクトを作る

メインウィンドウの「オブジェクト」メニューから「新規」を選択します。

名前とクラス名を次のように入力し、OKを押します。

画面に新しいオブジェクトが現れます。

←前 次→ チュートリアル Wikiトップ

←目次 次→ チュートリアル Wikiトップ

チュートリアル - 基礎編 (1/9)

新規プロジェクトを作る

まずTonyuを起動します。

新しいページを作るには、「新規プロジェクト」を選択します。

次のように入力し、OKをクリックします。

←目次 次→ チュートリアル Wikiトップ

Wikiトップ

謝辞

Tonyuの作成にあたっては、たくさんの方のご協力をいただいております。これらの 方々に感謝いたします。

メソッド

次のクラス、メソッドは、ユーザの皆様よりお寄せいただいたものを修正・登録したものです。

• Object.colorHSL ソンヨルさん
• Sprite.drawBrokenLine / Panel.drawBrokenLine ラティウスさん
• $Math　りょうたさん
• RadioButton CheckBox Sprite.centerText, Sprite.drawVerticalText, Sprite.drawPolygon, Sprite.drawRect, Sprite.drawRectDx, Sprite.drawTriangle, Sprite.gradationLine, Sprite.gradationRect, Sprite.gradationText kenjiさん

ドキュメント

• このヘルプのangleDiffメソッド、angle,sin,cos,distの関係の項目に含まれる画像は、AKJさんの"Tonyu Tips"にある画像をいただき、加筆訂正したものです。

ライブラリ

このプログラムを作成するにあたって、次のライブラリを使用 させて頂きました。

• DelphiX 堀　浩行さん
• BREGEXP.DLL Babaさん
• Delphi用 BREGEXP.DLL利用ユニット 武内 修さん
• 文字コード変換総合コンポーネントTPzConv PzFactoryさん
• GLDPNG Tarquinさん ※GLDPNG(ZLIB)の著作権表示:

   GLDPNG (c) 1998-2001 Copyright Tarquin All Rights Reserved.
   ZLIB ver 1.1.3 (c) 1995-1996 Copyright Jean-loup Gailly and Mark Adler
  

Wikiトップ

Wikiトップ

更新履歴

2024-02-17
・ver1.303リリース

2024-02-12
・ver1.302リリース
・Tonyuについて

2024-02-08
・ver1.301リリース

2022-08-05
・ver1.30リリース

2021-12-12
・ver1.29リリース

過去の更新履歴

2021-10-03
・本Wiki完成

2021-08-31
・本Wikiに移転

2021-07-30
・ver1.29リリース
・M-Twoリリース

2021-04-13
・本Wiki公開

2021-04-07
・ver1.28リリース

細かい更新履歴

細かい更新履歴は「makkii-bcr/Tonyu1-wiki」を参照してください。

Wikiトップ

Wikiトップ

全ページ

※ このページのデザインで表示されている全ページです。旧デザインや他サイトのページは含まれていません。

1. チュートリアル - 実践編 - シューティングゲーム (11/ 11) - ネットランキング対応にする
2. チュートリアル - 実践編 - シューティングゲーム (11-2 / 11) - ネットランキング対応にする - ネットランキング対応のランタイムを作成する
3. チュートリアル - 実践編 - シューティングゲーム (11-1 / 11) - ネットランキング対応にする - ランキング用CGIを設置する
4. チュートリアル - 実践編 - シューティングゲーム (10/11) - 配布する
5. チュートリアル - 実践編 - シューティングゲーム (9/11) - 弾、爆発を削除する
6. チュートリアル - 実践編 - シューティングゲーム (8/11) - 得点を表示する
7. チュートリアル - 実践編 - シューティングゲーム (7/11) - 敵の動きに変化をつける
8. チュートリアル - 実践編 - シューティングゲーム (6/11) - 敵を破壊する
9. チュートリアル - 実践編 - シューティングゲーム (5/11) - 自機を破壊する
10. チュートリアル - 実践編 - シューティングゲーム (4/11) - 敵を出現させる
11. チュートリアル - 実践編 - シューティングゲーム (3/11) - 敵を動かす
12. チュートリアル - 実践編 - シューティングゲーム (2/11) - 弾を撃つ
13. チュートリアル - 実践編 - シューティングゲーム (1/11) - 自機を動かす
14. チュートリアル - 実践編 - 迷路ゲーム (7/7) - 配布する
15. チュートリアル - 実践編 - 迷路ゲーム (6/7) - 次の面に移る
16. チュートリアル - 実践編 - 迷路ゲーム (5/7) - スタート画面を作る
17. チュートリアル - 実践編 - 迷路ゲーム (4/7) - 自機や敵を破壊する
18. チュートリアル - 実践編 - 迷路ゲーム (3/7) - 敵を動かす
19. チュートリアル - 実践編 - 迷路ゲーム (2/7) - 自機を動かす
20. チュートリアル - 実践編 - 迷路ゲーム (1/7) - マップを描く
21. チュートリアル - 基礎編 (付録) - キャラクタパターン用ビットマップの作り方
22. チュートリアル - 基礎編 (9/9) - オブジェクトを追いかけるオブジェクト
23. チュートリアル - 基礎編 (8/9) - カーソルキーで動くオブジェクト
24. チュートリアル - 基礎編 (7/9) - オブジェクトいろいろ
25. チュートリアル - 基礎編 (6/9) - オブジェクトのキャラクタパターンを指定する
26. チュートリアル - 基礎編 (5/9) - オブジェクトをコピーする
27. チュートリアル - 基礎編 (4/9) - オブジェクトを動かす2
28. チュートリアル - 基礎編 (3/9) - オブジェクトを動かす
29. チュートリアル - 基礎編 (2/9) - オブジェクトを作る
30. チュートリアル - 基礎編 (1/9) - 新規プロジェクトを作る
31. 謝辞
32. 更新履歴
33. 全ページ
34. ランタイムの更新方法
35. 命令リファレンス - Window
36. 命令リファレンス - $windowX, $windowY
37. 命令リファレンス - $windowActive
38. 命令リファレンス - while
39. 命令リファレンス - $viewX, $viewY
40. 命令リファレンス - 変数
41. 命令リファレンス - 真偽
42. 命令リファレンス - TimeStopper
43. 命令リファレンス - this
44. 命令リファレンス - $TextEditor
45. 命令リファレンス - TextChar
46. 命令リファレンス - $System
47. 命令リファレンス - switch
48. 命令リファレンス - String
49. 命令リファレンス - SpriteChar
50. 命令リファレンス - Sprite
51. 命令リファレンス - $SelectBox
52. 命令リファレンス - SecretChar
53. 命令リファレンス - $screenWidth, $screenHeight
54. 命令リファレンス - return
55. 命令リファレンス - $ranking
56. 命令リファレンス - RadioButton
57. 命令リファレンス - $projectManager
58. 命令リファレンス - PlainChar
59. 命令リファレンス - PanelChar
60. 命令リファレンス - Panel
61. 命令リファレンス - $panel
62. 命令リファレンス - $panelとpanelの違い
63. 命令リファレンス - $Options
64. 命令リファレンス - .演算子
65. 命令リファレンス - Object
66. 命令リファレンス - null
67. 命令リファレンス - $mplayer
68. 命令リファレンス - $mouseManager
69. 命令リファレンス - $mouseX, $mouseY
70. 命令リファレンス - メソッドの定義
71. 命令リファレンス - メソッドの呼び出し
72. 命令リファレンス - Matrix
73. 命令リファレンス - $Math
74. 命令リファレンス - $TextEditor
75. 命令リファレンス - LightHashtable
76. 命令リファレンス - キーID一覧
77. 命令リファレンス - Joystick
78. 命令リファレンス - is
79. 命令リファレンス - $InputBox
80. 命令リファレンス - if
81. 命令リファレンス - Hashtable
82. 命令リファレンス - $osPlatformId、$osMajorVer、$osMinorVer
83. 命令リファレンス - $fullScreen
84. 命令リファレンス - FrameManager
85. 命令リファレンス - $_fps, $_rps
86. 命令リファレンス - for
87. 命令リファレンス - for..in
88. 命令リファレンス - for (xx in $chars)
89. 命令リファレンス - FileWriter
90. 命令リファレンス - FileReader
91. 命令リファレンス - ファイルの扱いについて
92. 命令リファレンス - extends
93. 命令リファレンス - DxChar
94. 命令リファレンス - $displayWidth, $displayHeight
95. 命令リファレンス - 注釈
96. 命令リファレンス - CheckBox
97. 命令リファレンス - break
98. 命令リファレンス - 代入
99. 命令リファレンス - 演算代入
100. 命令リファレンス - Array
101. 命令リファレンス - 算術演算
102. 命令リファレンス - AnimationAdaptor
103. 命令リファレンス - angle,sin,cos,distの関係
104. 命令リファレンス - AbstractHashtable
105. 命令リファレンス
106. 命令リファレンス：用途別
107. Tonyu1 プレリリースバージョン
108. Tonyu1 Wiki
109. まずはゲームをやってみる
110. エラーメッセージ
111. Tonyu1のダウンロード
112. 過去のバージョンアップ履歴
113. 互換性の設定
114. Tonyu Systemについて
115. Tonyu1とは
116. ページが無い
117. チュートリアル
118. 各種ウィンドウの使い方/オプション - BGM・効果音
119. 各種ウィンドウの使い方/オプション - キャラクタパターン
120. 各種ウィンドウの使い方/オプション - コード補完
121. 各種ウィンドウの使い方/オプション - コンソールウィンドウ
122. 各種ウィンドウの使い方/オプション - 描画方法
123. 各種ウィンドウの使い方/オプション - マップ作成
124. 各種ウィンドウの使い方/オプション - オブジェクト一覧
125. 各種ウィンドウの使い方/オプション - パフォーマンス
126. 各種ウィンドウの使い方/オプション - プロジェクトマネージャ
127. 各種ウィンドウの使い方/オプション - レシピ集
128. 各種ウィンドウの使い方/オプション - サテライト
129. 各種ウィンドウの使い方/オプション

Wikiトップ

ダウンロード Wikiトップ

ランタイムの更新方法

下記の場合、ランタイムを更新してください。

• プロジェクトボードなどでダウンロードした古いTonyu System 1のゲームがWindows10や8.1で起動しない場合
• ランタイムのPlayer.exeを最新版に更新したい場合

更新手順

1. 最新版のTonyu1をダウンロードします
2. ダウンロードしたフォルダ内のKernelとPlayer.exeを、古い（起動しない）ゲーム側のフォルダに上書きします

• 注意点
  • Player.exeを上書きしただけだと、エラーが発生する可能性があります。Kernelも上書きしてください。
  • 古い（起動しない）ゲーム側のKernelは、余分なファイルが残らないように削除してからコピーしてください。
  • 古い（起動しない）ゲーム側にTempがある場合は削除してください。

• ステータスバーの表示が気になる場合はKernel/Cookies.iniの1行目(env.StatusBar)を0にすると消えます
  • Tonyu1_29_2021_0705以降は、Cookies.iniを書き換えなくても、ステータスバーが非表示になります

ダウンロード Wikiトップ

命令リファレンス Wikiトップ

$windowオブジェクト

ウィンドウの制御を行います

メソッド一覧

変数一覧

$window.setDrawMode

描画モードを変更します

$window.setDrawMode(m);

• m
   "A" "B" "C" いずれかの文字列

※ ver1.30以降、Windows Vista以降で実行時はsetDrawMode()から描画モードを変更できないようにしました
  ウィンドウ上部のメニューから選択した場合は変更できます
  どうしても変更したい場合はsetDrawModeForceModeで効くように変更できます
  Windows XP以前で実行時はsetDrawModeが効きます

PCやOSのバージョンによって、動作負担が変わったり、画面のかくつき等が変わります
こちらで観測した限りでは下記のような特性があります

• XP以前では、A方式が軽いPCと、C方式が軽いPCの２パターンがあるようです
• Vista以降では、A方式が軽いPCしかみたことが無いので、A方式一択となりそうです
• C方式は、どのPCでも半透明の描画をすると重くなります
• Windows 8、またはWindows Vista/7でAeroが有効の場合は、OSの制御で通常ティアリング(*1)は発生しません

*1）ティアリング (ドスパラの解説ページ)
*2）スタッタリング (ドスパラの解説ページ)

$window.setDrawModeForceMode

(1_30_2022_0804以降)

Windows Vista以降で実行時でも、描画モードを変更できるようにします

$window.setDrawModeForceMode(mode);

• mode
   0: Vista以降ではsetDrawModeが効かなくなります（デフォルト）
   1: Vista以降でもsetDrawModeを効くようにします

※ $window.setDrawModeForceMode(1);を実行した後に、
  $window.setDrawModeが効くようになります

$window.sizeable

この値を1にすると、実行時にウィンドウの大きさをマウスによって変更できます

関連

• $screenWidth
• $screenHeight

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$windowX, $windowY

ウィンドウの位置を得たり、ウィンドウの移動を行います。

デスクトップ画面の左上が、メインウィンドウの左上に一致している場合、$windowX=0, $windowY=0 です。

例1

extends SpriteChar;

for (i=0; i<100; i++){
  $windowX=i;
  update();
}

▲ ウィンドウが右に移動します

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$windowActive

Tonyuがアクティブかを返します。

アクティブの時は1、非アクティブの時は0を返します。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

while

条件にしたがって、繰り返し処理を行います。

書式

while (条件) 手続き

条件に書かれた計算式の値が真である間は手続きを繰り返し実行し、偽である場合は繰り返しを終了します。

条件についてはif文を参照してください。

※ while文でだけ使われる特別な条件として、 while( 1 ) という形式があります。これは無条件に(永久に)繰り返す、という意味になります。

例1

オブジェクトを作成し、ダブルクリック後つぎのように入力します。

extends SpriteChar;
while(x<300) { 
  // x が 300より小さい（300より左にいる）場合、この中を実行
  x=x+1;
  update();
}

▲ 実行すると、オブジェクトが右に移動しますが、x = 300 の地点で消滅します。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$viewX, $viewY

$map.scrollToでスクロールした位置を得ます。

例1

ここに書いてあるプログラムは、
実行する前に画面にマップを描くことをおすすめします
(チュートリアル参照)

extends SpriteChar;
while(1) {
  $map.scrollTo(t,t);
  t+=1;
  x=$viewX+$mouseX;
  y=$viewY+$mouseY;
  update();
}

▲ この例を実行すると、画面が斜めにスクロールしますが、スクロール位置には関係なくマウスの位置にオブジェクトが現れます。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

変数

変数とは、数値や文字列などのデータを入れるためのものです。

• グローバル変数
  $screenWidth など、先頭が$ で始まる変数はグローバル変数です。 同じ名前のグローバル変数はシステムで１個しかありません。

• オブジェクト変数
  x など、先頭がアルファベットの変数は通常、オブジェクト変数です。 オブジェクト変数は、同じ名前でもオブジェクト毎に違う値を持ちます。

• ローカル変数(中級者向き)
  メソッドの定義内の引数および、メソッド内で次の書式で宣言された変数はローカル変数です。

書式

var 変数名, 変数名, ... ;

ローカル変数はそのメソッド内だけで有効です。
同じ名前のローカル変数でも、宣言されているメソッドが異なる場合、別の変数として扱われます。

また、あるメソッド内で、オブジェクト変数と同名のローカル変数を宣言した場合、
ローカル変数への参照を優先し、オブジェクト変数のほうはそのメソッド内で参照できなくなります。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

真偽

if文やwhile文などに用いられる条件式は、その条件が成立したか否かを表す必要があります。 条件が成立したときを真、成立していない場合を偽といいます。

Tonyuでは、すべての値が「真」または「偽」を表すようになっています。

• 真を表す値： 0以外の数値、オブジェクト(文字列も含む)
• 偽を表す値： 数値の0、null

例

• 5>3 : 真
• 1+1==3 : 偽
• x<10 : xが10未満の数値なら真、それ以外の場合は偽
• 1 : 真
• 0 : 偽
• "tonyu": 真

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

TimeStopperクラス

時間の停止を行います

使い方は、timeStopメソッドを参照してください。

メソッド一覧

TimeStopper.releaseAll

すべてのオブジェクトの時間停止を解除します。

書式

releaseAll(nonKill)

• nonKill
   nonKill=0またはnonKillを省略した場合、時間が止まっている間に、
   appearメソッドを用いて出現させたオブジェクトは すべて消滅する。
   nonKill=1なら消滅しない。

例1

例はtimeStopメソッドにあります。

TimeStopper.release

特定のオブジェクトの時間停止を解除します。

書式

release(o)

• o
   時間停止を解除するオブジェクト

戻り値

なし

例1

例はtimeStopメソッドにあります。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

this

thisは自分自身を表す特殊な変数です。

例1

extends SpriteChar;
while (1) {
  for (a in $chars) {
    if (a!= this && crashTo(a)) die();
  }
  update();
}

▲ このオブジェクトは、自分以外のオブジェクトに衝突すると、死亡します。
※ this=式 という形の代入はできません。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$TextEditorオブジェクト

$InputBoxより小型の、テキスト入力ウィンドウを表示します。

例1

extends SpriteChar;

$TextEditor.setPosition(10,10,200,100);
$TextEditor.setFont(11,"ＭＳ ゴシック");
$TextEditor.setText("何か入力してください");
$TextEditor.edit();
while($TextEditor.isEditing()) {
  update();
}
while (1) {
  drawText(x,y,$TextEditor.getText(),$clWhite);
  x++;
  update();
}

メソッド一覧

$TextEditor.setPosition

テキストエディタの表示位置と大きさを指定します

書式

setPosition(x, y, w, h)

• x
   左上のx座標
• y
   左上のy座標
• w
   幅
• h
   高さ

hを0にすると、1行のみエディット可能になります。高さはフォントの大きさにしたがって自動的に設定されます。
hを0より大きくすると、複数行のエディットが可能になります。

$TextEditor.setFont

エディット中に使うフォントを指定します

書式

setFont(size, name)

• size
   文字の大きさ
• name
   フォント名

$TextEditor.setText

テキストの内容を設定します

書式

setText(text)

• text
   テキストの内容

$TextEditor.edit

テキストエディタを表示し、編集を開始します

書式

edit()

$TextEditor.isEditing

テキストをエディット中かどうか判定します

書式

isEditing()

戻り値 エディット中なら真、エディット完了なら偽

$TextEditor.editを呼び出した直後から、エディタ以外の場所をクリックして
エディタが隠れるまでが「エディット中」とみなされます。

$TextEditor.getText

テキストの内容を読み出します 書式

getText()

戻り値 テキストの内容

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

TextCharクラス

TextCharクラスのオブジェクトは、文字を表示することができます。

変数

• x
   オブジェクトのx座標を表します。xの値が大きくなるほど右に移動します。
• y
   オブジェクトのy座標を表します。yの値が大きくなるほど下に移動します。 （※数学などでは、yが大きいほど上ですが、逆向きになります）
• text
   表示するテキストを設定します。
• col
   テキストの色を指定します。色はcolorメソッドや色定数を使って指定します
• size
   テキストの大きさを指定します。
• font
   フォント名を指定します。例："ＭＳ 明朝" "ＭＳ ゴシック"など
• bold
   1を指定すると太字になります。0で通常の書体です
• italic
   1を指定すると斜体になります。0で通常の書体です
• underLine
   1を指定すると下線付きになります。0で通常の書体です
• maxTextWidth
   この値が0以外の数値のとき、指定された幅を超えた文字列を改行して表示します。これを用いて複数行の文字列表示が可能です。
• zOrder
   この値が小さいほど文字が手前に表示されます。

メソッド

• edit
• PlainCharクラスのメソッド
• Spriteクラスのメソッド
• Objectクラスのメソッド

TextChar.edit

テキストを編集状態にします

書式

edit()

※複数行表示している場合でも1行のみのエディットになります

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$Systemオブジェクト

システムの終了などを行います。

メソッド一覧

$System.exit

Tonyu Systemを終了します

書式

exit()

例1

$System.exit();

$System.getVersion

Tonyu Systemのバージョンを取得します。

書式

$System.getVersion()

戻り値

バージョンを1000倍した値

$System.setFrameRate

フレーム（コマ）数とコマ落ちの設定を行います

書式

setFrameRate(rate, skip)

• rate
   1秒あたりのフレーム数
• skip
   最大フレームスキップ数

Tonyu起動時には、rateは60、skipは5となっています。

最大フレームスキップ数を大きくすると、処理が落ちた場合に描画の回数を 減らすことで、本来の処理速度を保とうとします。
小さくすると、処理が落ちた 場合に実際の速度が落ちますが、画面はなめらかになります。

例1

$System.setFrameRate(30,2);

$System.setStackSize

オブジェクトに割り当てるプロセスのスタックサイズを変更します。

書式

$System.setStackSize(sz)

• sz
   スタックサイズ

• Tonyu System起動時には、スタックサイズは1024となっています。

• スタックサイズの変更が有効になるのは、setStackSizeを実行後に初めてオブジェクトが作られた時です。

  • すでに作られているオブジェクトのスタックサイズは変更できません。
  • ページをまたいでもサイズの指定は有効です。

例1

extend SpriteChar;
$System.setStackSize(4096);
appear(new ConsumeMuchStackChar(x,y,p));

$System.setVSync

(1_29_2021_0501以降)

VSyncの有効・無効を設定します。

モニターの走査線を取得し、実行速度をミリ秒単位で微調整することでVSync(垂直同期)をします。

書式

setVSync(enable)

• enable
   1で有効、0で無効にします。

Tonyu起動時は、VSyncは有効になっています。

Windows 8以降やWindows Vista/7でAero有効の場合(*1)、 スタッタリング(*2)が軽減されます。
Windows XP以前では、ティアリング(*3)が目立たなくなります

*1）OSが自動的に垂直同期を行うので通常ティアリングが発生しなくなります
*2）スタッタリング (ドスパラの解説ページ)
*3）ティアリング (ドスパラの解説ページ)

$System.setAdjustScanLine

(1_29_2021_0501以降)

VSyncの基準位置(走査線)を調節します。

書式

setAdjustScanLine(rate)

• rate
   0～1の小数を指定して、VSyncの基準位置(走査線)を調節します。

Windows XP以前やWindows Vista/7でAero無効(クラシックテーマ)の場合、 ティアリング(*1)が発生するため、
ティアリングを目立たない位置にずらしたりするときに使います。

*1）ティアリング (ドスパラの解説ページ)

$System.setAutoAdjustScanLine

(1_29_2021_1212以降)

VSyncの基準位置(走査線)の自動調節機能を使うか設定します。

書式

setAutoAdjustScanLine(enable)

• enable
   0:無効、1:有効

Tonyu起動時は、Windows XP以前では有効、Windows Vista以降では無効になっています。

1フレームの描画にかかった時間をもとに、VSyncの基準位置(走査線)を自動調節します。
setAdjustScanLineと併用して使うと、「自動調節＋手動調整」がVSyncの基準位置となります。

$System.setTimerResolution

(1_29_2021_1212以降)

タイマー分解能を設定します。

書式

setTimerResolution(ms)

• ms
   1以上を指定します。（ミリ秒単位）

Tonyu起動時は、1ミリ秒で設定されています。

短い時間を指定すると、カクつきが軽減されたりFPSが安定するなどの効果があります。
Windows XP以前のPCでは、短い時間にするとCPU負担が大きくなります。
Windows XP以前のPCでCPU負担軽減を優先したい場合、設定を変更できます。

ただし、Kernel/MidiPlayer2.exeがあると1ミリ秒に設定されてしまいます。
MidiPlayer2.exeを削除する必要がありますが、Midi,Oggは再生できなくなります。

$System.setLoopMode

(1_29_2021_1212以降)

ゲームループの実行方式を設定します。

書式

setLoopMode(mode)

• mode
   0:ビジーループ、1:マルチメディアタイマー

Tonyu起動時は、マルチメディアタイマーで実行します。

• ビジーループ
  • sleep_timeが0の場合、カクつきは抑えられますが、CPU使用率は1スレッド分100%使います
  • sleep_timeが1以上の場合、CPU負担は抑えられますが、カクつきが発生しやすくなります
  • ウィンドウ操作中はゲームが止まります
• マルチメディアタイマー
  • CPU負担を抑えつつ、カクつきも抑えることができます
  • ウィンドウ操作中もゲームが動作し続けます

※ Tonyu1_28以前は、ビジーループで動作しています。マルチメディアタイマー動作にはできません。

$System.setProcessSingle

(1_30_2022_0804以降)

オブジェクト大量生成時に発生する、オブジェクト点滅や処理落ちを防ぐ機能の、
有効・無効を設定します。

書式

setProcessSingle(enable)

• mode
   1:有効、0:無効
   デフォルトは1で有効

※ 互換性の設定「オブジェクトを大量生成した際、点滅したり動作が遅くなる現象」を参照

$System.setSleepTimeMMT

(1_30_2022_0804以降)

※ 通常このメソッドを使用する必要はありません
  0設定でも十分にCPU負荷が低いため、基本的に使用する必要はありません
  1以上にするとFPSが低下しやすくなります

マルチメディアタイマー（$System.setLoopMode(1)）設定時のSleepTimeを設定します。

フレームごとにCPUをスリープする時間（単位：ミリ秒）を設定します。
「パフォーマンス」ウィンドウの「CPU負荷」をプログラムから動的に設定します。

書式

setSleepTimeMMT(ms)

• ms
   フレームごとにCPUをスリープする時間（単位：ミリ秒）を設定します。
   デフォルトは0です。

$System.setLegacyFrameRate

(1_30_2022_0804以降)

ver1.21～1.29のフレームレートを再現します。

• ver1.28以前は、FPSにずれがありました。
  • 例えば、フレームレートを60に設定しても、FPSが約62.5になっていました。
• ver1.29からはFPSが正確になりました。
• ver1.28以前のFPSを再現したい場合に設定します。

書式

setLegacyFrameRate(enable)

• enable
   0:無効（FPSが正確になる）
   1:有効（ver1.28以前のFPSのずれを再現します）
   デフォルトは0です。

※ 互換性の設定「FPSが約61～63になる現象」を参照

$System.setSpriteAngleAccuracy

(1_30_2022_0804以降)

スプライト描画の回転(angle)の精度を設定します

• ver1.29以前は、１回転(360°)で256段階（約1.4°ずつ角度が変わる）でした
• ver1.30以降は、１回転(360°)で36000段階（0.01°ずつ角度が変わる）となります
• default.tonyuprjのtargetVersion（無い場合はsavedVersion）によってデフォルトの精度が変わります
  • 1290以下の場合は、互換性のため256段階
  • 1300以上の場合は、36000段階
• 手動で精度を変えたい場合、このメソッドを使用します

書式

setSpriteAngleAccuracy(mode)

• mode
   0: １回転256段階
   1: １回転36000段階

※ 互換性の設定「スプライト描画の回転(angle)の精度」を参照

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

switch

変数の値によって、手続きを振り分けます。

書式

switch (変数) {
  case 値1:
    手続き1;
    break;
  case 値2:
    手続き2;
    break;
  ...
  default:
    手続きn;
}

変数に書かれた変数の値がcaseの値に一致する場合、その下の手続きを実行します。
breakに到達するとswitchの {}内から抜けます。

※ break を書き忘れると、条件が一致したcase以降の行も次々に実行されてしまうので、注意してください。

どの case にも一致しない場合、defaultの下の手続きが実行されます。

case はいくつも書くことができます。
default は一番下に１つだけ書くことができ、省略可能です。

例1

extends SpriteChar;
$SelectBox.open("何を買いますか？", "ここは武器屋です", "剣", "槍", "斧", "杖");
while (1) {
  select=$SelectBox.getStatus();
  switch (select) {
    case 0:
      text="選択中";
      break;
    case 1:
      text="剣を買いました";
      break;
    case 2:
      text="槍を買いました";
      break;
    case 3:
      text="斧を買いました";
      break;
    case 4:
      text="杖を買いました";
      break;
    default:
      text="何も買いませんでした";
  }
  drawText(10, 10, text, $clWhite, 20); // textの値を表示
  update();
}

▲ 選択ダイアログが表示され、以下の動作となります

• ボタンを押していない間は、selectが0となりcase 0:下の「text="選択中";」が実行されます
• 左から1番目のボタンを押すと、selectが1となりcase 1:の下、「text="剣を買いました";」が実行されます
• 左から2番目のボタンを押すと、selectが2となりcase 2:の下、「text="槍を買いました";」が実行されます
• 左から3番目のボタンを押すと、selectが3となりcase 3:の下、「text="斧を買いました";」が実行されます
• 左から4番目のボタンを押すと、selectが4となりcase 4:の下、「text="杖を買いました";」が実行されます
• ダイアログを×ボタンで閉じると、selectが-1となりcase文で書いてある0～4のいずれにも一致しないので、default:の下、「text="何も買いませんでした";」が実行されます

下記のif文と同じ動作になります。

extends SpriteChar;
$SelectBox.open("何を買いますか？", "ここは武器屋です", "剣", "槍", "斧", "杖");
while (1) {
  select=$SelectBox.getStatus();
  if (select == 0) {
    text="選択中";
  } else if (select == 1) {
    text="剣を買いました";
  } else if (select == 2) {
    text="槍を買いました";
  } else if (select == 3) {
    text="斧を買いました";
  } else if (select == 4) {
    text="杖を買いました";
  } else {
    text="何も買いませんでした";
  }
  drawText(10, 10, text, $clWhite, 20); // textの値を表示
  update();
}

例2

breakがcaseと対になっていない例です。
breakが無いとswitch文から即座に抜け出さないので、条件に一致したcaseから次々に処理が実行されてしまいますが、
その性質をあえて利用することもできます。

extends SpriteChar;
$SelectBox.open("何を買いますか？", "ここは売店です", "お茶", "ジュース", "高い弁当", "弁当");
while (1) {
  select=$SelectBox.getStatus();
  text="";
  switch (select) {
    case 0:
      text="選択中";
      break;
    case 1:
    case 2:
      text="飲み物を買いました";
      break;
    case 3:
      text="高級な";
    case 4:
      text=text+"弁当を買いました";
      break;
    default:
      text="何も買いませんでした";
  }
  drawText(10, 10, text, $clWhite, 20); // textの値を表示
  update();
}

▲ 選択ダイアログが表示され、以下の動作となります

• ボタンを押していない間は、selectが0となりcase 0:下の「text="選択中";」が実行されます
• 左から1番目と2番目のボタンを押した場合、どちらも「text="飲み物を買いました";」が実行されます
• 左から3番目のボタンを押すと、case 3:の下「text="高級な";」が実行されますが、break;は無いのでcase 4:の下「text=text+"弁当を買いました";」も実行されます
  「高級な弁当を買いました」と表示されます
• 左から4番目のボタンを押すと、case 4:の下、「text=text+"弁当を買いました";」が実行されます
  「弁当を買いました」と表示されます
• ダイアログを×ボタンで閉じると、selectが-1となりcase文で書いてある0～4のいずれにも一致しないので、default:の下、「text="何も買いませんでした";」が実行されます

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

Stringクラス

文字列を表すオブジェクトです

演算子

コンストラクタ

メソッド一覧

文字列結合

演算子 +を用いて、文字列と他の文字列を連結します

例1

extends SpriteChar;
a="山"
b="川";
c=a+"と"+b;
print(c);

▲ コンソールに"山と川" が表示されます"

例2

extends SpriteChar;
score=100+200;
print("score="+score);

▲ コンソールに"score=300" が表示されます。
この例のように、文字列と数値を連結することが可能です。

注意点

演算子 + は、両辺の値の種類によって意味が変わってきます。
次の例をためしてください。

例3

extends SpriteChar;
print("score="+100+200); // A
print("score="+(100+200)); // B
print(100+200+"=score"); // C

コンソールは次のように表示されます。

score=100200
score=300
300=score

動作をまとめると次のようになります。

• + の両辺のうち少なくとも一方が文字列の場合、演算の結果は文字列となる。文字列でないほうの値はその値の文字列表現に変換される。
• + の両辺が数値の場合、演算の結果は数値となる。数値同士の足し算を行う。
• + で連結された値が３つ以上ある場合、左から計算する。ただし括弧でくくられたものを先に計算する

上の例では次のような計算が行われています。

print("score="+100+200); // A

まず、"score="+100 を計算し、結果が"score=100"になる。
さらに"score=100"+200 を計算し、結果が"score=100200"になる。

print("score="+(100+200)); // B

まず、(100+200)を計算し、結果が300（数値）になる
さらに"score="+300 を計算し、結果が"score=300"になる。

print(100+200+"=score"); // C

まず、100+200を計算し、結果が300（数値）になる
さらに300+"=score" を計算し、結果が"300=score"になる。

文字列比較

==演算子を用いて、 文字列と他の文字列の内容が一致しているかを調べます

例1

extends SpriteChar;
a="abc";
if (a=="abc") print(a+" と abc は等しい");
else print(a+" と abc は等しくない");
if (a=="def") print(a+" と def は等しい");
else print(a+" と def は等しくない");

コンソールは次のように表示されます。

abc と abc は等しい
abc と def は等しくない

new String

キャラクタコードをあらわす数値から、文字列を作成します。

例1

a=new String(35);

▲ aの値は、キャラクタコード35の文字(#) からなる文字列 "#" になります。

String.byteLength

文字列のバイトデータの長さを得ます。

書式

byteLength()

戻り値

全角文字を2文字とした、文字列の長さ

lengthメソッドと似ていますが、全角文字を２文字として数えます。

String.substring

文字列の一部を抜き出します。

書式

substring(b,e)

• b
   抜き出し開始位置。先頭を0として、全角文字も１と数える
• e(省略可能)
   抜き出し終了位置。この位置の１文字手前までが抜き出される。省略した場合は最後まで

戻り値

b,eによって指定された範囲内の文字列を返します。

例1

メニューの「ウィンドウ」＞「コンソール」でコンソールウィンドウを表示し、さらに
メニューの「ウィンドウ」＞「テスト実行」で表示されるウィンドウに次のように入力し
F9をおします

a="105円です";
b=a.substring(2); 
c=a.substring(2,4);
print(b);
print(c);

▲ コンソールは次のように表示されます。

5円です
5円

String.length

文字列の長さを得ます。

書式

length()

戻り値

文字列の長さ

全角文字も1文字として数えます。
全角文字を2文字として扱いたい場合、byteLengthメソッドを用います

例1

メニューの「ウィンドウ」＞「コンソール」でコンソールウィンドウを表示し、さらに
メニューの「ウィンドウ」＞「テスト実行」で表示されるウィンドウに次のように入力し
F9をおします

a="Tonyuシステム";
print("「"+a+"」は"+a.length()+"文字です");

▲ コンソールには次のように表示されます。

「Tonyuシステム」は9文字です

注意

次のように文字定数に直接.length()をつけることはできません

"Tonyu".length(); // エラー

String.byteSubstring

substringと似ていますが、全角文字を2文字として数えます。

書式

byteSubstring(b,e)

• b
   抜き出し開始位置。先頭を0として、全角文字を2と数える
• e(省略可能)
   抜き出し終了位置。この位置の１文字手前までが抜き出される。省略した場合は最後まで

戻り値

b,eによって指定された範囲内の文字列を返します。

String.byteAt

文字列のバイトデータの特定の場所におけるキャラクタコードを得ます。

書式

byteAt(n)

• n
   位置

戻り値

strのバイトデータにおける、nバイト目のキャラクタコード

String.charAt

文字列からiバイト目のキャラクタコードをぬきだします

書式

charAt(i)

• i
   文字列のインデックス。0が先頭、全角文字は2文字と数える

戻り値

iバイト目のキャラクタコード

byteAtと同じ動作をします。

"1文字"だけを抜き出す場合は

s.substring(i,1)

を使います。

String.split

カンマ(",")などで区切られた文字列("abc,def,efg"など)を配列に分解します。

書式

split(separator,limit)

• separator(省略可能)
   区切りに使う文字列。省略すると、文字列strをカンマ (",")で区切ります。
• limit(省略可能)
   limitで指定された個数を超える要素をもつ配列を生成しません。省略すると個数に制限はありません。

例1

メニューの「ウィンドウ」＞「コンソール」でコンソールウィンドウを表示してください

extends SpriteChar;
a="abc,de!f,ghi";
print(a+"を , で区切ります");
b=a.split();
for (e in b) {
  print(e);
}
print(a+"を ! で区切ります");
b=a.split("!");
for (e in b) {
   print(e);
}
print(a+ "を , で区切ります(要素数は2つまで)。");
b=a.split("," ,2);
for (e in b) {
   print(e);
}

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

SpriteCharクラス

SpriteCharクラスのオブジェクトは、ビットマップグラフィックスを表示することができます。

変数

• x
   オブジェクトのx座標を表します。xの値が大きくなるほど右に移動します。
• y
   オブジェクトのy座標を表します。yの値が大きくなるほど下に移動します。 （※数学などでは、yが大きいほど上ですが、逆向きになります）
• f
   fに１を代入すると、キャラクタパターンの左右を反転します。0を設定すると反転をやめます。
• zOrder
   この値が小さいほど文字が手前に表示されます。

メソッド一覧

• newAnimation
• PlainCharクラスのメソッド
• Spriteクラスのメソッド
• Objectクラスのメソッド

SpriteChar.newAnimation

新規AnimationAdaptorを作成します。

書式

newAnimation()

戻り値

新規作成されたAnimationAdaptor

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

Spriteクラス

画面上に出現するすべてのオブジェクト(PlainCharクラス)の親クラスです。描画命令などが定義されています

メソッド一覧

Sprite.textWidth

テキストの横幅を取得します

書式

textWidth(t,s)

• t
   テキストの内容
• s
   テキストサイズ(pt)

戻り値

テキストtをサイズsで書いた場合の幅

Sprite.textHeight

テキストの縦幅（高さ）を取得します

書式

textHeight(t,s)

• t
   テキストの内容
• s
   テキストサイズ(pt)

戻り値

テキストtをサイズsで書いた場合の高さ

Sprite.setFont

drawTextメソッドで描画する文字フォントを指定します。

書式

setFont(name,bold,italic,underLine)

• name
   フォント名
• bold(省略可能)
   太字にする場合は1、そうでない場合0にするか省略する
• italic(省略可能)
   斜体にする場合は1、そうでない場合0にするか省略する
• underLine(省略可能)
   下線つきにする場合は1、そうでない場合0にするか省略する フォント名と指定できる文字列は
   "ＭＳ 明朝" "ＭＳ ゴシック" などです。ＭＳと明朝の間は半角スペースです

例1

extends SpriteChar;
while (1) {
  setFont ("ＭＳ 明朝",0,1);
  drawText(x,y-30,"フォントが変わりました",$clWhite);
  update();
}

▲ オブジェクトの上に明朝体、斜体で"フォントが変わりました"を表示します。
なお、実行開始時は"ＭＳ Ｐゴシック"、太字、斜体、下線すべてなしに設定されます

Sprite.drawText

文字を描画します。

書式

drawText(x,y,text,col,size,zOrder)

• x
   x座標
• y
   y座標
• text
   描画する値
• col
   色(通常colorメソッドで指定)
• size(省略可能)
   サイズ
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

例1

extends SpriteChar;
i=0;
while (1) {
  drawText(x,y-30,"Time",$clWhite);
  drawText(x,y-10,i,$clWhite);
  i=i+1/60;
  update();
}

▲ オブジェクトの頭上に1秒に1だけ増えるタイマーが表示されます

※ drawTextで描いた図形は、次のフレームを描画する前に消去されます。
必ず毎回(updateが呼ばれるたびに)drawTextを実行してください。

次のような例だと、一瞬だけ表示されてすぐ消えてしまいます。

例2

悪い例：

extends SpriteChar;
drawText(x,y-30,"Time",color); // 最初の1フレームしか表示されない
i=0;
while (1) {
  drawText(x,y-10,i,color);
  i=i+1/60;
  update();
}

Sprite.drawLine

直線を描画します

書式

drawLine(sx,sy,dx,dy,col,zOrder)

• sx
   始点のx座標
• sy
   始点のy座標
• dx
   終点のx座標
• dy
   終点のy座標
• col
   色(通常colorメソッドで指定)
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawBrokenLine

点線を描画します

書式

drawBrokenLine(sx,sy,dx,dy,col,zOrder,length)

• sx
   始点のx座標
• sy
   始点のy座標
• dx
   終点のx座標
• dy
   終点のy座標
• col
   色
• zOrder
   描画順序(小さいほど手前に描画される)
• length
   点線1個の長さ

Sprite.fillRect

中の詰まった長方形を描画します

書式

fillRect(sx,sy,dx,dy,col,zOrder)

• sx
   左上点のx座標
• sy
   左上点のy座標
• dx
   右下点のx座標
• dy
   右下点のy座標
• col
   色(通常colorメソッドで指定)
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawSprite

スプライトを描画します。

書式

drawSprite(x,y,p,f,zOrder)

• x
   x座標
• y
   y座標
• p
   キャラクタパターン
• f(省略可能)
   0でない数値の場合、元のキャラクタパターンを左右反転したパターンを描画する
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

通常、オブジェクトに対して自動的にスプライトが描画されますが(updateメソッド参照)、
１つのオブジェクトで複数のスプライトを描画したいときに使用します。

例1

extends SpriteChar;
while (1) {
  drawSprite(50,50,21);
  x=100;y=100;p=5;
  update();
}

▲ このようにすると、update();により、自動的に(100,100)の位置に青い丸(パターン番号21)がかかれる他に、
drawSpriteによって(50,50)の位置に 青い丸(パターン番号21)がかかれます。

drawSpriteを使った場合、x,y,pの値に関係なく任意の場所に任意のパターンを描画できます。

※ drawSpriteはupdate()をするたびに毎回呼び出してください。 次のような例だと、一瞬だけ表示されてすぐ消えてしまいます。

例2

悪い例：

drawSprite(50,50,21);  // 最初の1フレームしか表示されない
while (1) {
  x=100;y=100;p=5;
  update();
}

Sprite.getPatWidth

キャラクタパターンの大きさ（幅）を取得します。

書式

getPatWidth(p)

• p
   キャラクタパターン番号

戻り値

p の大きさ（幅）

Sprite.getPatHeight

キャラクタパターンの大きさ（幅）を取得します。

書式

getPatHeight(p)

• p
   キャラクタパターン番号

戻り値

p の大きさ（高さ）

Sprite.drawMapSprite

未稿

書式

drawMapSprite()

Sprite.drawDxSprite

回転、拡大、縮小、半透明のスプライトを描画します。

書式

drawDxSprite(x,y,p,f,zOrder,angle,alpha,scaleX,scaleY)

• x
   x座標
• y
   y座標
• p
   キャラクタパターン
• f
   0でない数値の場合、元のキャラクタパターンを左右反転したパターンを描画する
• zOrder
   描画順序。値が小さいほど手前に描画される
• angle
   回転角度。単位は度(°)を表す整数
• alpha
   不透明度を0から255の整数であらわす。小さい値ほど透けて見える
• scaleX
   横方向の拡大率。１が原寸
• scaleY(省略可能)
   縦方向の拡大率。省略するとscaleXと同じ

例1

extends SpriteChar;
p=-1;
while (1) {
  drawDxSprite(50,50,4,0,0,i,128,2);
  i=(i+1) % 360;
  update();
}

▲ このようにすると、回転する立方体が見えます。

Sprite.drawPolygon

正多角形を描画します。

書式

drawPolygon(x,y,number,size,col,ang,zOrder)

• x
   正多角形の中心のx座標
• y
   正多角形の中心のy座標
• number
   頂点・辺の数（正number角形を描画します）
• size
   中心から頂点までの距離
• col
   色(通常colorメソッドで指定)
• ang
   回転角度
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawScreenXY

各種描画命令において、座標系にスクリーン座標を使うか、ワールド座標を使うかを指定します。

書式

drawScreenXY(sc)

• sc
   0=ワールド座標を使う 1=スクリーン座標を使う

主に、画面がスクロールするゲームにおいて、
スコア表示など特定のオブジェクトを スクロールさせたくない場合に用います。

オブジェクトをスクロールにあわせて動かないようにするには次のようなメソッドを定義します。

例1

extends TextChar;
function draw() {
  drawScreenXY(1);
  super.draw();
  drawScreenXY(0);
}
x=100;
y=20;
text="Score : 0";
wait();

▲ このオブジェクトはスクロールしても必ず画面上の(100,20)の位置にあります

drawScreenXYメソッドは、drawSprite、drawDxSprite、drawText、drawLine、fillRectの各メソッドにおける引数xとyに機能します。

ワールド座標を用いた場合、(x,y)の値をワールド座標として解釈します。この場合スクロールした位置により画面上の表示位置が変化します。
スクリーン座標を用いた場合、スクロールしても画面上の位置は変化しません。
スクリーン座標、ワールド座標についてはスクロールのサンプルを参照してください。

Sprite.centerText

指定された座標が中心になるように文字を描画します。

書式

centerText(x,y,text,col,size,zOrder)

• x
   テキストの中心のx座標
• y
   テキストの中心のy座標
• text
   描画する値
• col
   色(通常colorメソッドで指定)
• size(省略可能)
   文字のサイズ
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawVerticalText

縦書きの文字を描画します。

書式

drawVerticalText(x,y,text,col,size,zOrder)

• x
   テキストの中心のx座標
• y
   テキストの中心のy座標
• text
   描画する値
• col
   色(通常colorメソッドで指定)
• size(省略可能)
   サイズ
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawRect

中空の四角形を描画します。

書式

drawRect(sx,sy,dx,dy,col,zOrder)

• sx
   左上の頂点のx座標
• sy
   左上の頂点のy座標
• dx
   右下の頂点のx座標
• dy
   右下の頂点のy座標
• col
   色(通常colorメソッドで指定)
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawRectDx

中空の四角形を描画します。回転が可能です

書式

drawRectDx(sx,sy,dx,dy,col,angle,zOrder)

• sx
   中心のx座標
• sy
   中心のy座標
• dx
   幅
• dy
   高さ
• col
   色(通常colorメソッドで指定)
• angle
   回転角度
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.drawTriangle

指定された座標が中心になるように文字を描画します。

書式

drawTriangle(ax,ay,bx,by,cx,cy,col,angle,zOrder)

• ax
   頂点Aのx座標(※)
• ay
   頂点Aのy座標(※)
• bx
   頂点Bのx座標(※)
• by
   頂点Bのy座標(※)
• cx
   頂点Cのx座標(※)
• cy
   頂点Cのy座標(※)
• col
   色(通常colorメソッドで指定)
• angle(省略可能)
   回転角
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

(※) : angle=0 のときの座標です。angleの値に応じて、右回転します。

Sprite.gradationLine

グラデーション付きの直線を描画します

書式

gradationLine(sx,sy,dx,dy,cols,cold,zOrder)

• sx
   始点のx座標
• sy
   始点のy座標
• dx
   終点のx座標
• dy
   終点のy座標
• cols
   始点の色(通常colorメソッドで指定)
• cold
   終点の色(通常colorメソッドで指定)
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.gradationRect

グラデーションつき長方形を描画します

書式

gradationRect(sx,sy,dx,dy,type,cols,cold,zOrder)

• sx
   左上点のx座標
• sy
   左上点のy座標
• dx
   右下点のx座標
• dy
   右下点のy座標
• type
   0 - 左→右にグラデーションをかける
   1 - 上→下にグラデーションをかける
• cols
   左端（上端）の色(通常colorメソッドで指定)
• cold
   右端（下端）(通常colorメソッドで指定)
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.gradationText

グラデーションつき文字を描画します。

書式

gradationText(x,y,text,colL,colR,size,zOrder)

• x
   x座標
• y
   y座標
• text
   描画する値
• colL
   左端の色(通常colorメソッドで指定)
• colR
   右端の色(通常colorメソッドで指定)
• size(省略可能)
   サイズ
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される

Sprite.fillPolygon

多角形を描画し，塗りつぶします。

書式

fillPolygon(x,y,points,color,zOrder)

• x
   基準点のx座標
• y
   基準点のy座標
• points
   頂点の数
• col
   色(通常colorメソッドで指定)
• zOrder(省略可能)
   描画順序。値が小さいほど手前に描画される 各点の座標は、Sprite.setPolygonで指定します。

extends SpriteChar;
setPolygon(0,-50,0);
setPolygon(1,50,-30);
setPolygon(2,30,130);
$panel.fillPolygon(x,y,3,$clRed);
while (1) {
  for (i=0; i<6; i++) {
    sz=100;
    setPolygon(i,sin(i*60+x)*sz,cos(i*60+x)*sz);
  }
  fillPolygon(x,y,6,$clGreen,zOrder);
  fillPolygon(x+30,y+30,6,$clBlack,zOrder+1);
  x++;
  update();
}

Sprite.setPolygon

Sprite.fillPolygon における頂点を指定します。

書式

setPolygon(seq,x,y)

• seq
   点番号。seq==0,1,2... の順に点を結んで多角形を描画する。最大99
• x
   点の x 座標
• y
   点の y 座標

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$SelectBoxオブジェクト

選択肢を表示するダイアログボックスです

※ waitSelectも参考にしてください。

例1

extends TextChar;
$SelectBox.open("何を買いますか？", "ここは武器屋です", "剣", "槍", "斧", "杖");
while (1) {
  select=$SelectBox.getStatus();
  if (select==0) text="選択中";
  else if (select==1) text="剣を買いました";
  else if (select==2) text="槍を買いました";
  else if (select==3) text="斧を買いました";
  else if (select==4) text="杖を買いました";
  else if (select==-1) text="何も買いませんでした";
  update();
}

メソッド一覧

$SelectBox.open

はい・いいえ選択用ダイアログボックスを開きます。

書式

open(prompt,title,st1,st2,st3,st4) 

• prompt
   メッセージ
• title
    タイトルバーの文字列（省略すると"確認")
• st1
    1個目のボタンの文字列 （省略すると"はい")
• st2
    2個目のボタンの文字列 （省略すると"いいえ")
• st3
    3個目のボタンの文字列 （省略すると表示しない)
• st4
    4個目のボタンの文字列 （省略すると表示しない)

waitSelectと異なり、ボタンが押されるまで処理を中断しません。

どのボタンが押されたか$SelectBox.getStatusで調べます。

$SelectBox.getStatus

はい・いいえ選択用のウィンドウの状態を調べます

書式

getStatus() 

戻り値

-1：ダイアログを閉じた
0：まだボタンを選択していない（選択中）
1：左から1番目のボタンを選択した
2：左から2番目のボタンを選択した
3：左から3番目のボタンを選択した
4：左から4番目のボタンを選択した

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

SecretCharクラス

SecretCharクラスのオブジェクトは、実行中は表示されません。（設計時には表示されます）

使える変数はSpriteCharと同じです。これらは実行中には意味をもちません。 設計時に表示する位置やキャラクタパターンを指定するためにあります。

メソッド一覧

PlainCharクラスのメソッドが使えます。

変数一覧

SecretChar.pat

設計時に表示されるキャラクタパターンです。実行時は意味を持ちません。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$screenWidth, $screenHeight

ウィンドウの幅や高さを取得・設定できます。

• $screenWidth
   ウィンドウの幅を返します。代入すると幅が変わります。
• $screenHeight
   ウィンドウの高さ（縦幅）を返します。代入すると高さが変わります。

関連

• $window.sizeable

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

return

メソッドの定義の途中で、メソッドの処理を終了します。

書式

return 戻り値;

戻り値は、メソッドを呼び出した側に返される値です。(省略可能)

例1

extends SpriteChar;
function inRect(sx,sy,dx,dy) {
  if (x>=sx && y>=sy && x<=dx && y<=dy) return 1;
  return 0;
}
t=200;
while (1) {
if (getkey(39)>0) x+=3;
   if (getkey(37)>0) x-=3;
   if (getkey(40)>0) y+=3;
   if (getkey(38)>0) y-=3;
   t+=0.1;
   fillRect(t,200,t+100,300,$clRed);
   if ( inRect( t,200,t+100,300)==1 ) die();
   update();
}

▲ カーソルキーで移動しますが、赤枠のなかに入ると消滅します。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$rankingオブジェクト

ネットランキングCGIの呼び出しを行います

メソッド一覧

$ranking.openBrowser

メニューの「ウィンドウ」＞「ネットランキング」で指定したURLを開きます。

書式

openBrowser()

$ranking.setParam

ランキングCGIに渡すパラメータを設定します。

書式

setParam(name,value)

• name
   パラメータ名
• value  値

ネットランキングの詳しい設置法は、チュートリアルを参照してください

nameで指定される名前のパラメータに 値value を設定します。 valueには文字列または数値を指定します。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

RadioButtonクラス

ラジオボタンを作成します

例1

extends RadioButton; //必ずRadioButtonを親クラスにしてください。
a=new Array();
a.add("OFF");a.add("OFF");a.add("OFF");a.add("OFF");a.add("OFF");a.add("OFF");
init(3,3);
while(1) {
  if (create(300,120,0,0,3,$clBlack)==1) a.set(0,"ON");else a.set(0,"OFF");
  if (create(300,140,0,1,3,$clRed)==1) a.set(1,"ON");else a.set(1,"OFF");
  if (create(300,160,0,2,3,$clGreen)==1) a.set(2,"ON");else a.set(2,"OFF");
  if (create(350,120,1,0,3,$clYellow)==1) a.set(3,"ON");else a.set(3,"OFF");
  if (create(350,140,1,1,3,$clPink)==1) a.set(4,"ON");else a.set(4,"OFF");
  if (create(350,160,1,2,3,$clWhite)==1) a.set(5,"ON");else a.set(5,"OFF");
  drawText(320,120,a.get(0),$clBlack,10);
  drawText(320,140,a.get(1),$clBlack,10);
  drawText(320,160,a.get(2),$clBlack,10);
  drawText(370,120,a.get(3),$clBlack,10);
  drawText(370,140,a.get(4),$clBlack,10);
  drawText(370,160,a.get(5),$clBlack,10);
  update();
}

メソッド一覧

RadioButton.init

ラジオボタン作成の準備をします

書式

init(group,number)

• group
   作成するグループの数
• number
   1グループに存在するラジオボタンの最大数

RadioButton.create

ラジオボタンを作成します

書式

create(x,y,group,number,maxNumber,color,zOrder)

• x
   ラジオボタンのx座標
• y
   ラジオボタンのy座標
• group
   グループID (0-N) N=initで指定したグループの個数-1
• number
   グループ内の通し番号 (0 - maxNumber-1)
• maxNumber
   グループ内にあるラジオボタンの個数(0-N) N=initにおける、group-1
• color
   色
• zOrder
   表示順序

作成前に必ずinitメソッドを呼んでください

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$projectManagerオブジェクト

ページの読み込みを行います

メソッド一覧

$projectManager.loadPage

他のページを読み込みます。

書式

loadPage(page)

• page
   読み込むページ

pageに指定するのは、プロジェクトマネージャに表示されるページ名です。
例えば、図1のように表示されている場合、$page_index, $page_stage2,$page_startのいずれかを指定します。

例1

$projectManager.loadPage($page_index);

▲ 図1で赤く囲ったページ($page_index)を読み込みます。

※ loadPageメソッド実行後、次にupdate、updateEx、waitの いずれかのメソッドが呼ばれるまでは、移動前のページで処理が続行します。

※ ページを切り替えたときにBGMを止めない方法

$Options.set("sound_stopOnPageLoad", 1);

参照： $Options.setメソッド

$projectManager.getCurrentPageName

現在開いているページの名前を得ます。

書式

getCurrentPageName() 

戻り値

現在開いているページの名前をあらわす文字列

例1

extends TextChar;
text="現在のページ名は"+$projectManager.getCurrentPageName()+"です";
wait();

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

PlainCharクラス

画面上に表示されるオブジェクト(SpriteChar、DxChar、TextChar、SecretChar)の親クラスです。

これら4種類のオブジェクトに共通な変数やメソッドが用意されています。

このページで示したものの他にも、Spriteクラスのメソッド（描画命令）も使えます。併せて参照してください。

メソッド一覧

変数一覧

PlainChar.onMouseDown

オブジェクト上でマウスが押されたときに特別な処理をしたいときにユーザが定義するメソッドです。

書式

function onMouseDown(x,y,lb,rb) {
  処理内容
}

• x
   マウスカーソルのx座標（ウィンドウの左端が0)
• y
   マウスカーソルのy座標（ウィンドウの上端が0)
• lb
   左ボタンがおされていれば1,そうでなければ0
• rb
   右ボタンがおされていれば1,そうでなければ0

※ onMouseDownはユーザが直接呼び出さないでください。

※ このメソッドの中でupdateメソッドを呼ばないようにしてください

PlainChar.onMouseDownForDesign

未稿

書式

onMouseDownForDesign()

PlainChar.onMouseDrag

マウスボタンが押された状態で、オブジェクト上でマウスが動いたときに特別な処理をしたいときにユーザが定義するメソッドです。

書式

function onMouseDrag(sx,sy,dx,dy,lb,rb) {
  処理内容
}

• sx
   移動前のマウスカーソルのx座標（ウィンドウの左端が0)
• sy
   移動前のマウスカーソルのy座標（ウィンドウの上端が0)
• dx
   移動後のマウスカーソルのx座標（ウィンドウの左端が0)
• dy
   移動後のマウスカーソルのy座標（ウィンドウの上端が0)
• lb
   左ボタンがおされていれば1,そうでなければ0
• rb
   右ボタンがおされていれば1,そうでなければ0

onMouseDragはユーザが直接呼び出さないでください。

※ onMouseDragの中でupdateメソッドを呼ばないようにしてください

PlainChar.crashTo

他のオブジェクトと衝突しているかどうかを判定します。

書式

crashTo(t)

• t
   判定対象のオブジェクト

戻り値

tと衝突していれば真(0以外の値)、そうでなければ偽(0)

例1

extends SpriteChar;
while(1) {
  if (crashTo($Teki)) die();
  update();
}

▲ $Tekiとぶつかっていたら、die()メソッドを呼び、このオブジェクトが死にます。

※ crashToは自分で定義することもできます。
これを利用して、当たり判定の大きさの調整などができます。

例2

extends SpriteChar;
function crashTo(t) {
  return dist(t.x-x,t.y-y)<50;
}
while(1) {
  if (crashTo($Teki)) die();
  update();
}

▲ この例では、他のオブジェクト(t)との距離が50未満のときにcrashToは真に（このオブジェクトとtがぶつかった）なります。

関連

• for (xx in $chars)

PlainChar.crashToLine

オブジェクトと線分の衝突判定を行います。

書式

crashToLine(sx,sy,dx,dy,width,xx,yy)

• sx
   始点のx座標
• sy
   始点のy座標
• dx
   終点のx座標
• dy
   終点のy座標
• width
   線分の幅
• xx(省略可能)
   判定する点のx座標。省略するとオブジェクトのxの値
• yy(省略可能)
   判定する点のy座標。省略するとオブジェクトのyの値

戻り値

(sx,sy)と(dx,dy)を結ぶ、幅がwidthドットの線分と点(xx,yy)がぶつかっていれば 真(0でない値)。そうでなければ偽 (0)

※ (sx,sy)と(dx,dy) が一致してしまうとエラーになります

例1

LineRoll.tonyu

extends SpriteChar;
a=0;
while (1) {
  sx=x+cos(a)*100;
  sy=y+sin(a)*100;
  drawLine(x,y,sx,sy,$clWhite);
  update();
  a+=rnd(10);
}

Jiki.tonyu

extends SpriteChar;
while(1) {
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3; 
  if (getkey(40)>0) y+=3;
  if (getkey(38)>0) y-=3;
  if (crashToLine($LineRoll.x,$LineRoll.y,$LineRoll.sx,$LineRoll.sy,10)) {
    die();
  }
  update();
}

PlainChar.crashAt

未稿

書式

crashAt()

PlainChar.onDraw

オブジェクトに描画をするときに、特別な処理をする場合にユーザが定義するメソッドです。

書式

function onDraw() {
  処理内容
}

onDrawはユーザが直接呼び出さないでください。

※ このメソッドの中でupdateメソッドを呼ばないようにしてください

例1

function onDraw() {
  drawText(x,y-30,"Text",$clWhite);
}

▲ このようにすると、オブジェクトの上にTextという文字が表示されまず。
(設計中でも表示されます)

※ このメソッド内部でエラーが起きると、設計時にオブジェクトが正しく表示されなくなります。
その場合は、onDrawの部分を注釈にするなどして、表示の問題を回避してください。

PlainChar.draw

未稿

書式

draw()

PlainChar.onUpdate

updateメソッド、updateExメソッドが呼び出されたときに特別な処理をしたいときにユーザが定義するメソッドです。

書式

onUpdate()

※ onUpdateはupdateメソッドから自動的に呼ばれます。ユーザが直接呼び出さないでください。

※ このメソッドの中でupdateメソッドを呼ぶことが可能です。但しその場合onUpdateが重複して呼ばれることはありません。

例1

function onUpdate() {
  drawText(x,y-10,"Text",color(255,255,255));  
}

▲ このように定義しておくと、オブジェクトの上にTextという文字が書かれるようになります。

PlainChar.update

オブジェクトの書き換え処理を行います。

書式

update()

updateは１フレーム（コマ）が終了する毎に必ず呼び出してください。

通常のスプライトオブジェクトは、updateが呼ばれた時点で、次にあげる変数の内容にしたがってスプライトが描画されます。

• x
   x座標
• y
   y座標
• p
   キャラクタパターン
• f
   0でない数値の場合、元のキャラクタパターンを左右反転したパターンを描画する
• zOrder
   このスプライトの表示順序を決める。描画時に、この値の小さいスプライトが手前にくるように描画される。

PlainChar.updateEx

updateメソッドを指定した回数分実行します。これにより、指定したフレーム数だけ待機することができます。

書式

updateEx(t)

• t
   update(); を呼び出す回数。

※ この命令はwaitメソッドと似ていますが、 updateExの実行中はフレーム毎にonUpdateメソッドが呼ばれます。

PlainChar.onDie

オブジェクトが死んだときに特別な処理をしたいときにユーザが定義するメソッドです。

書式

function onDie() {
  処理内容
}

※ onDieは自動的に呼ばれます。ユーザが直接呼び出さないでください。

※ onDieの中でupdateメソッドを呼ばないようにしてください

例1

function onDie() {
  $score=$score+10;
}

▲ このように定義しておくと、このオブジェクトが死ぬ度に$scoreが10増えます。

PlainChar.die

オブジェクトを殺します。殺されたオブジェクトは次にupdate();が呼ばれた段階で処理を終了し、画面上から消えます。

書式

die()

例1

die();

▲ 自分自身が死にます

例2

$teki.die();

▲ オブジェクト$tekiが死にます

PlainChar.isDead

オブジェクトが死んでいるかどうかを判定します。

書式

isDead()

戻り値

死んでいる場合は真(0以外の値)、そうでなければ偽(0)

※ このメソッドは1.09以前では isDied という名前でした。今後はisDeadを使用してください。
互換性を保つため、isDied を使用したプログラムも従来通り動作するようになっています。

dieメソッドが呼ばれるか、プログラムの最後に到達すると そのオブジェクトは死んだとみなされます、

例1

Object1.tonyu

extends SpriteChar;
i=0;
while (i<100) {
  i+=1;update();
}

Object2.tonyu

extends SpriteChar;
while (! $Object1.isDead()) {
  x+=1; update();
}

▲ この例では、$Object1は100フレームたつとプログラムが終了し、死にます。
$Object2は$Object1が死ぬのを監視しながら、$Object1が死んでない間移動を続け $Object1が死ぬと一緒に死にます。

PlainChar.wait

オブジェクトの動作を一時的に停止し、待機状態にします。

書式

wait(frames)

• frames(省略可能)
   待機するフレーム数。省略するとnotify()が呼ばれるまで永久に待機する。

例1

extends SpriteChar;
while(1) {
  x+=8;
  wait(8);
}

▲ 8フレームに1回、8ドット横に移動します。

updateExメソッドとの違い

• 待機中はonUpdateメソッドは呼ばれません
• スレッドの処理順を表すリストから一時的にこのオブジェクトのスレッドを除外し，再開時にこのオブジェクトのスレッドをリストの末尾に追加します．
• したがって，updateExより処理が軽くなりますが，処理順が変化する点に注意してください．

PlainChar.notify

waitメソッドで待機状態にあるオブジェクトの動作を再開します。

書式

notify()

例1

WaitObj.tonyu ($waitObj)

extends SpriteChar;
wait();
while(1) {
  x+=8;
  wait(8);
}

NotifyObj.tonyu ($notifyObj)

extends SpriteChar;
while(getkey(32)==0) {
  update();
}
$waitObj.notify();

▲ $waitObjは、プログラム開始時にwait()によって待機状態になります。
スペースキーを押すと、$notifyObjが$waitObjに対してnotify() を呼び、 $waitObjの動作が始まります。

PlainChar.setVisible

オブジェクトの表示・非表示を設定します。

書式

setVisible(v)

• v
   0= 非表示、 1= 表示

例1

extends SpriteChar;
while(1) {
  setVisible(0);
  update();
  setVisible(1);
  update();
}

▲ オブジェクトが高速に点滅します

PlainChar.getVisible

オブジェクトの表示・非表示状態を取得します。

書式

getVisible()

戻り値

0: 非表示、 1以外: 表示

参考

setVisible

PlainChar.screenOut

オブジェクトが画面外に出たかどうかを判定します。

書式

screenOut()

戻り値

画面外に出ていない場合は0、 画面外に出ている場合は0より大きい値を返す。
その値は x方向にはみだしたドット数＋y方向にはみだしたドット数

例1

extends SpriteChar;
while(1) {
  if (screenOut()>0) die();
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3;
  if (getkey(40)>0) y+=3;
  if (getkey(38)>0) y-=3;
  update();
}

▲ カーソルキーでオブジェクトを動かしていくと、画面外に出た瞬間に死亡します
なお、 if (screenOut()>0) die(); は if (screenOut()) die(); と書いても同じ動作をします。

PlainChar.getScreenX

オブジェクトのスクリーン座標のx座標を得ます。

書式

getScreenX()

戻り値

スクリーン座標(x座標)

※スクリーン座標についてはスクロールのサンプルを参考してください。

例1

ここに書いてあるプログラムは、実行する前に画面にマップを描くことをおすすめします(チュートリアル参照)

extends SpriteChar;
while(1) {
  if (getkey(39)>0 && getScreenX()<$screenWidth-16) x+=3;
  if (getkey(37)>0 && getScreenX()>16) x-=3; 
  if (getkey(40)>0 && getScreenY()<$screenHeight-16) y+=3;
  if (getkey(38)>0 && getScreenY()>16) y-=3;
  $map.scrollTo(0,t);
  y-=1;
  t-=1;
  update();
}

▲ この例では、カーソルキーでオブジェクトを動かしますが、 スクロール位置に関係なく画面端を飛び出さないようにします。
※試しにgetScreenY()をyに変えてみると、しばらくすると上に動けなくなります。

PlainChar.getScreenY

オブジェクトのスクリーン座標のy座標を得ます。

書式

getScreenY()

戻り値

スクリーン座標(y座標)

※スクリーン座標についてはスクロールのサンプルを参考してください。

例1

getScreenX参照

PlainChar.gotoScreen

オブジェクトの位置をスクリーン座標を用いて指定します。

書式

gotoScreen(xx,yy)

• xx
   移動先x座標（スクリーン座標）
• yy
   移動先y座標（スクリーン座標）

※スクリーン座標についてはスクロールのサンプルを参考してください。

例1

ここに書いてあるプログラムは、実行する前に
画面にマップを描くことをおすすめします(チュートリアル参照)

extends SpriteChar;
sx=x;sy=y;
while (1) {
  gotoScreen(sx,sy);
  $map.scrollTo(0,t);
  t-=1;
  update();
}

▲ この例では、プログラム開始時の位置をsx,syに覚えた後、 その場にとどまりつづけます。 スクロールしても画面上での位置は変わりません

PlainChar.onAppear

実行開始時またはappearメソッドによりオブジェクトが出現したときに、
特別な処理をする場合にユーザが定義するメソッドです。

書式

function onAppear() {
  処理内容
}

※ onAppearはユーザが直接呼び出さないでください。

※ このメソッドの中でupdateメソッドを呼ばないようにしてください。

PlainChar.waitSelect

はい・いいえ選択用のウィンドウを開き、ユーザがウィンドウを閉じるまで処理を中断します。

書式

waitSelect(prompt,title)

• prompt
   質問文
• title
   文字入力用のウィンドウのタイトルバーに表示する文字列

戻り値

「はい」を押したなら1 「いいえ」を押すか、ウィンドウ右上のxでウィンドウを閉じた場合0

※ 処理を中断したくないときは$SelectBox.openを用います。

※ onMouseDown,onMouseDragメソッドの中ではこのメソッドを呼ばないでください

例1

extends TextChar;
text="ここは武器屋です";
if (waitSelect("剣を買いますか")) {
  text="ありがとうございました";
} else {
  if (waitSelect("それでは、もっといい剣を買いますか")) {
    text="お金がたりません";
  } else {
    text="またどうぞ";
  }
}
wait();

PlainChar.waitInput

文字入力用のウィンドウを開き、ユーザがボタン（「Ok」 または「キャンセル」）を押すまで処理を中断します。

書式

waitInput(title,prompt,default)

• title
   文字入力用のウィンドウのタイトルバーに表示する文字列
• prompt
   プロンプト部分（入力部分のすぐ上）に表示する文字列。改行文字(\n)を使うと複数行表示できます。
• default
   入力部分にあらかじめ入っている文字列

戻り値

入力された文字列。 ユーザが「Ok」「キャンセル」のどちらを押したかは$InputBox.getStatusで調べることができます。

処理を中断したくないときは$InputBox.openを用います。
onMouseDown,onMouseDragメソッドの中ではこのメソッドを呼ばないでください

例1

extends SpriteChar;
while (1) {
  // rに入力結果をいれる
  r=waitInput("どっちへいきますか","\"L\":←  \"R\":→ "); 
  if ($InputBox.getStatus()==2) die(); // キャンセル押したら死亡
  if (r=="Left") { // "Left" を入力したら 、左に移動
    for (i=0 ; i<16 ; i++) {
      x--;
      update();
    }
  }
  if (r=="Right") { // "Right" を入力したら 、左に移動
    for (i=0 ; i<16 ; i++) {
      x++;
      update();
    }
  }
  update();
}

変数x

オブジェクトのx座標をあらわす変数です

変数y

オブジェクトのy座標をあらわす変数です

変数zOrder

複数のオブジェクトが重なった場合、この値が小さいオブジェクトのほうが手前に表示されます。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

PanelCharクラス

任意の図形（線、四角形、文字などの組み合わせ)が描けるオブジェクトです

PanelCharクラスのオブジェクトを作るには、図1のように「パネル」を選びます

図1 :

変数panelを通じて、Panelクラスに用意されている描画命令を使うことができます。

例1

extends PanelChar;
resize(200,200);
while (1) {
  x=x+1;
  panel.drawLine(0,0,200,t,$clWhite);
  t=t+1;
  update();
}

メソッド一覧

変数一覧

PanelChar.setText

パネルに描画する文字列を指定します。

書式

setText(t,c,sz)

• t(省略可能)
   描画する文字列。省略すると変数textの値を使う
• c(省略可能)
   文字列の色。 省略すると変数col の値を使う
• sz(省略可能)
   文字列の大きさ。省略すると変数sizeの値を使う

※ 実行中は、変数textに値を代入しただけでは画面上のテキストは変わりません。必ずこのメソッドを呼び出してください。

このメソッドを呼び出すとテキストに応じてパネルの大きさが自動的に変わります。
このメソッドによりテキスト以外の図形は消去されます。テキストと他の図形を混在させたい場合、panel.drawTextメソッドを使ってください。
描画時のフォントは、font,bold,italic,underline 変数で指定します。

これらについてはパネルオブジェクトの説明を参照してください

PanelChar.getWidth

パネルの横幅を得ます

書式

getWidth()

戻り値

パネルの横幅

PanelChar.getHeight

パネルの縦幅（高さ）を得ます

書式

getHeight()

戻り値

パネルの高さ

PanelChar.resize

パネルの大きさを設定します。

書式

resize(w,h)

• w
   パネルの幅
• h
   パネルの高さ

変数alpha

パネルの透明度を指定します。
255が完全に不透明で、減らすにしたがって透明になっていきます。
0にすると見えなくなります。

変数angle

パネルの回転角度を指定します。単位は度で右回りです。

変数bold

setTextメソッドでテキストを指定している場合のみ有効です。

1を指定すると太字になります。0で通常の書体です

変数col

setTextメソッドでテキストを指定している場合のみ有効です。

テキストの色を指定します。通常はcolorメソッドを使います

変数font

setTextメソッドでテキストを指定している場合のみ有効です。

テキストのフォント名を指定します。 ("ＭＳ ゴシック"など)

変数width

パネルの幅を得ます。

※widthに値を代入しても幅は変更できません。 代わりにresizeメソッドを使用してください。

変数height

パネルの縦幅（高さ）を得ます。

※heightに値を代入しても高さは変更できません。 代わりにresizeメソッドを使用してください。

変数italic

setTextメソッドでテキストを指定している場合のみ有効です。

1を指定すると斜体になります。0で通常の書体です

変数panel

パネル本体を表すオブジェクトです。
このオブジェクトに対してはPanelクラスの各種メソッドを呼び出すことができます。

変数scaleX

パネルの拡大率を指定します。

scaleyを設定していない場合、縦横ともにscaleX倍拡大します。
scaleyを設定した場合、縦にscaley倍、横にscaleX倍拡大します。

変数scaley

パネルの拡大率を指定します。

scaleyを設定していない場合、縦横ともにscaleX倍拡大します。
scaleyを設定した場合、縦にscaley倍、横にscaleX倍拡大します。

変数size

setTextメソッドでテキストを指定している場合のみ有効です。

テキストの大きさをptで指定します。

変数underLine

setTextメソッドでテキストを指定している場合のみ有効です。

1を指定すると下線付きになります。0で通常の書体です

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

Panelクラス

通常の描画メソッド(drawText,drawLine,drawSprite,fillRect)では、描画されたものは１フレームごとに消去されてしまいます。
一度描画したグラフィックスを消さないでおくときは、パネルを使うと便利です。

パネルにアクセスするには、次の２通りがあります。

• $panelという変数を頭につけて、通常の描画命令と同様にメソッドを呼びます。
• パネルオブジェクトを作成します。

例1

例１(パネルを使わない)：

extends SpriteChar;
i=0;
while(i<$screenHeight) {
  drawLine(0,0,$screenWidth,i,color(255,255,255));
  i+=3;
  update();
}

例2

例２：(パネルを使う)：

extends SpriteChar;
i=0;
while(i<$screenHeight) {
  $panel.drawLine(0,0,$screenWidth,i,color(255,255,255));
  i+=3;
  update();
}

▲ 例１では、一本の線が上から下に流れる様子が見えますが、例２では、線の描いた跡が全部残ります。

※ 一度パネルに描いた内容を消去するには、パネルを黒（ color(0,0,0)で指定する色）で塗りつぶします。

例3

例3：(パネルの消去)：

extends SpriteChar;
i=0;
while(i<$screenHeight) {
  $panel. drawLine(0,0,$screenWidth,i,color(255,255,255));
  i+=3;
  update();
}
$panel.fillRect(0,0,$screenWidth,$screenHeight,color(0,0,0));
// ↑パネルに描画した内容を消去
while(i>0) {
  $panel. drawLine($screenWidth,0,0,i,color(255,255,255));
  i-=3;
  update();
}

メソッド一覧

変数一覧

Panel.drawSprite

パネルにスプライトを描画します。

書式

drawSprite(x,y,p,f)

• x
   x座標
• y
   y座標
• p
   キャラクタパターン
• f(省略可能)
   0でない数値の場合、元のキャラクタパターンを左右反転したパターンを描画する

パネルについては、パネルの使い方を参照してください。 $panelとpanelの違い

Panel.drawDxSprite

回転、拡大、縮小、半透明のスプライトを描画します。

書式

drawDxSprite(x,y,p,f,angle,scaleX,scaleY)

• x
   x座標
• y
   y座標
• p
   キャラクタパターン
• f
   0でない数値の場合、元のキャラクタパターンを左右反転したパターンを描画する
• angle
   回転角度。単位は度(°)を表す整数
• scaleX
   横方向の拡大率。１が原寸
• scaleY(省略可能)
   縦方向の拡大率。省略するとscaleXと同じ

Panel.drawLine

パネルに直線を描画します

書式

drawLine(sx,sy,dx,dy,col)

• sx
   始点のx座標
• sy
   始点のy座標
• dx
   終点のx座標
• dy
   終点のy座標
• col
   色(通常colorメソッドで指定)

パネルについては、パネルの使い方を参照してください。

参考： $panelとpanelの違い

Panel.drawBrokenLine

点線を描画します

書式

drawBrokenLine(sx,sy,dx,dy,col,length)

• sx
   始点のx座標
• sy
   始点のy座標
• dx
   終点のx座標
• dy
   終点のy座標
• col
   色
• length
   点線1個の長さ

Panel.getPixel

パネルの特定の点における色を得ます。

書式

getPixel(x,y)

• x
   点のx座標
• y
   点のy座標

戻り値

パネル上(x,y)における色を整数値で返します

戻り値は次の意味を持ちます。

戻り値 ＝ 赤成分 + 緑成分 * 256 + 青成分 * 65536

例1

extends TextChar;
$panel.fillRect(30,30,50,50,$clRed);
$panel.fillRect(130,30,150,50,$clGreen);
$panel.fillRect(30,130,50,150,$clBlue);
while(1) {
  text="色 ="+$panel.getPixel($mouseX,$mouseY);
  update();
}

パネルについては、パネルの使い方を参照してください。 $panelとpanelの違い

Panel.fillRect

パネルに中の詰まった長方形を描画します

書式

fillRect(sx,sy,dx,dy,col)

• sx
   左上点のx座標
• sy
   左上点のy座標
• dx
   右下点のx座標
• dy
   右下点のy座標
• col
   色(通常colorメソッドで指定)

参考： $panelとpanelの違い

Panel.drawText

パネルに文字を描画します。

書式

drawText(x,y,t,col,size)

• x
   x座標
• y
   y座標
• t
   描画する値
• col
   色(通常colorメソッドで指定)
• size
   サイズ

パネルについては、パネルの使い方を参照してください $panelとpanelの違い

Panel.drawText

パネルに文字を描画します。

書式

drawText(x,y,t,col,size)

• x
   x座標
• y
   y座標
• t
   描画する値
• col
   色(通常colorメソッドで指定)
• size
   サイズ

パネルについては、パネルの使い方を参照してください $panelとpanelの違い

Panel.copyRect

パネル間で画像をコピーします

書式

copyRect(dlx,dty,drx,dby,src,slx,sty,srx,sby)

• dlx
   コピー先の左上のx座標
• dty
   コピー先の左上のy座標
• drx
   コピー先の右下のx座標
• dby
   コピー先の右下のy座標
• src
   コピー元のパネル
• slx
   コピー元の左上のx座標
• sty
   コピー元の左上のy座標
• srx
   コピー元の右下のx座標
• sby
   コピー元の右下のy座標

Panel.resize

パネルの大きさを変更します

書式

resize(width,height)

• width
   幅
• height
   高さ

Panel.setTransparentColor

パネルの透過色を指定します。

書式

setTransparentColor(c)

• c
   透過色（colorメソッドで指定)

Panel.getTransparentColor

パネルの透過色を取得します。

書式

getTransparentColor()

戻り値

透過色を表す値

参考 Panel.setTransparentColor

Panel.setPixel

パネルに点を描きます。

書式

setPixel(x,y,c)

• x
   点のx座標
• y
   点のy座標
• c
   パネル上(x,y)に設定する色（整数値） ＝赤成分 + 緑成分 * 256 + 青成分 * 65536

パネルについては、パネルの使い方を参照してください。

参考： $panelとpanelの違い

Panel.load

ファイルから画像を読み込みます

書式

load(fileName)

• fileName
   ファイル名(bmpファイルのみ)

読み込みが起きると、パネルの大きさは読み込んだ画像の大きさに自動的に変更されます。

Panel.save

パネルの画像をファイルに保存します

書式

save(fileName,sx,sy,dx,dy)

• fileName
   ファイル名(bmpのみ)
• sx(省略可能)
   保存する範囲(左上のx座標)
• sy(省略可能)
   保存する範囲(左上のy座標)
• dx(省略可能)
   保存する範囲(右下のx座標)
• dy(省略可能)
   保存する範囲(右下のy座標)

保存する範囲を省略すると、パネル全体を保存します。

Panel.alpha

パネルの透明度を指定します。
255が完全に不透明で、減らすにしたがって透明になっていきます。
0にすると見えなくなります。

参考： パネルオブジェクトの透明度は、次の例のように指定します。

例1

extends PanelChar;
resize(100,100);
panel.fillRect(0,0,100,100,$clWhite);
panel.drawText(0,0,"パネル",$clBlue,18);
wait(60);
alpha=128; // 透明度を128にする
wait();

例2

悪い例

extends PanelChar;
resize(100,100);
panel.fillRect(0,0,100,100,$clWhite);
panel.drawText(0,0,"パネル",$clBlue,18);
wait(60);
panel.alpha=128; // panel.alpha に代入しても透明度は変化しません
wait();

Panel.angle

パネルの回転角度を指定します。単位は度で右回りです。

参考： パネルオブジェクトの回転角度は、次のように指定します。

例1

extends PanelChar;
resize(100,100);
panel.fillRect(0,0,100,100,$clWhite);
panel.drawText(0,0,"パネル",$clBlue,18);
wait(60);
angle=128; // 回転角度を128度にする
wait();

例2

悪い例

extends PanelChar;
resize(100,100);
panel.fillRect(0,0,100,100,$clWhite);
panel.drawText(0,0,"パネル",$clBlue,18);
wait(60);
panel.angle=128; // panel.alpha に代入しても回転しません
wait();

Panel.height

Panelの高さ（ピクセル）が格納されています。

※ この変数に代入してもPanelの大きさは変わりません。
Panelの大きさを変える場合は、resizeメソッドを使います。

Panel.width

Panelの横幅（ピクセル）が格納されています。

※ この変数に代入してもPanelの大きさは変わりません。
Panelの大きさを変える場合は、resizeメソッドを使います。

Panel.zOrder

複数のオブジェクトが重なった場合、この値が小さいオブジェクトのほうが手前に表示されます。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$panelオブジェクト

自動的に作成されるPanelクラスのオブジェクトです。

参考

$panelとpanelの違い

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$panelとpanelの違い

$panel

１ページにつき１個、自動的に作成されます。２個以上は作成できません。
パネル全体の移動はできません

panel

パネルオブジェクトがそれぞれ１つずつ保有します。
パネルオブジェクトが移動するにつれてパネルも移動します

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$Optionsオブジェクト

各種設定を行います

メソッド一覧

$Options.get

$Options.setメソッドで設定したプロジェクトの設定を得ます。

書式

get(name)

• name
   設定項目の名前（$Options.setメソッド参照)

戻り値

設定されている値

default.tonyuprjファイルの<resourcelist name="params">内の要素から取得されます。

$Options.set

プロジェクトの各種設定を行います。

書式

set(name,value)

• name
   設定項目の名前
• value
   設定する値

設定項目の名前(name)として指定できるのは、今のところ次のいずれかです。

• deactivation_pause
   値(value)が1ならば、Tonyuがアクティブでないときに実行を自動的に一時停止します。
   0なら一時停止しません。(デフォルトの動作)
• deactivation_disableKey
   値(value)が1ならば、Tonyuがアクティブでないときにgetkeyメソッドを無効にします。(デフォルトの動作)
   0なら無効にしません。
• sound_stopOnPageLoad
   値(value)が1ならば、$projectManager.loadPageメソッドでページを切り替えたときにBGMを停止します。(デフォルトの動作)
   0ならページをまたがってそのまま演奏されます。
• sleep_time
   フレームごとにCPUをスリープする時間（単位：ミリ秒）を設定します。
   「パフォーマンス」ウィンドウの「CPU負荷」をプログラムから動的に設定するためのオプションです。
   ※ ver1.29はsleep_timeを設定しなくても（デフォルト値の0でも）、CPU負荷がかかりません
   ※ ver1.30以降はビジーループ（$System.setLoopMode(0)）設定時のみ有効です
• disable_pause
   F3キーや「実行」→「一時停止」で一時停止する機能を、無効にするかを設定します。
   値(value)が1ならば、一時停止を無効にします。0なら一時停止を有効にします。
   それ以外の値ならば、開発環境では一時停止を有効、ランタイムでは無効にします。(デフォルトの動作)
• 起動時に適用される設定（互換性の設定を参照）
  • init_base_volume
    • $mplayer.setBaseVolumeを起動時に設定します。
  • init_sound_play_mode
    • $mplayer.setSoundPlayModeを起動時に設定します。
  • init_volume_limiter
    • $mplayer.setVolumeLimiterを起動時に設定します。
  • init_process_single
    • $System.setProcessSingleを起動時に設定します。
  • init_legacy_frame_rate
    • $System.setLegacyFrameRateを起動時に設定します。
  • init_sprite_angle_accuracy
    • $System.setSpriteAngleAccuracyを起動時に設定します。
  • init_sin_cos_accuracy
    • $Math.setSinCosAccuracyを起動時に設定します。
  • init_draw_mode_force_mode
    • $window.setDrawModeForceModeを起動時に設定します。
  • init_se_loop_enable
    • $mplayer.setSeLoopEnableを起動時に設定します。

default.tonyuprjファイルの<resourcelist name="params">内の値が変更、または要素が追加されます。
Tonyuを終了した後も値が残ります。

例1

extends SpriteChar;
$Options.set("deactivation_pause",1); 
// ↑Tonyu以外のアプリケーションをアクティブにすると
// 一時停止する
while (1) {
  x++;
  update();
}

$Options.getEnv

$Options.setEnvメソッドで設定したランタイムの設定を得ます。

※ ランタイム版（Player.exe）でのみ有効です。

書式

getEnv(name)

• name
   設定項目の名前（$Options.setEnvメソッド参照)

戻り値

設定されている値

Kernel/Cookies.iniファイル内の要素から取得されます。

$Options.setEnv

ランタイムの各種設定を行います。

※ ランタイム版（Player.exe）でのみ有効です。

書式

setEnv(name,value)

• name
   設定項目の名前
• value
   設定する値

設定項目の名前(name)として指定できるのは、今のところ次のいずれかです。

• screenWidth
   起動時のウィンドウの幅を指定します。
• screenHeight
   起動時のウィンドウの高さを指定します。
• windowX
   ウィンドウの横の位置を指定します。
• windowY
   ウィンドウの縦の位置を指定します。

Kernel/Cookies.iniファイル内の値が変更、または要素が追加されます。
Tonyuを終了した後も値が残ります。

例1

extends SpriteChar;
$Options.setEnv("screenWidth",600);
$Options.setEnv("screenHeight",400);
$Options.setEnv("windowX",200);
$Options.setEnv("windowY",100);
// ↑次回ランタイムを起動したとき
// 600×400pxの画面サイズで
// ディスプレイの左上から(200,100)の位置に
// ウィンドウが表示されます
while (1) {
  update();
}

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

.演算子

他のオブジェクトの変数を参照するには . を使います。

書式

式 . 変数名

式 がオブジェクトの場合 、そのオブジェクトが持っている、変数名 で指定された名前をもつ変数を返します。
式 が初期化されていなかったり、式がオブジェクトでないと、 次のエラーメッセージが表示されます。

変数$xxxは初期化されていないので、変数yyy を参照できません。
または
nullはオブジェクトではないので、変数yyy を参照できません。

例1

• オブジェクトを２つ作成します。名前は $ObjectA と $ObjectB にして下さい
• $ObjectAをダブルクリックし、次のように入力します。

extends SpriteChar;
while (1) {
  x=x+1;
  update();
}

• $ObjectBをダブルクリックし、次のように入力します。

extends SpriteChar;
while (1) {
  x= $ObjectA.x +30; // x を、$ObjectAの変数xの値 + 30 にする
  $ObjectA.y =300; // $ObjectAの変数yの値 を 300 にする
  update();
}

▲ 実行すると、$ObjectA,$ObjectBはともに横に移動します。
$ObjectA という名前を書き間違えると次のようなメッセージが出ます。名前は間違えないようにしてください。

$xxx は初期化されていないので、変数x を参照できません。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

Objectクラス

すべてのオブジェクトの親クラスです。Objectクラスのメソッドはどのクラスからも利用できます。

メソッド一覧

Object.abs

絶対値を得ます。

書式

abs(x)

• x
   数値

戻り値

xの絶対値 x>=0 なら x , x<0 なら-x

Object.amod

剰余を求めますが、負の値を割る場合%演算子と挙動が変わります。

書式

amod(a,b)

• a
   割られる数(整数)
• b
   割る数(正の整数)

戻り値

a-(aを超えない最大のbの倍数)

例1

extends SpriteChar;
print (amod(12,5));
print (12 % 5);
print (amod(-12,5));
print (-12 % 5);

Object.angle

線分(1,0)-(0,0)と線分(0,0)-(x,y)のなす角を求めます

書式

angle(x,y)

• x
   線分(0,0)-(x,y)のx
• y
   線分(0,0)-(x,y)のy

戻り値

線分(1,0)-(0,0)と(0,0)-(x,y)のなす角(単位:度)

※angleで計算される角度はあまり正確ではありません。
角度を45で割った余りが22付近になる場合、誤差が大きくなります。
もっと正確に求めたい場合は、$Math.angleメソッドを使います。

参照： angle,sin,cos,distの関係

Object.angleDiff

角度の比較を行います。

書式

angleDiff(a,b)

• a
   角度a
• b
   角度b

戻り値

angleDiff(a,b) は、-180 から 179 までの値を返します。

この値は次の性質をもっています。

angleDiff(a,b) == (a-b) + 360 * n (nは整数) 言い換えると、angleDiff(a,b)の戻り値は、角度a-b と同じ向きを持つ、-180 から 179 までの角度です。

angleDiff(360,90) = -90

angleDiff(-50,180) = 130

angleDiffを図で表すと図1のようになります。

d=angleDiff(a,b);

angleDiffを用いると、角度a から 角度bに到達するには右回り、左回りのどちらが早いかを判定することができます。
angleDiff(a,b)の値が正の とき、a から b に 至るには 左回り（aを減らす)が近く、
負のときは右回り(aを増やす) のほうが近くなります。

Object.appear

実行中にオブジェクトを出現させます。

書式

appear(o)

• o
   出現させるオブジェクト

戻り値

出現したオブジェクト(o自身)

スプライトオブジェクト、DXスプライトオブジェクトの作成には、次の形式が便利です。

書式:

appear(new クラス名( x座標, y座標, キャラクタパターン, 反転 ))

• クラス名
   出現させるオブジェクトのクラスを指定します
• x座標,y座標
   出現位置を指定します
• キャラクタパターン
   出現したときのキャラクタパターンを指定します
• 反転(省略可)
   １を指定するとキャラクタパターンを左右反転します

テキストオブジェクトは次の形式で作成します

書式:

appear(new クラス名( x座標, y座標, テキスト, 色, サイズ))

• クラス名
   出現させるオブジェクトのクラスを指定します
• テキスト
   出現したときのテキストの内容を文字列で指定します
• 色
   テキストの色を決めます。通常colorメソッドを使います。
• サイズ
   文字の大きさを決めます。省略すると12です

例1

en=appear(new Enemy(x,y,$pat_enemy+3));

例2

Tama.tonyu

extends SpriteChar;
while(1) {
  x+=vx;y+=vy;
  update();
}

Jiki.tonyu

extends SpriteChar;
while(1) {
  if (getkey(32)==1) {
    t=new Tama(x,y,10); // t:出現させるオブジェクト
    // tの変数を初期化。←を押すと左方向、→を押すと右方向に飛んでいく
    if (getkey(37)) t.vx=-2;
    if (getkey(39)) t.vx=2;
    t.vy=-8;
    appear(t);
  }
  update();
}

Object.clearAllValues

全ての数値を初期化します。

書式

clearAllValues()

全ての数値の初期化。

(推奨されない関数) clearAllValuesはTonyu Systemが自動的に呼び出します。
プログラム中に記述するとゲームが正常に作動しないことが予想されます。

例1

clearAllValues();

▲ 全ての数値が初期化されます

Object.color

fillRect、drawLine、drawTextなどで、描画色を指定します

書式

color(r,g,b)

• r
   赤成分(0-255)
• g
   緑成分(0-255)
• b
   青成分(0-255)

戻り値

色を表す整数

例1

drawText(10,10,"赤巻き紙",color(255,50,50));
drawText(10,40,"青巻き紙",color(50,50,255));
drawText(10,70,"黄巻き紙",color(255,255,50));

また、次の8種類の色があらかじめ定義されています。

参考

$clBlackの色が中途半端なのは

例2

drawText(10,10,"赤巻き紙",$clRed);
drawText(10,40,"青巻き紙",$clBlue);
drawText(10,70,"黄巻き紙",$clYellow);

参照

colorHSL

Object.colorHSL

色相、彩度、明度から色を作成します。

書式

colorHSL(h,s,l)

• h
   色相
• s
   彩度
• l
   明度

Object.cos

余弦(コサイン)を求めます。

書式

cos(t)

• t
   度をあらわす整数(ラジアンではありません)

戻り値

t度の余弦を求めます。
cosがどのような値をもっているかは、angle,sin,cos,distの関係を参照してください。

例1

例はsinメソッドに載っています。
※sin,cosの計算は、三角関数表をあらかじめ用意しているため高速ですが、
指定する角度は整数のみ有効です(角度の小数点以下は切り捨てられます)
ver1.30では精度が向上します。詳しくは$Math.setSinCosAccuracyを参照

参照

• sinメソッド
• angleメソッド

Object.deleteFile

ファイルを削除します

書式

deleteFile(fileName)

• fileName
   削除するファイル名

戻り値

削除が成功ならば1、そうでなければ0

ファイルについては、ファイルの扱いについてを参照してください。

Object.designMode

現在設計中(実行コマンドを発行する前や、実行を停止した後)であれば真を返します。

書式

designMode()

Object.dist

線分(0,0)-(x,y)の長さを求めます。

書式

dist(x,y)

• x
   線分(0,0)-(x,y)のx
• y
   線分(0,0)-(x,y)のy

戻り値

線分(0,0)-(x,y)の長さ

例1

extends SpriteChar;
while (1) {
  if (dist(x-$teki.x, y-$teki.y)<50) die();
  update();
}

▲ オブジェクト $teki との距離が50以下になるとdie(); が呼ばれます。

参照

angle,sin,cos,distの関係

Object.fileExists

ファイルが存在するかどうかを調べます。

書式

fileExists(f)

• f
   ファイル名

戻り値

ファイルが存在すれば1、なければ0

Object.floor

実数から整数への変換を、値を超えない最大の整数を得ることで行います。

書式

floor(r)

• r
   実数値

戻り値

rを超えない最大の整数

※ rが正または0の場合、trunc(r)と同じ値を返しますが、負の場合はtrunc(r)-1 が返されます。

Object.getBlue

colorメソッドや色定数などの色を表す整数から青色の成分を取り出します。

書式

getBlue(c)

• c
   色を表す整数

戻り値

c の青成分(0-255)

getBlueメソッドとcolorメソッドの関係は次のようになります。
c = color(r,g,b) ならば、 getBlue( c ) == b

Object.getClassName

オブジェクトのクラス名を得ます。

書式

getClassName()

戻り値

このオブジェクトのクラス名

Object.getGlobal

グローバル変数の値を取得します

書式

getGlobal(n)

• n
   変数名をあらわす文字列（$を含む)

戻り値

変数nの値

例

n="$Test";
t=getGlobal(n);

Object.getGreen

colorメソッドや色定数などの色を表す整数から緑色の成分を取り出します。

書式

getGreen(c)

• c
   色を表す整数

戻り値

c の緑成分(0-255)

getGreenメソッドとcolorメソッドの関係は次のようになります。
c = color(r,g,b) ならば、 getGreen( c ) == g

Object.getRed

colorメソッドや色定数などの色を表す整数から赤色の成分を取り出します。

書式

getRed(c)

• c
   色を表す整数

戻り値

c の赤成分(0-255)

getRedメソッドとcolorメソッドの関係は次のようになります。
c = color(r,g,b) ならば、 getRed( c ) == r

Object.getTime

システムタイマの値（OS起動からの時間）をミリ秒単位で返します。

書式

getTime()

戻り値

システムタイマの値

Object.getValueName

オブジェクトの持つ変数名を取り出します。

書式

getValueName(idx)

• idx
   インデックスをあらわす整数。
   インデックスは、この オブジェクトをオブジェクトインスペクタに表示させたときの、
   一番上の変数が0で、順番に増えていきます。

戻り値

idx番目の変数の名前

Object.getkey

キーボードのキーやマウスボタンが押されているかどうか判定します。

書式

getkey(i)

• i
   調べたいキーのキーID

戻り値

0：押されていない
1：今押されたばかり
2以上：押しっぱなしになっている

主なキーのキーIDを示します。

その他のキーID

例1

extends SpriteChar;
while (1) {
  if (getkey(32)>0) x+=1;
  update();
}

▲ スペースキーの状態が押されていると横移動します。

※その他のキーのキーIDの調べ方

1. 新規オブジェクト(新規クラス)を作成
2. オブジェクトをダブルクリックし、次のように入力して実行
3. 押しているキーのキーIDが表示される

   extends SpriteChar;
   while (1) {
     i=0;
     while(i<255) {
    if (getkey(i)) drawText(i,10,i,color(255,255,255));
    i=i+1;
     }
     update();
   }
   

※Tonyuがアクティブでないときにgetkeyを無効にする

$Options.set("deactivate_disableKey",1);

参照： $Options.setメソッド

Object.inspect

オブジェクトをオブジェクトインスペクタに表示します。

書式

inspect()

Object.isFloat

値が実数（浮動小数点数）であるか調べます

書式

isFloat(v)

• v
   調べる値

戻り値

vが実数であれば0以外、そうでなければ0

Object.isInt

値が整数であるか調べます

書式

isInt(v)

• v
   調べる値

戻り値

vが整数であれば0以外、そうでなければ0

Object.moveFile

ファイル名を変更します

書式

moveFile(from,to)

• from
   変更前のファイル名
• to
   変更後のファイル名

戻り値

変更が成功ならば1、そうでなければ0

Object.print

コンソールウィンドウとステータスバーに文字を出力します。

書式

print(v)

• v
   表示する値

コンソールウィンドウはメニューの「ウィンドウ」＞「コンソール」 で表示できます。

例1

extends SpriteChar;
print(2+3);
print("Hello, world");

Object.pset

ドット描画を行います。

書式

pset(x,y,c)

• x,y,c
   指定した位置にドット描画を行います。

(使用できない関数) 古いFormatに付き、現在は使用できないようになっています。

例1

pset(100,100,$clBlack);

▲ (100,100)に黒い点が現れます。

Object.randomize

rndメソッドが生成する乱数の系列(乱数の発生順序)を設定します。

書式

randomize(seed)

• seed(省略可能)
   乱数系列を表す整数( 0 ～ 16777215 )。 省略すると、システムタイマによって乱数系列が設定されます。

このseedの値によって、この後rndメソッドが返す値の順番が決まります。
seedを省略した場合、プログラムを実行するたびにまったく違う乱数を返すことができます

例1

extends SpriteChar;
randomize();
while (1) {
  if (rnd(10)==0) {
    x=rnd()*$screenWidth;
    y=rnd()*$screenHeight;
  }
  update();
}

Object.rnd

乱数(でたらめな数)を返します

書式

rnd(n)

• n(省略可能)
   発生させる乱数の範囲。

戻り値

0 から n-1の整数乱数。nを省略すると0から1の実数乱数を返します。

例1

extends SpriteChar;
while (1) {
  if( rnd(10)==0) {
    x=rnd()*$screenWidth;
    y=rnd()*$screenHeight;
  }
  update();
}

▲ 10フレームに１回の確率で、画面上のいろいろな場所にオブジェクトが移動します。

実行のたびに違う順序で乱数を発生させるにはrandomizeメソッドを使います。

Object.sin

正弦(サイン)を求めます。

書式

sin(t)

• t
   度をあらわす整数(ラジアンではありません)

戻り値

t度の正弦を求めます。
sinがどのような値をもっているかは、angle,sin,cos,distの関係を参照してください。

例1

extends SpriteChar;
a=0;
while (1) {
  x=200+cos(a)*100;
  y=200+sin(a)*100; 
  a=a+10;
  update();
}

▲ オブジェクトが回転します。

※sin,cosの計算は、三角関数表をあらかじめ用意しているため高速ですが、
指定する角度は整数のみ有効です(角度の小数点以下は切り捨てられます)
ver1.30では精度が向上します。詳しくは$Math.setSinCosAccuracyを参照

参照

• cosメソッド
• angleメソッド

Object.sqrt

平方根を得ます

書式

sqrt(x)

• x
   正の数値

戻り値

√x

例1

extends TextChar;
while (1) {
  dx=x-$mouseX;
  dy=y-$mouseY;
  text=sqrt(dx*dx+dy*dy); 
  update();
}

▲ このオブジェクトとマウスカーソルの距離を計算します（本当はdistメソッドを使ったほうが楽です)

Object.sub

減算関数。引き算を行います。

書式

sub(x,y)

• x,y
   x-yの結果を出力します。

戻り値

x-y

(使用できない関数) 古いFormatに付き、現在は使用できないようになっています。

例1

sub(x,y);
print(sub(10,1));

▲ 10-1の結果の9を出力します。

Object.timeStop

すべてのオブジェクトの動作を停止します。ただし、このメソッドを呼び出したオブジェクトだけ停止しません

書式

timeStop()

戻り値

新規作成されたTimeStopperオブジェクト。

TimeStopperオブジェクトは、止めた時間をふたたび動かす時に使います。

時間を動かすにはTimeStopperオブジェクトに対して、 releaseメソッドや releaseAllメソッドを 呼び出します。

例1

Ball.tonyu

extends SpriteChar;
while (x<$screenWidth) {
  x+=2;
  update();
}

Stop.tonyu

extends SpriteChar;
t=null;
while (1) {
  if (t==null) {// まだ時間をとめていなければ
    if (rnd(60)==0) appear(new Ball(0,rnd($screenHeight),19)); // 玉を出現させる
    if (getkey(32)==1) { //スペースキーが押されたら時間をとめる
      t=timeStop();
    }
  } else {
    // すでに時間をとめていたら
    if (getkey(32)==1) { //スペースキーが押されたら時間を動かす
      t.releaseAll();
      t=null;
    }
    // 玉にふれるとその玉は動き出す
    for (a in $chars) {
       if (a is Ball && crashTo(a)) t.release(a);
    }
  }
  if (getkey(39)>0) x+=3;
  if (getkey(37)>0) x-=3; 
  if (getkey(40)>0) y+=3;
  if (getkey(38)>0) y-=3;
  update(); 
}

Object.trunc

実数から整数への変換を、小数部切捨てにより行います。

書式

trunc(r)

• r
   実数値

戻り値

rの小数点を切り捨てた値

※ rが正または0の場合、floor(r)と同じ値を返しますが、負の場合はfloor(r)+1 が返されます。

例1

extends SpriteChar;
x=10;
x=trunc(x/3);
print(x);

▲ xの値は10/3 = 3.333... の小数部を切り捨てた3になります

参考：四捨五入

次のようにすると、小数点以下を四捨五入します。

n=trunc(n+0.5);

Object.valueOf

文字列から数値への変換を行います。

書式

valueOf(s)

• s
   文字列 ( "123" "45.6" "-78" など)

戻り値

変換された値。文字列が数値を表していない場合null

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

null

nullとは、「何も値が入っていない」という意味です。変数に値が代入される前には、このnullという値が入っています。

ある変数がnullであるか(まだ値が入っていないか)どうかは、次のように判定できます

if (x==null) ...

次のように、変数にnullを代入することも可能です。

x=null;

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$mplayerオブジェクト

音楽、効果音の制御を行います

メソッド一覧

$mplayer.play

BGM,効果音を演奏します

書式

play(s,autoReplay,vol)

• s
   演奏するサウンドオブジェクト
• autoReplay (省略可能)
   Midi,Wavを繰り返し演奏する場合は1
• vol (省略可能)
   効果音の音量(0-128)

戻り値

効果音のID

効果音を途中停止する場合に使います。（$mplayer.stopSE）

例1

(予め、BGM・効果音ウィンドウで test.wavというサウンドファイルを読み込んでおく必要があります)

extends SpriteChar;
while (1) {
  if (getkey(32)==1) {$mplayer.play($se_test);}
  update();
}

▲ スペースキーを押すとtest.wavが鳴ります

$mplayer.stop

BGMの演奏を停止します

書式

stop()

例1

$mplayer.stop();

$mplayer.stopSE

(1_30_2022_0804以降)

効果音を再生中に停止できます

setSoundPlayMode(1)以外に設定時、動作します。

※ stopSEを使う時は、先にsetSeStopEnableで有効化してください。

※ ver1.303現在、バグなのか音が若干残る場合があります。setSoundPlayMode(4)を設定すると音が完全に止まります。

※ wavの効果音とBGMが50音以上同時に再生されている場合は、正しく停止できない場合があります。

書式

stopSE(id, shortFadeout)

• id
   再生中の効果音のID
• shortFadeout (省略可能)
   フェードアウトの時間 (サンプル数）（1秒＝44100)
   指定した時間をかけて緩やかに停止します
   停止時にプチっとノイズが鳴るのを軽減したい場合に指定します
   ノイズ対策用のため、0～10000(約0.23秒)の範囲です
   省略すると0指定時と同じで、速やかに停止します
   setSoundPlayMode(2or3)に設定時のみ適用となります

例1

(予め、BGM・効果音ウィンドウで test.wavというサウンドファイルを読み込んでおく必要があります)

extends SpriteChar;
$mplayer.setSeStopEnable(1); // stopSE有効化
while (1) {
  if (getkey(90)==1) seID=$mplayer.play($se_test); // Zキーで効果音再生
  if (getkey(88)==1) $mplayer.stopSE(seID); // Xキーで効果音を途中停止
  if (getkey(67)==1) $mplayer.stopSE(seID,100); // Cキーで効果音を途中停止(停止時のノイズ軽減)
  update();
}

$mplayer.setVolume

BGMの音量を調節します

このメソッドは.mzo形式にのみ利用可能です

書式

setVolume(vol)

• vol
   音量(0-256)

例1

for (i=256; i>0; i--) {
  $mplayer.setVolume(i);
  update();
}

▲ フェードアウトします。他の音楽を鳴らす前には$mplayer.setVolume(256)を実行してください。（音が出なくなります）

$mplayer.setDelay

効果音を鳴らす際の待機時間を調整します
ver1.30以降setSoundPlayMode(1or2)に設定時のみ適用となります。

書式

setDelay(time)

• time
   待機時間 (サンプル数：1秒＝44100)

効果音の最初の部分が途切れる場合は、この値を大きめにしてください
（ただし大きくしすぎると待機しなくなるので、最大約19000が限度です）

規定値はWindowsのバージョンによって以下にしています

$mplayer.setDelayDs

(1_30_2022_0804以降)

※ デフォルト自動で調整する設定のため、通常このメソッドを使用する必要はありません

効果音を鳴らす際の待機時間を調整します。
setSoundPlayMode(3)に設定時、適用されます。

書式

setDelayDs(time)

• time
   待機時間 (サンプル数：1秒＝44100)
   -1：自動設定（デフォルト）
    ・待機時間を自動で調整します
    ・DirectSoundから情報取得し待機時間を求めています
   0以上：手動設定
    ・待機時間を手動で調整します
    ・ただし大きくしすぎると待機しなくなるので、最大約19000が限度です

$mplayer.getAutoDelayDs

(1_30_2022_0804以降)

setDelayDsで自動調整に設定している際の待機時間を取得します

setSoundPlayMode(3)かつsetDelayDs(-1)に設定時、Tonyu内部で使用されます。

書式

getAutoDelayDs()

戻り値

自動調整に設定している際の待機時間 (サンプル数：1秒＝44100)

$mplayer.resetAutoDelayDs

(1_30_2022_0804以降)

※ 通常このメソッドを使用する必要はありません

setDelayDsで自動調整に設定している際の待機時間をリセットします。

DirectSoundから情報取得し待機時間を求めていますが、
待機時間が自動で大きくなっていきますが小さくはなりません。
手動で待機時間を0に戻します。

書式

resetAutoDelayDs()

$mplayer.setSoundPlayMode

(1_30_2022_0804以降)

wav,mzo再生の音源モードを切り替えます。

※ 実行すると効果音とBGMが止まります。
  処理が重いので、起動時に１度だけ使用したり、設定画面等で使用することをお勧めします。
  BGMは自動では復帰しないので、鳴らしたい場合は再度再生する必要があります。

※ 基本的にはデフォルト設定の、音源モード3のままで問題ありません。
  旧バージョンの音源を再現したい場合は1にします。
  2,4は開発の過程でできたものです。

書式

setSoundPlayMode(mode)

• mode
   音源モードの番号
   デフォルトは3に設定されています。

※ 音源モード2,3は、音源がMMEかDirectSoundかの違いのみです。
※ Windows 95,98,98SE,Meは、デフォルト音源モード2となります。(3,4の場合、あるPCでレイテンシが遅い・音がならないなどの現象があったため)

*1) MME
   Windows標準のサウンドドライバーです
   音声が再生されるまでの時間（レイテンシ）が大きいです
*2) DirectSound
   Windowsのゲーム用のサウンドドライバーです
   MMEよりもレイテンシが小さくなります

※ 互換性の設定「11025Hz, 22050Hz, 44100Hz以外のwavで再生速度が速くなる（かつ音が高くなる）現象」を参照

$mplayer.setBaseVolume

(1_30_2022_0804以降)

wav,mzo再生の全体音量を設定します

• ver1.19以前、wavとmzoの音量は100%でした。
• ver1.21～1.29は、wavとmzoの音量は50%でした。
• ver1.30以降、wavとmzoの音量は100%になりました。
• default.tonyuprjのtargetVersion（無い場合はsavedVersion）によってデフォルトの精度が変わります
  • 1210～1290の場合は、互換性のためwavとmzoの音量は50%
  • 1300以上の場合は、wavとmzoの音量は100%
• 手動で音量を変えたい場合、このメソッドを使用します

書式

setBaseVolume(volPer)

• volPer
   wav,mzoの全体音量を実数で指定します。
   例えば、1.0は元の音量(100%)、0.5は50%の音量となります。
   デフォルトはver1.21～1.29では0.5、それ以外のバージョンでは1.0です。

※ 互換性の設定「wav,mzoの音量」を参照

$mplayer.setVolumeLimiter

(1_30_2022_0804以降)

wav,mzoの音量が大きい場合、音割れを防ぐ機能の有効・無効を設定します。
setSoundPlayMode(2or3)に設定時、適用されます。
setSoundPlayMode(4)に設定時は、DirectSoundが自動的に行います。(Windows XP以前では音割れします)

書式

setVolumeLimiter(enable)

• enable
   1で有効、0で無効
   デフォルトは0(無効)です。

※ 互換性の設定「効果音を多数大音量で鳴らすと音割れする現象」を参照

$mplayer.setSeLoopEnable

(1_30_2022_0804以降)

wavのループの有効・無効を設定します

※ 一部のゲームで、wavループが効かないver1.22以前の時にループ再生を指定してしまい、
  ver1.23以降で実行するとwavループが大量に行われ大音量となったため、それを防ぐために追加した機能です。
  自動的に互換性を保つため、通常このメソッドを使う必要はありません

• ver1.22以前は、$mplayer.playでwavをループ再生を指定しても、ループ再生をしないようにします
• ver1.23以降は、$mplayer.playでwavをループ再生を指定すると、ループ再生します
• default.tonyuprjのtargetVersion（無い場合はsavedVersion）によってデフォルトの精度が変わります
  • 1220以下の場合は、wavループ再生を無効にします
  • 1230以上の場合は、wavループ再生を有効にします
• 手動で設定を変えたい場合、このメソッドを使用します

書式

setSeLoopEnable(enable)

• enable
   1で有効、0で無効
   ver1.22以前では、0がデフォルトで無効です。
   ver1.23以降では、1がデフォルトで有効です。

※ 互換性の設定「ver1.22以前のゲームをver1.23以降で実行すると、wavがループしてしまう」を参照

$mplayer.setSeStopEnable

(1_30_2022_0804以降)

$mplayer.stopSEの有効・無効を設定します

書式

setSeStopEnable(enable)

• enable
   1で有効、0で無効
   デフォルトでは無効になっているので、$mplayer.stopSEを使うときは有効化してください。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$mouseManagerオブジェクト

マウスの制御(マウスカーソルの強制移動、マウスの非表示など)を行います。

例1

extends SpriteChar;
$mouseManager.showCursor(0);
while (1) {
  $mouseManager.moveCursor(100,100);
  x+=($mouseManager.relX);
  y+=($mouseManager.relY);
  update();
}

▲ Windows標準のマウスが消え、代わりにこのオブジェクトがマウスカーソルとして働きます。

メソッド一覧

変数一覧

$mouseManager.moveCursor

マウスカーソルを指定した場所に移動します。

書式

moveCursor(x,y)

• x
   移動先x座標。メインウィンドウの左端はx=0
• y
   移動先y座標。メインウィンドウの上端はy=0

このメソッドを実行すると$mouseManager.relX, $mouseManager.relYにカーソルの相対移動量が設定されます。

$mouseManager.showCursor

マウスカーソルの表示、非表示を設定します

書式

showCursor(s)

• s
   0=非表示 / 1=表示

$mouseManager.refreshXY

$mouseX,$mouseYは、通常、１フレームが終わる毎に自動的に更新されますが、
このメソッドを呼び出すと、呼び出した時点で直ちに$mouseX,$mouseYが更新されます。
通常は呼び出す必要はありません。

書式

refreshXY()

$mouseManager.relX

マウスカーソルの相対移動量（直前の位置からどれだけ動いたか）のx成分を読み出します。

この値を調べる前に、$mouseManager.moveCursorを実行してください。

$mouseManager.relY

マウスカーソルの相対移動量（直前の位置からどれだけ動いたか）のy成分を読み出します。

この値を調べる前に、$mouseManager.moveCursorを実行してください。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$mouseX, $mouseY

マウスカーソルの位置($mouseX :x座標 / $mouseY :y座標) を返します。

メインウィンドウの左上が ($mouseX,$mouseY)=(0,0)
メインウィンドウの右下が ($mouseX,$mouseY)=($screenWidth,$screenHeight) になります。

ver 1.09から、画面外にいるマウスカーソルも位置がわかるようになりました。

• メインウィンドウより左側にいる場合、$mouseXが負の値になります。
• メインウィンドウより上にいる場合、$mouseYが負の値になります。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

メソッドの定義

メソッドは、あらかじめ定義されているものを呼び出すだけではなく、自分で定義（作成）することができます。

メソッドの定義をするには次の書式に従います。

書式

function メソッド名 (引数名, 引数名,... ) {
  ローカル変数宣言
  処理本体
}

引数名：このメソッドを呼び出すときに、呼び出す側から渡される値を格納するための変数名を指定します。

ローカル変数宣言 ： このメソッドの中だけで一時的に使いたい変数（ローカル変数）が必要ならば、次の書式で宣言します(* 中級者向き)

書式

var 変数名,変数名 ...;

例1

extends SpriteChar;
function upDown(speed) {
   if(getkey(38)) y=y-speed;
   if(getkey(40)) y=y+speed;
}
while (1) {
   while (x<200) {
     upDown(2);
     update();
     x=x+2;
   }
   while (x>0) {
     upDown(5);
     update();
     x=x-2;
   }
}

▲ オブジェクトが左右に往復します。カーソールキーの上下で上下移動ができますが、
右に動いているときは上下移動の速度が2、左のときは5になります。

※ Ver 1.17から、プログラム中のどの場所でも(メインの手続きの後ろでも)メソッド宣言が可能です

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

メソッドの呼び出し

メソッドとは、ある決まった処理をまとめたものです。
プログラムからメソッドを呼び出すことによりその処理を実行させることができます。

あらかじめ定義されているメソッドを呼ぶには、次の書式に従います。

書式

メソッド名 ( 引数 , 引数 ... )

メソッド名で指定された名前をもつメソッドを呼び出します。
引数は、呼び出すメソッドに渡す値です。
引数の詳細は、 それぞれのメソッドの説明のところに記載されています。

また、メソッドによっては呼び出す相手を指定する必要があります。
その場合は次の書式に従います。

書式

式. メソッド名 ( 引数 , 引数 ... )

式で表されるオブジェクトに対して、メソッド名で指定された名前をもつメソッドを呼び出します。
式がが初期化されていなかったり、式がオブジェクトでないと、 次のメッセージが表示されます。

変数$xxxは初期化されていないので、メソッド mmm を呼び出せません。

または

nullはオブジェクトではないので、メソッド mmmを呼び出せません。

例1

extends SpriteChar;
while (1) {
  x=x+1;
  update(); 
}

▲ update(); によって、updateメソッドを呼び出します。 updateメソッドには引数が不要なので、() をつけるだけにします。

例2

extends SpriteChar;
while (1) {
  x=x+1;
  drawText(x,y,"文字",$clWhite);
  update();
}

▲ drawTextメソッドは、文字を描画する処理を行います。どこにどんな文字を出すかといった情報を引数で渡します。

例3

オブジェクトを２つ作成します。名前は $ObjectA と $ObjectB にして下さい

$ObjectAをダブルクリックし、次のように入力します。

extends SpriteChar;
while (1) {
  x=x+1;
  update();
}

$ObjectBをダブルクリックし、次のように入力します。

extends SpriteChar;
while (1) {
  x=x+1;
  if (x==300) $ObjectA.die(); // x==300になったら、$ObjectAを消す
  update();
}

▲ オブジェクトに対して dieメソッドを呼ぶと、そのオブジェクトが消えます。

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

Matrixクラス

2次元配列を格納するオブジェクトです。

例1

extends TextChar;
m=new Matrix(10); // 横10列の配列を作成
m.addRows(5); // 縦に5行追加
for (y=0; y<5; y++) {
  for (x=0; x<10; x++) {
     m.set(x,y,x+y);
  }
}
while (1) {
  x=valueOf(waitInput("Xの値?"));
  y=valueOf(waitInput("Yの値?"));
  text="("+x+","+y+")="+m.get(x,y);
  update();
}

メソッド一覧

Matrix.get

2次元配列の内容を取得します。

書式

get(x,y)

• x
   横位置
• y
   縦位置

戻り値

(x,y) に格納されている値。

Matrix.set

2次元配列の内容を更新します。

書式

set(x,y,value)

• x
   横位置
• y
   縦位置
• value
   新しい値

命令リファレンス Wikiトップ

命令リファレンス Wikiトップ

$Mathオブジェクト

高度な数学関数を提供します

メソッド一覧

$Math.pow

べき乗 a^b を求めます。
引数に実数も渡すことができます。

書式

pow(a,b)

• a
   基数
• b
   指数

戻り値

aをb乗した値

$Math.exp

e(ネイピア数)をxで累乗した値を返します。

書式

exp(x)

• x
   指数

戻り値 e(ネイピア数)をxで累乗した値

$Math.log

e(ネイピア数) を底とした x の対数を返します。

書式

log(x)

• x
   値

戻り値 e(ネイピア数) を底とした x の対数

$Math.pi

円周率πを返します

書式

pi()

戻り値

πの近似値(3.141592653589793)

$Math.atan

逆正接(アークタンジェント)を求めます。

書式

atan(t)

• t
   実数値

戻り値

tan(x)=tとなるような x。単位は度(ラジアンでありません)

参考

$Math.setAtanAccuracy

$Math.setAtanAccuracy

$Math.atanの精度を変更します。

書式

setAtanAccuracy(accuracy)

• accuracy
   精度

accuracyに逆正接の精度を設定します。
accuracyが大きくするとatanの値が正確に 求められますが、計算に時間がかかります。
標準値は10000で、精度、速度のバランスがとれた値です。
精度優先なら1000000、速度優先なら100～1000が適切です。
10000000より大きいと計算が終わらなくなるので注意してください。

$Math.angle

高精度なangleメソッドです

書式

angle(x,y)

• x
   線分(0,0)-(x,y)のx
• y
   線分(0,0)-(x,y)のy

戻り値

線分(1,0)-(0,0)と(0,0)-(x,y)のなす角(単位:度)

$Math.atanを利用して、従来のangleより高い精度で角度を計算します。

$Math.tan

正接(タンジェント)を求めます。

書式

tan(t)

• t
   度をあらわす整数(ラジアンではありません)

戻り値

t度の正接を求めます。

$Math.cot

余接（コタンジェント）を求めます。

書式

cot(t)

• t
   度をあらわす整数(ラジアンではありません)

戻り値

t度の余接を求めます。

cot(t)=1/tan(t) です

$Math.sec

正割（セカント）を求めます。

書式

sec(t)

• t
   度をあらわす整数(ラジアンではありません)

戻り値

t度の正割を求めます。

sec(t)=1/cos(t) です

$Math.csc

余割（コセカント）を求めます。

書式

csc(t)

• t
   度をあらわす整数(ラジアンではありません)

戻り値

t度の余割を求めます。

csc(t)=1/sin(t) です

$Math.asin

逆正弦(アークサイン)を求めます。

書式

asin(t)

• t
   実数値

戻り値

sin(x)=tとなるような x。単位は度(ラジアンでありません)

$Math.acos

逆余弦(アークコサイン)を求めます。

書式

acos(t)

• t
   実数値

戻り値

cos(x)=tとなるような x。単位は度(ラジアンでありません)

$Math.degrees

ラジアンを表す値から、度を計算します

書式

degrees(r)

• r
   実数

戻り値

ラジアンrを表す角度

$Math.radians

度を表す値から、ラジアンを計算します

書式

radians(t)

• t
   実数

戻り値

t度のラジアン