Tonyu System 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度のラジアン

$Math.roll

座標を回転させます

書式

roll(sx,sy,angle,cx,cy)

• sx
   回転させたい点のx座標
• sy
   回転させたい点のy座標
• angle
   回転角
• cx (省略可能)
   回転の中心のx座標(省略時は0)
• cy (省略可能)
   回転の中心のy座標(省略時は0)

戻り値

$Math.rx, $Math.ryに、回転後の座標

$Math.isOdd

値が奇数であるかどうかを調べます

書式

isOdd(n)

• n
   整数値

戻り値

nが奇数のとき真

$Math.isEven

値が偶数であるかどうかを調べます

書式

isOdd(n)

• n
   整数値

戻り値

nが偶数のとき真

$Math.randBetween

2つの値の間を範囲とする、整数乱数を返します

書式

randBetween(f,t)

• f
   整数値
• t
   整数値

戻り値

f<tのときは、f以上t未満の乱数。 t<fの場合t以上f未満。t==fの場合t。

$Math.randBetweenFloat

2つの値の間を範囲とする、実数乱数を返します

書式

randBetweenFloat(f,t)

• f
   実数値
• t
   実数値

戻り値

f<tのときは、f以上t未満の乱数。 t<fの場合t以上f未満。t==fの場合t。

$Math.setSinCosAccuracy

(1_30_2022_0804以降)

sin,cosの精度を変更します

• ver1.29以前は、sin,cosは1°単位までしか受け付けず、0～360°で360段階となっていました
• ver1.30以降は、sin,cosは0.01°単位まで受け付け、0～360°で36000段階となります
• default.tonyuprjのtargetVersion（無い場合はsavedVersion）によってデフォルトの精度が変わります
  • 1290以下の場合は、互換性のため360段階
  • 1300以上の場合は、36000段階
• 手動で精度を変えたい場合、このメソッドを使用します

書式

setSpriteAngleAccuracy(mode)

• mode
   -1: 最高精度（ただし計算をするため、他の精度よりも少し重くなります）
   0: 0～360°で360段階（三角関数表を使うため高速です）
   1: 0～360°で36000段階（三角関数表を使うため高速です）

※ 互換性の設定「sin,cosの精度」を参照

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

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

$mapオブジェクト

マップパターンの設定や取得、画面のスクロールを行います

メソッド一覧

$map.set

マップパターンを設定します

書式

set(mx,my,p)

• mx
   マップパターン上のx座標
• my
   マップパターン上のy座標
• p
   設定するキャラクタパターン番号

マップの(mx,my)のパターンをpに設定します

$map.get

マップパターンを取得します

書式

get(mx,my)

• mx  マップパターン上のx座標
• my  マップパターン上のy座標

戻り値

マップ上のmx,myにおけるキャラクタパターン番号を返します

例1

 pa=$map.get(4,3);

▲ 図1の緑枠の部分のキャラクタパターンを返します

$map.getAt

画面上の座標からマップパターンを取得します

書式

getAt(sx,sy)

• sx
   画面の座標上のx座標
• sy
   画面の座標上のy座標

戻り値

画面の座標sx,syにおけるキャラクタパターン番号を返します。

「画面の座標」とは、図1のように1ドットを単位とした座標です。

例1

pa=$map.getAt(72,56);

▲ 図1の緑枠の部分のキャラクタパターンを返します

図1 :

$map.scrollTo

画面をスクロールします

書式

scrollTo(sx,sy)

• sx
   スクロール方向のx座標
• sy
   スクロール方向のy座標

画面全体を、最初の位置から右方向にsxドット,下方向にsyドットだけずらして表示します。

左や上にずらすには、sx,syを負の値にします。

例1

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

extends SpriteChar;
while(1) {
  $map.scrollTo(t,t);t+=1;
  update();
}

▲ 画面全体を右下にスクロールさせます

参考

スクロールのサンプル

$map.getBGColor

画面の背景色を得ます

書式

getBGColor()

戻り値

画面の背景色

$map.setBGColor

画面の背景色を設定します

書式

setBGColor(col)

• col
   色（通常、colorメソッドで指定)

例1

$map.setBGColor(color(200,255,255));

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

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

LightHashtableクラス

ハッシュテーブルの一種で、処理速度が速い代わりに、キーに文字列が使えません。

使い方はハッシュテーブルの項目を参照してください。

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

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

キーID一覧

getkeyで指定できるキーIDの一覧です。

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

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

Joystickクラス

ジョイスティックの入力を調べます

$Joystick、$Joystick2というオブジェクトが、システムによって自動的に用意されています。

通常は$Joystickを用いますが、2個目のジョイスティックを調べたい場合は$Joystick2を用います。

例1

extends SpriteChar;
while (1) {
  if ($Joystick.up()>0) y=y-2;
  if ($Joystick.down()>0) y=y+2;
  if ($Joystick.left()>0) x=x-2;
  if ($Joystick.right()>0) x=x+2;
  if ($Joystick.button(0)>0) {
    drawText(x,y,"press",$clWhite);
  }
  update();
}

メソッド一覧

Joystick.left

ジョイスティックの左方向が押されているかを調べます。

書式

left()

戻り値

0=押されていない
1=押されたばかり
2以上=押しっぱなし

Joystick.right

ジョイスティックの右方向が押されているかを調べます。

書式

right()

戻り値

0=押されていない
1=押されたばかり
2以上=押しっぱなし

Joystick.up

ジョイスティックの上方向が押されているかを調べます。

書式

up()

戻り値

0=押されていない
1=押されたばかり
2以上=押しっぱなし

Joystick.down

ジョイスティックの下方向が押されているかを調べます。

書式

down()

戻り値

0=押されていない
1=押されたばかり
2以上=押しっぱなし

Joystick.button

ジョイスティックのボタンが押されているかを調べます。

書式

button(n)

• n
   ボタンの番号

戻り値

0=押されていない
1=押されたばかり
2以上=押しっぱなし

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

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

is

オブジェクトが特定のクラスに属しているかを調べます。

書式

式 is クラス名

式で表されるオブジェクトのクラスがクラス名で表されるクラスに属しているならば真(0以外の値)を返します。
また、オブジェクトの属するクラスがクラス名の子クラスである場合も真を返します。

主に、for (xx in $chars)で、特定のクラスのオブジェクトだけを抜き出すのに使います。

例1

for (xx in $chars) 参照

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

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

$InputBoxオブジェクト

テキストを入力するためのウィンドウを表示します

参考：waitInputメソッド

メソッド一覧

$InputBox.open

文字入力用のウィンドウを開きます。

書式

open(title, prompt, default, left, top, width, height) 

• title
   文字入力用のウィンドウのタイトルバーに表示する文字列
• prompt
   プロンプト部分（入力部分のすぐ上）に表示する文字列。改行文字( )を使うと複数行表示できます。(Ver1.12から)
• default
   入力部分にあらかじめ入っている文字列
• left
   ウィンドウの横位置（省略可）
• top
   ウィンドウの縦位置（省略可）
• width
   ウィンドウの幅（省略可）
• height
   ウィンドウの高さ（省略可）

waitInputと異なり、ユーザがボタン（「Ok」 または「キャンセル」）を押すまで処理を中断しません。

ユーザがボタン（「OK」 または「キャンセル」）を押したかは$InputBox.getStatus で調べることができます。
入力された文字の内容は $InputBox.getText で調べることができます。

例1

extends TextChar;
$InputBox.open("名前の入力","あなたは\nだあれ","ななしの　ごんべ");
while ($InputBox.getStatus()==0) {
  text="名前を入力しています..."+$InputBox.getText();
  update();
}
if ($InputBox.getStatus()==1) {  
  text=$InputBox.getText()+"さん、よろしく！";
} else {
  text="キャンセルしました";
}
wait();

$InputBox.getStatus

文字入力用のウィンドウの状態を調べます

書式

getStatus()

戻り値

• 0: 文字入力用のウィンドウが表示されている（＝ユーザからの入力を待っている）
• 1: 「OK」ボタンが押され、ウィンドウが閉じられた
• 2: 「キャンセル」ボタン、または右上の「x」が押され、ウィンドウが閉じられた

例1

$InputBox.open参照

$InputBox.getText

$InputBox.open によって開かれた文字入力用のウィンドウに入力された文字列を調べます。

書式

getText()

戻り値 入力された文字列

例1

$InputBox.open参照

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

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

if

条件にしたがって、手続きを振り分けます。

書式

if (条件) 手続き1 else 手続き2

条件に書かれた計算式の値が、真である場合は手続き1を実行し、偽である場合で、else以降がある場合は手続き2を実行します。

条件式の書き方

条件には、次の形式で条件を書きます。条件が成り立ったときが真です。

複数の条件式の書き方

上記の条件式を複数つなげて、複雑な条件を作ることもできます。
条件が成り立ったときが真です。

{ } の使い方

手続き1または手続き2の部分に、2つ以上の命令（文）書きたい場合、それらを { と } で囲ってください。

例1

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

extends SpriteChar;
while(1) {
  if (x>300) {
    x=0;
    print ("x=0に戻りました");
  } else {
    x=x+1;
  }
  update();
}

▲ 実行すると、オブジェクトが右に移動しますが、x = 300 の地点で左端に戻り、「x=0に戻りました」と表示します。

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

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

Hashtableクラス

複数の値（要素）を入れることが可能なオブジェクトです。各要素へのアクセスにはキーと呼ばれる値を用います。

ハッシュテーブルは、配列のように複数の値（要素）を入れることが可能なオブジェクトです。

配列に入っている要素を参照するときは、「3番目の要素」というように数値を使って要素を参照しましたが、
ハッシュテーブルは、「文字 列"red"に対応する要素」というように任意の値を使って要素を参照できます。
なお、上の例で示した"red"のような、要素を参照するための値をキーと呼びます。

例1

Colors.tonyu

extends SpriteChar;
wait();

HashTester.tonyu

extends SpriteChar;
green=appear(new Colors(100,300,3));
yellow=appear(new Colors(150,300,5));
red=appear(new Colors(200,300,7));

h=new Hashtable(); // ハッシュテーブル作成
h.put("あか",red); // キー "あか" にオブジェクト red を割り当てる
h.put("きいろ",yellow); // キー "きいろ" にオブジェクト yellow を割り当てる
h.put("みどり",green); // キー "みどり" にオブジェクト green を割り当てる

s="あか";
while (1) {
  s=waitInput("いろ？","あかorみどりorきいろ",s);
  target=h.get(s); // sをキーとして要素(green,yellow,red、またはnull)をとりだす。
  if (target!=null) target.y-=16;
  update();
}

メソッド一覧

Hashtable.get

ハッシュテーブルから指定されたキーに対応する値を取り出します

書式

get(key)

• key
   キー

戻り値

ハッシュテーブルにおけるキーkeyに対応する値

Hashtable.put

ハッシュテーブルにキーと値の組を追加します。

書式

put(key,value)

• key
   追加するキー
• value
   キーに対応する値

ハッシュテーブルのキー keyに 値value を設定します。
すでに同じキーがハッシュテーブルにある場合、そのキーに対する新しい値を設定します。

Hashtable.iterator

ハッシュテーブルに格納されているキーや値をすべて調べるためのオブジェクト(イテレータ)を作成します。

書式

iterator()

戻り値

ハッシュテーブルのイテレータ

イテレータに対しては hasNextメソッド, nextKeyメソッド, nextValueメソッドを呼ぶことができます。

例1

extends SpriteChar;
h=new Hashtable();
h.put("国語",40);
h.put("英語",70);
h.put("数学",50);
y=20;
$panel.drawText(20,y,"科目",$clWhite);
$panel.drawText(100,y,"成績",$clAqua);
y+=30;sum=0;
it=h.iterator(); // hのイテレータを作成
while (it.hasNext()) { // 次の要素がある間は
  k=it.nextKey(); // 次のキー（科目）を取り出す
  score=h.get(k); // キーに対応する値（科目の点数)をとりだす
  sum+=score;
  $panel.drawText(20,y,k,$clWhite); // キー(科目)を表示
  $panel.drawText(100,y,score,$clAqua); // キーに対応する値(点数)を表示
  y+=30;
}
$panel.drawText(20,y,"合計",$clWhite);
$panel.drawText(100,y,sum,$clGreen);
y+=30;
$panel.drawText(20,y,"平均",$clWhite);
$panel.drawText(100,y,trunc(sum/h.size()),$clYellow);
y+=30;

Hashtable.remove

ハッシュテーブルからキーとそれに対応する値を削除します。

書式

remove(key)

• key
   削除するキー

戻り値

削除したキー

ハッシュテーブルhからキーkeyとそれに対応する値を削除します。

Hashtable.size

ハッシュテーブルに格納されているキーの数(=値の数) を返します。

書式

size()

戻り値

ハッシュテーブルに格納されているキーの数

Hashtable.hasNext

イテレータからnextKeyメソッドやnextValueメソッドを使って取り出せる組が残っているか調べます。

書式

hasNext()

戻り値

イテレータから取り出せる項目が残っている場合 1、 残っていない場合 0

Hashtable.nextKey

イテレータから次の組を取り出し、取り出した組のキーを返します。

書式

nextKey()

戻り値

イテレータから取り出した組のキー

※このメソッドとnextValueメソッドは一緒に使わないことを推奨します。

Hashtable.nextValue

イテレータから次の組を取り出し、取り出した組の値を返します。

書式

nextValue()

戻り値

イテレータから取り出した組の値

※このメソッドとnextKeyメソッドは一緒に使わないことを推奨します。

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

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

$osPlatformId、$osMajorVer、$osMinorVer、$osBuildNumber

(1_29_2021_0501以降)　$osBuildNumberは1_29_2021_1212以降

Windowsのバージョンを返します。

Tonyuを実行しているWindowsのバージョンを判定できます。

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

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

$fullScreen

フルスクリーンで起動した場合1、ウィンドウモードで起動した場合0が入っています。

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

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

FrameManagerクラス

１フレームに毎に特別な処理を行いたい場合に使うオブジェクトです

• フレームマネージャは１ページに１個しか作成できません
• 作成されたフレームマネージャは、作成したときの名前に関係なく$frameManagerというグローバル変数から参照することができます。

フレームマネージャには次の３つのメソッドを定義してください。

• onStart
• onBeforeMove
• onAfterMove

これらのメソッドは、次に示すようなタイミングで呼ばれます。

フレームマネージャの動作

実行開始
   ↓
onStartを呼び出す
   ↓
 *フレーム開始
   ↓
onBeforeMoveを呼び出す
   ↓
各オブジェクトが動作する
   ↓
onAfterMoveを呼び出す
   ↓
各オブジェクトを描画する
   ↓
フレーム終了。*フレーム開始 へ戻る 

例1

FrameTest.tonyu

extends FrameManager;
function onStart() {
  print("スタート");
}
function onBeforeMove() {
  ctemp=0; // TestObjの個数カウンタをリセット
}
function onAfterMove() {
  count=ctemp;
  drawText(x,y,"TestObj の個数: "+count,$clWhite);
}

TestObj.tonyu (2,3個置いてみましょう)

extends SpriteChar;
vx=rnd(6)-3;
vy=rnd(6)-3;
while (screenOut()==0) {
  $frameManager.ctemp++; // TestObjの個数カウンタ増やす
  x+=vx;y+=vy;
  update(); 
}

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

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

$_fps, $_rps

(1_29_2021_0501以降)

• $_fps
  FPS（Frame per Second）
  １秒あたりの描画回数を実数で格納されています

• $_rps
  RPS（Run per Second）
  １秒あたりの実行回数を実数で格納されています

パフォーマンスウィンドウに表示されている、FPSとRPSの値が実数で格納されます。
約１秒ごとに更新されます。

例1

extends SpriteChar;
while (1) {
  drawText(10, 10, "FPS: "+trunc($_fps+0.5)+"."+(($_fps+0.5)*10%10), $clWhite);
  drawText(10, 30, "RPS: "+trunc($_rps+0.5)+"."+(($_rps+0.5)*10%10), $clWhite);
  update();
}

$_fpsと$_rpsは実数で返されるので、例えばパフォーマンスウィンドウに「FPS=60.0」と表示されている場合は、
59.999641418457 のように返されます。

例1では、パフォーマンスウィンドウの、FPS・RPSと同じ値を表示しています。
パフォーマンスウィンドウのFPSとRPSの値は、小数点第２位以下を四捨五入して表示しています。

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

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

for

※ for文は、ここに示したもののほかにfor..inという文もあります。

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

書式

for (初期化文; 条件; カウント文) 手続き

次のwhile文と同じ動作をします。

書式

初期化文
while (条件) {
  手続き
  カウント文
}

主に、次の形式で使います

書式

for ( xxx = 初期値 ; xxx < 終了値+1 ; xxx+=増分 ) 手続き
または
for ( xxx = 初期値 ; xxx < 終了値+1 ; xxx++ ) 手続き

xxxは、ループに使う変数です。
変数xxxを 初期値 から 終了値 まで、１づつ、または増分 づつ増やしながら手続きを行います。

例1

extends SpriteChar;
for (i=0; i<60; i++) {
   drawText(x, y, i, $clWhite);
   update();
}

▲ i を 0 から59 まで表示したあと、消滅します。

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

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

for..in

配列のすべての要素に対して処理を行います。

特に、for (xx in $chars)は、画面上のオブジェクトをすべて調べるのに用います。

書式

for (b in a) 手続き

• aで示される配列オブジェクトが持っている要素のうち、最初の要素を変数bに代入し 手続きを実行します。
• その後、aの2番目の要素を変数bに代入し、同様に手続きを実行します。
• 3番目、4番目についても同様に処理を行い、最後の要素まで処理を行ったら文全体が終了します。

※ 処理中にaに対してArray.addやArray.deleteなどの処理を行うと処理が正しく実行されません

例1

Arrayクラスを参照してください

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

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

for (xx in $chars)

画面上のすべてのオブジェクトに対して処理を行います

書式

for (変数名 in $chars) 処理

変数名で表される変数に画面上のオブジェクトを順番に代入していき、処理を行います。

例1

Enemy.tonyu

extends SpriteChar;
while (1) {
  y=y+1;
  update();
}

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;
  for (e in $chars) {
    if (e is Enemy && crashTo(e)) die();
  }
  update();
}

▲ Jikiは、画面上のEnemyクラスのオブジェクトeのうちのどれかに対して、 crashTo(e)が成立すればdie();を呼び出します。
すなわち、Enemyクラスのいずれかに当たると死亡します。

例2

新たにEnemy2を増やして、別クラスの当たり判定を増やす場合です。

以下は悪い例です。

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;
  for (e in $chars) {
    if (e is Enemy && crashTo(e)) die();
  }
  for (e in $chars) {
    if (e is Enemy2 && crashTo(e)) die();
  }
  update();
}

▲ for (e in $chars) を２回実行しています。これでも判定はできますが、
全オブジェクトを２回判定しているので、オブジェクトが増えると処理落ちしやすくなってしまいます。
これにEnemy3, Enemy4, ... などと増やしていくと、ちょっとオブジェクトを増やしただけで、かなり重くなるかもしれません。

以下の実装の方が処理が軽くなります。

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;
  for (e in $chars) {
    if (e is Enemy || e is Enemy2) {
      if (crashTo(e)) {
        die();
      }
    }
  }
  update();
}

▲ この書き方であれば、for (e in $chars) は１回だけで済むので、判定処理が軽くなります。

関連

• is

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

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

FileWriterクラス

ファイルにデータを書き出します。

※ ファイルについてはファイルの扱いについてを参照してください

例1

1. オブジェクトを作成し、次のようなコードを書いて実行します。
2. 現在開いているページのフォルダのなかにある filesというフォルダを開きます。
3. filesフォルダにあるtest.txtという テキストファイルを開きます

extends SpriteChar;
a=new FileWriter("test.txt");
a.writeLn("ファイル出力");
a.writeLn(1+1);
a.writeLn("終了");
a.close();

メソッド一覧

FileWriter.close

ファイルの読み込みを終了します。FilerWriterオブジェクトを使ったら最後に必ず呼び出してください。

書式

close()

FileWriter.write

ファイルへ１バイトを書き出します。

書式

write(d)

• d
   書き出す1バイト分のデータ。

FileWriter.writeStr

テキストファイルへ文字列を書き出します。

書式

writeStr(s)

• s
   書き出す文字列

FileWriter.writeLn

ファイルに文字列を書き出し、最後に改行をいれます。

書式

writeLn(s)

• s
   書き出す文字列

FileWriter.error

ファイルの書き込み時にエラーが発生したかを調べます。

書式

error()

戻り値

エラーなら１。エラーでなければ０

他のアプリケーションがファイルを使っていたり（共有違反）、ディスクの調子が悪い時などにエラーになります。

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

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

FileReaderクラス

ファイルからデータを読み込みます。ファイルについてはファイルの扱いについてを参照してください

例1

1. 現在開いているページのフォルダのなかにfilesというフォルダを作ります。
2. filesフォルダにtest.txtというテキストファイルを置きます。
3. test.txtに数行なにかかいておきます。
4. メニューの「ウィンドウ」＞「コンソール」でコンソールウィンドウを表示します。
5. オブジェクトを作成し、次のようなコードを書いて実行します。
6. コンソールにファイルの内容が表示されます。

extends SpriteChar;
a=new FileReader("test.txt");
eof=0;
while (!eof) {
  l=a.readLn();
  if (l==null) eof=1; else print (l);
}
a.close();

メソッド一覧

FileReader.read

ファイルから１バイトを読み込みます。

書式

read()

戻り値

読み込んだ1バイト分のデータ。ファイルの終わりに達している場合はnull

FileReader.eof

ファイルの終わりに達しているかを調べます。

書式

eof()

戻り値

ファイルの終わりに達している場合、0以外の値、そうでない場合0

FileReader.close

ファイルの読み込みを終了します。FileReaderオブジェクトを使ったら最後に必ず呼び出してください。

書式

close()

FileReader.readLn

テキストファイルから１行を読み込みます。

書式

readLn()

戻り値

読み込んだ文字列。改行コード(rおよび )は含まない。
ファイルの終わりに達している場合はnull

改行コードはWindowsスタイル、UNIXスタイルどちらでも読むことができます。

FileReader.error

ファイルの読み取り時に、エラーが発生したかを調べます。

書式

error()

戻り値

エラーなら１。エラーでなければ０

エラーは、指定されたファイルがない場合や、他のアプリケーションがファイルを使っていたり（共有違反）、
ディスクの調子が悪い時などにエラーになります。

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

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

ファイルの扱いについて

FileReaderオブジェクト、FileWriterオブジェクト、Array.loadメソッド、Array.saveメソッドを用いると、
ファイルに対する読み込み、書き込み操作ができます。

セキュリティの観点から、Tonyuで扱えるファイルは、次のディレクトリにあるファイルのみです。

(現在のページフォルダ)\files\

例えば、現在開いているページが

C:\My Documents\Tonyu\test\index.cmml

の場合、読み書きできるファイルは、フォルダ

C:\My Documents\Tonyu\test\files\

にあるファイルのみです。

注意

• filesフォルダの中にサブフォルダを作成することはできません。
• FileWriter,FileReaderオブジェクトでファイル名を指定する場合、ドライブ名やフォルダの区切り文字は除去されます。
• FileWriterオブジェクトは、filesフォルダが存在しない場合はこれを自動的に作成します
• ページフォルダに"files"という名前のファイル（フォルダではない）があるとファイルは扱えません

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

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

extends

親クラスを設定します。親クラスを設定すると、親クラスの持っているすべての変数およびメソッドを利用できるようになります。

書式

extends クラス名;

• extendsはかならずファイルの先頭に書いてください。
• クラス名で指定されたクラスを親クラスにします。

例1

Enemy.tonyu

extends SpriteChar;
function atariHantei() {
   if (crashTo($Jiki)) $Jiki.die();
}

Teki1.tonyu

extends Enemy;
while (1) {
    x=x+1;
    atariHantei();
    update();
}

Teki2.tonyu

extends Enemy;
while (1) {
    y=y+1;
    atariHantei();
    update();
}

Jiki.tonyu (オブジェクト名は$Jikiにします)

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();
}

Teki1,Teki2 からatariHanteiを呼び出していますが、atariHanteiは親クラスのEnemyで定義されています。

このように同じメソッドを複数のクラスで使うときは親クラスを設定すると便利です。

特に、atariHanteiの内容を変更するときに、各クラスに同じメソッドが複数のクラスにあると、
すべてのメソッドを変更する必要がありますが、親クラスに定義すれば１箇所のみの変更ですみます。

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

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

DxCharクラス

DxCharクラスのオブジェクトは、ビットマップパターンの半透明、回転拡大縮小表示が可能です

変数

• x
   オブジェクトのx座標を表します。xの値が大きくなるほど右に移動します。
• y
   オブジェクトのy座標を表します。yの値が大きくなるほど下に移動します。
  （※数学などでは、yが大きいほど上ですが、逆向きになります）
• p
   表示するキャラクタパターンの番号を表します。
   キャラクタパターンと番号との対応は、キャラクタパターンウィンドウを参考にしてください。
• f
   fに１を代入すると、キャラクタパターンの左右を反転します。0を設定すると反転をやめます。
• zOrder
   この値が小さいほど、オブジェクトを手前に表示します。
• scaleX
   オブジェクトの拡大率を指定します。
   scaleyが未定義または0の場合、縦横比は1のままです。
• scaley
   scaleyを指定すると、横をscaleX倍、縦をscaley倍拡大します。
• angle
   オブジェクトの回転を指定します。単位は度で右回りです。
• alpha
   オブジェクトの透明度を指定します。
   255が完全に不透明で、減らすにしたがって透明になっていきます。
   0にすると見えなくなります。

メソッド一覧

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

DxChar.newAnimation

新規AnimationAdaptorを作成します。

書式

newAnimation()

戻り値

新規作成されたAnimationAdaptor

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

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

$displayWidth, $displayHeight

(1_29_2021_0501以降)

モニターの解像度を取得します。

$displayWidth には横のピクセル数、
$displayHeight には縦のピクセル数が格納されています。

※ Windows 8.1, 10などで、ディスプレイ設定のスケーリングが100%以外に設定されている環境では、
  仮想のピクセル数となります。

$_displayRealWidth, $_displayRealHeight

(1_29_2021_0630以降)

実際の解像度は、下記の変数に格納されています。

• $_displayRealWidth
• $_displayRealHeight

ディスプレイ設定のスケーリング設定には影響されません。

$_displayFrequency

(1_29_2021_0630以降)

モニターのリフレッシュレート（周波数）を取得します。

例えば、60Hzの設定であれば60が返ります。

$_displayColor

(1_29_2021_0630以降)

モニターの色数を取得します。

例えば、32bit色の設定であれば32が返ります。

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

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

注釈

注釈は、プログラムの実行に影響を与えない文字列です。

• // から行の最後までが注釈になります
• /*　から　 */ まで（行をまたいでも）も注釈になります

例1

extends SpriteChar;
/* サンプル
　　プログラム */
while(1) {
  x=x+1; // 横移動
  update(); // 1フレームすすめる
}

▲ 緑色の部分が注釈です

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

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

CheckBoxクラス

チェックボックスを作成します

例1

extends CheckBox; // 必ずCheckBoxを親クラスにしてください

a=new Array();
a.add("OFF");a.add("OFF");a.add("OFF");a.add("OFF");a.add("OFF");a.add("OFF");
init(6);
while(1) {
  if (create(60,120,0,$clBlack)==1) a.set(0,"ON"); else a.set(0,"OFF");
  if (create(60,140,1,$clRed)==1) a.set(1,"ON"); else a.set(1,"OFF");
  if (create(60,160,2,$clGreen)==1) a.set(2,"ON"); else a.set(2,"OFF");
  if (create(110,120,3,$clYellow)==1) a.set(3,"ON"); else a.set(3,"OFF");
  if (create(110,140,4,$clPink)==1) a.set(4,"ON"); else a.set(4,"OFF");
  if (create(110,160,5,$clWhite)==1) a.set(5,"ON"); else a.set(5,"OFF");
  drawText(75,120,a.get(0),$clBlack,10);
  drawText(75,140,a.get(1),$clBlack,10);
  drawText(75,160,a.get(2),$clBlack,10);
  drawText(125,120,a.get(3),$clBlack,10);
  drawText(125,140,a.get(4),$clBlack,10);
  drawText(125,160,a.get(5),$clBlack,10);
  update();
}

メソッド一覧

CheckBox.init

チェックボックス作成の準備をします

書式

init(n)

• n
   作成するチェックボックスの数

CheckBox.create

チェックボックスを作成します

書式

create(x,y,number,color,zOrder)

• x
   チェックボックスのx座標
• y
   チェックボックスのy座標
• number
   チェックボックスのID (0-N)
   N=initで指定した個数-1
• color
   色
• zOrder
   表示順序

作成前に必ずinitメソッドを呼んでください

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

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

break

while文、for文のループを抜け出します。

また、switch文の{}内を抜け出します。

例1

extends SpriteChar;
while (x<300) {
  x=x+1;
  if (getkey(32)) break;
  update();
}

▲ xが300になるまで右に移動しますが、途中でスペースキーをおすとただちにループを抜け出し、オブジェクトが消滅します。

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

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

代入

代入とは、変数の値を設定することです。 =演算子を用いて変数へ値を代入します。

書式

変数名 = 式;

例1

//オブジェクトを作成し、ダブルクリック後つぎのように入力します。 
extends SpriteChar;
x=200;
y=100;
wait();

▲ 変数 x に 200 という値が入り、同様に yに100 が入ります。

Tonyuでは、変数xとy によってそのオブジェクトの位置を表します。
この例では、画面上から100 ドット目、左から200ドット目にオブジェクトが移動します。

x,yの値を確認することもできます。
実行中にオブジェクトをクリックし、オブジェクトインスペクタでx,yの値を確認します。

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

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

演算代入

代入、算術演算の箇所で説明した機能で、代入や計算は一通りできますが、ここで説明する演算子を使うとプログラムが簡潔になり、処理速度も上がります。

+= , -= 演算子

書式

変数名 += 式;
変数名 -= 式;

それぞれ、

変数名 = 変数名 + 式 ;
変数名 = 変数名 - 式 ;

と同じ効果があります。変数名で示される変数の値を式の値だけ増やしたり減らしたりできます。

例1

//オブジェクトを作成し、ダブルクリック後つぎのように入力します。
extends SpriteChar;
while (1) {
  x+=2;
  update();
}

▲ x+=2; は x=x+2; と書いても同じですが、x+=2のほうが処理速度が上がります。

++ , -- 演算子

書式

変数名 ++;
変数名 --;

それぞれ、

変数名 = 変数名 + 1;
変数名 = 変数名 - 1;

と同じ効果があります。変数名で示される変数の値を1増やしたり減らしたりできます。

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

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

Arrayクラス

Array(配列)クラスのオブジェクトには、複数の値（要素）を格納することができます。

例1

予めコンソールウィンドウを表示しておいてください

extends SpriteChar;
a=new Array(); // 配列の作成
a.add("orange");
a.add("apple");
print("要素数="+a.size());
print("1番目の要素は"+a.get(0));
print("2番目の要素は"+a.get(1));
 
a.insert(1,"banana");
a.set(0,"grape");
print("要素数="+a.size());
print("1番目の要素は"+a.get(0));
print("2番目の要素は"+a.get(1));
print("3番目の要素は"+a.get(2));
 
a.delete(2);
print("全要素のリスト");
for (b in a) {
  print(b);
}
a.save("result.txt"); 
// files\result.txt に
// 配列の内容が保存されます。

特殊構文

for..in

メソッド一覧

Array.add

配列に要素を追加します

書式

add(e)

• e
   追加する要素

Array.insert

配列の途中に要素を挿入します

書式

insert(index,element) 

• index
   挿入する場所。(先頭:0 末尾:size()-1)
• element
   追加する要素。

Array.get

配列の要素を取り出します

書式

get(i)

• i
   取り出す要素のインデックス(先頭:0 末尾:size()-1)

戻り値

i番目の要素

Array.set

配列の要素に値を代入します

書式

set(i,e)

• i
   代入される要素のインデックス(先頭:0 末尾:size()-1)
• e
   代入する要素

Array.size

配列の要素数を返します

書式

size()

戻り値

配列の要素数

Array.delete

配列から要素を削除します

書式

delete(i)

• i
   削除する要素のインデックス(先頭:0 末尾:size()-1)

戻り値

削除した要素

※インデックスがわからない場合はremoveメソッドが便利です

Array.indexOf

配列における要素のインデックスを返します。

書式

indexOf(e)

• e
   インデックスを調べる要素

戻り値

この配列における 要素eのインデックス。インデックスが複数の場合は最小のもの。
要素eが配列にない場合-1

Array.lightIndexOf

indexOfメソッドを高速化したものですが、要素が文字列の場合は使えません。

書式

lightIndexOf(e)

• e
   インデックスを調べる要素(文字列は使えません)

戻り値

この配列における、要素eのインデックス。インデックスが複数の場合は最小のもの。
要素eが配列にない場合は-1

Array.remove

配列の要素を削除します

書式

remove(e)

• e
   削除する要素

deleteメソッドと異なり、削除したい要素を引数に指定します

Array.clear

配列の内容をすべて消去します。

書式

clear()

Array.load

テキストファイルから配列の内容を読み込みます。

書式

load(fn)

• fn
   ファイル名

読み込めるファイルについては、ファイルの扱いについてを参照してください。

loadメソッドは、配列の内容をクリアしたあと、テキストファイルの１行につき１つの要素を追加します。
各要素の内容は行の内容を表す文字列です。

Array.save

配列の内容をテキストファイルに保存します。

書式

save(fn)

• fn
   ファイル名

ファイルの保存先については、ファイルの扱いについてを参照してください。

saveメソッドは、配列の要素を先頭から順に、１行ずつ出力したものをファイルに保存します。
要素が文字列の場合、その内容をそのまま出力し、 文字列でない場合、要素の文字列表現を出力します。

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

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

算術演算

足し算、掛け算など算術演算を行います。

書式

式1 + 式2
式1 - 式2
式1 * 式2
式1 / 式2
式1 % 式2

• + : 足し算 (式1 + 式2)
• - : 引き算 (式1 - 式2)
• * : 掛け算 (式1 × 式2)
• / : 割り算 (式1 ÷ 式2)
• % : 剰余 (式1 を 式2で割った余り)

例1

//オブジェクトを作成し、ダブルクリック後つぎのように入力します
extends SpriteChar;
x=100+20;
y=30*2;
wait();

▲ 変数 x に 100+20 の 計算結果 120 が入り、同様に yに60 (=30*2) が入ります。

例2

extends SpriteChar;
x=200;
y=x-50;
wait();

▲ 変数 x に 200 が入ります。 また y には x-50 = 200-50 = 150 が入ります。

例3

extends SpriteChar;
while (1) {
  x=x+1;
  update();
}

▲ while文により、x=x+1 が繰り返されます。
x=x+1 は、変数 x に、(現在の x の値) +1 が入ります。 結果として、x の値が1 増加します。

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

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

AnimationAdaptorクラス

AnimationAdaptorとは、キャラクタパターンを次々に変化させることによるアニメーションを簡単に実現するためのオブジェクトです。

ここでは、図1のようなキャラクタを用意して、オブジェクトを歩かせる処理を考えます。

図1：

まず簡単な例を示します。次のオブジェクトは、キャラクタパターン$pat_chars+0と$pat_chars+1を５フレームごとに交互に表示します。

例1

extends SpriteChar;
a=newAnimation();
a.loop($pat_chars+0,$pat_chars+1,5);
wait();

※ newAnimationメソッド, loopメソッドの説明も参照してください。

次のオブジェクトは、カーソルキーを使って歩きながら移動するオブジェクトです。

例2

extends SpriteChar;

a=newAnimation();
while(1) {
  a.pause(); // 動いていないときはアニメーションを止める。
  // 各カーソルキーが押されたとき、アニメーションを設定する。 左右移動の場合fによって向きも指定する。
  if (getkey(39)>0) {a.loop($pat_chars+2,$pat_chars+3,3); f=0; x+=3;}  
  if (getkey(37)>0) {a.loop($pat_chars+2,$pat_chars+3,3); f=1; x-=3;} 
  if (getkey(40)>0) {a.loop($pat_chars+0,$pat_chars+1,3); y+=3;}
  if (getkey(38)>0) {a.loop($pat_chars+4,$pat_chars+5,3); y-=3;}
  update();
}

※ アニメーションさせるコマ数が３つ以上の場合、最初のパターンを１番目の引数、最後のパターンを２番目の引数に指定します（途中のパター ンは指定しません）

メソッド一覧

AnimationAdaptor.play

指定したアニメーションを１回だけ実行します。

書式

play(from,to,spd) 

• from
   アニメーションの最初のキャラクタパターン
• to
   アニメーションの最後のキャラクタパターン
• spd
   アニメーション速度( spdフレームにつき1パターン進む 。 1が最速 )

例1

extends SpriteChar;
anim=newAnimation();
anim.play($Pat_Bomb+3,$Pat_Bomb+6,3);
wait();

▲ このオブジェクトは、図1ように$Pat_Bomb+3から$Pat_Bomb+6までを順番に表示します。

AnimationAdaptor.loop

指定したアニメーションを繰り返し実行します。

書式

loop(from,to,spd) 

• from
   アニメーションの最初のキャラクタパターン
• to
   アニメーションの最後のキャラクタパターン
• spd
   アニメーション速度( spdフレームにつき1パターン進む 。 1が最速 )

例1

extends SpriteChar;
anim=newAnimation();
anim.loop($Pat_Sample+4,$Pat_Sample+6,3);
wait();

▲ このオブジェクトは、図1のように$Pat_Sample+4から$Pat_Sample+6までを順番に表示し、再び$Pat_Sample+4に戻るという動作を繰り返 します。

AnimationAdaptor.swing

アニメーションを繰り返し実行します。指定したパターンの間を往復するアニメーションを実行します。

書式

swing(from,to,spd)

• from
   アニメーションの最初のキャラクタパターン
• to
   アニメーションの最後のキャラクタパターン
• spd
   アニメーション速度( spdフレームにつき1パターン進む 。 1が最速 )

例1

extends SpriteChar;
anim=newAnimation();
anim.swing($Pat_Sample+4,$Pat_Sample+6,3);
wait();

このオブジェクトは、次の順番でパターンを切り替えます、この動作を繰り返します。

$Pat_Sample+4 → $Pat_Sample+5 → $Pat_Sample+6 → $Pat_Sample+5 → 再び$Pat_Sample+4...

AnimationAdaptor.pause

アニメーションを一時停止します。

書式

pause()

AnimationAdaptor.resume

pauseメソッドで停止したアニメーションを再開します。

書式

resume()

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

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

angle,sin,cos,distの関係

angle、sin、cos、distの間には次のような関係が成り立ちます。

• d =dist(dx,dy)
• a =angle(dx,dy)
• dx=cos( a )* d
• dy=sin( a )* d

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

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

AbstractHashtableクラス

Hashtable、LightHashtableの親クラスです。

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

Wikiトップ

命令リファレンス

命令リファレンス:用途別

文法

代入 算術演算 演算代入 変数 .演算子
if while break switch 注釈(コメントアウト)
for for..in for (xx in $chars)
メソッドの呼び出し メソッドの定義 return
extends is
this null

グローバル変数一覧