Tonyu System 1 - wiki

Tonyu System 1

2001-2024 (c) Hoge- Ship
https://www.tonyu.jp/

最新版 - Version 1.303（2024-02-17）

• Tonyu1とは
• ダウンロード

• まずはゲームをやってみる - Tonyuでこんなことができます。
• チュートリアル - とりあえずゲームを作ってみたい方はこちらから
• 各種ウィンドウの使い方/オプション
• 命令リファレンス
• エラーメッセージ
• FAQ

• Tonyu Systemについて
• 謝辞

Wikiトップ

まずはゲームをやってみる

Tonyuはアクションゲームを作ることができます。まずどんなゲームができるのか、サンプルゲームをやって確かめてみましょう。

起動画面の「最近使ったファイル：」のどれか１つをクリックしましょう

しばらくすると、ゲーム画面が開きます。ここで F9を押すとゲーム開始です。

• どのゲームも基本的に使用するのはマウスおよびカーソルキー、スペースキーのみです
• F3でポーズがかけられます。
• F2でゲーム終了です。リプレイは F9です

他のゲームをやるには、「ファイル」＞「メインメニュー」でメニューを表示させてください。

Wikiトップ

Wikiトップ

エラーメッセージ

プログラムに書き間違えがあったり、実行中に異常な動作をした場合は、次のようなエラーメッセージが表示されます。

エラーが発生するとエディタが表示され、エラーが起きた場所にカーソルが移動するので、原因を調べてプログラムを訂正してください。

コンパイルエラー

コンパイルエラーは、ページを読み込んだ時や、実行させようとしたときに発生するエラーです。

• 「文法エラー」 文法が正しくありません。例えば文の末尾にセミコロン(;)がないなどです。
• 「関数xxxは未定義です」
  呼び出そうとしている関数は定義されていません。関数の綴りが間違っていないか調べてみましょう。

例1

//--ファイルClassA.tonyu--
extends Object;
function test(p) {
 print(p);
}
testo(p);  // 関数testoは未定義です
//--ClassA.tonyu終わり--

• 「循環参照があります」
  クラスの親子関係が不正です。例えば、 ClassAがClassBの親クラスで、かつClassBがClassAの親クラス であってはいけません。

実行時エラー

実行時エラーは、プログラム実行中に発生するエラーです。

• 「xxxはオブジェクトではないため、関数yyyを呼び出せません」 a.method1(); のように、他のオブジェクトのメソッドを呼び出そうと していますが、aの値がオブジェクトでない（数値やnull）ため メソッドを呼べません。
  aの値がおかしくなっていないか調べましょう。
  aの綴りが間違っている場合がよくあります。綴りが間違った変数はnullとみなされます。

例2

a=0;
a.run();  // 0はオブジェクトでないため、関数runを呼び出せません

• 「リストのインデックスが範囲を超えています(xx)」 Array型オブジェクトにおいてget,setメソッドなどをもちいたアクセスを行った場合に、要素を指定するための番号(添字)が範囲外です

例3

a=new Array();
a.add("apple");a.add("orange");
b=a.get(3);  // 配列aの要素は２つ（添字は0,1)なのに、添字の番号が3

その他のエラー

• 「モジュールxxxxxのアドレスyyyyでzzzzへの読み込み（書き込み）違反がおきました」
• 「参照カウントが負になりました」

メソッドの呼び出しが無限に行われると発生する場合があります。

例4

function test(x) {
  print (x);
  test(x+1); // 永久にtestが呼ばれる
} 
test(3);

それ以外の原因としては、Tonyuシステム自身のバグが考えられます。
その際は申し訳ありませんが、Tonyuを再起動してください。

Wikiトップ

Wikiトップ

Tonyu1のダウンロード

注意

• ランタイム等に上書き更新する場合は、下記方法で更新してください。（Player.exeを上書きしただけだと、エラーが発生する可能性があります）
  • ランタイムの更新方法
• 古いTonyu1のゲームで、Windows10,8等で起動しない場合は、最新版に更新すると起動します。
  • ランタイムの更新方法
• ver1.29～1.30で仕様変更があり、以前のバージョンと動作が違う場合は、下記を設定してください。
  • 互換性の設定
• Windows10でメニューが文字化けする場合、Windows上の設定「ワールドワイド言語サポートでUnicode UTF-8を使用」を解除してください。
  • 「コントロールパネル」→「時計、言語、および地域」→「地域と言語」→「管理」タブ→「システム ロケールの変更」→「ワールドワイド言語サポートでUnicode UTF-8を使用」のチェックを外す

ダウンロード

最新バージョン

Tonyu1_303_2024_0217.zip

• $mplayer.stopSEの不具合修正

以前のバージョン

Tonyu1_302_2024_0212.zip

• デフォルト値変更
  • $mplayer.setVolumeLimiter　音割れを防ぐ機能
    • 1(有効)→0(無効)
  • $System.setLoopMode　ゲームループ
    • 2→1 (mmtimer Loop)
    • 2は廃止
  • $mplayer.setSeStopEnable　$mplayer.stopSEの有効・無効設定
    • 1(有効)→0(無効)
• ネットランキング
  • URLに「https」も使えるよう修正
  • ネットランキングcgiを最近のPerlで動くように修正
• 処理軽量化
• $mplayer.setSoundPlayMode(4)で効果音ならなくなる不具合修正
• 細かい不具合修正

Tonyu1_301_2022_0916.zip

（2024-02-08 更新）プレリリース版だったものを最新版としてリリース

• 細かい修正
  • wavの再生処理を軽量化
    • stopSE無効＆volumeLimiter無効の場合に、処理軽量化するよう実装
    • モノラルwavしかないときはモノラル再生にして軽量化
  • mzoでpcm(wav)音源が上手くならないのを修正（Tonyu1.30で発生）
  • 速いCPUでloopMode==0&&sleepTime==0の時、mzoの音が伸びたような音になるので修正
  • loopMode==0&&sleepTime==0の時、非アクティブになってもスリープがかからないので修正
  • loopMode==2を追加し、デフォルト値に設定
    • loopMode==0(Busy Loop)とほぼ同じだが、FPSが維持できているときはsleepTime=1、FPSが維持できなくなるとsleepTime=0にする
  • エディタのインデント挙動修正・インデント高速化

Tonyu1_30_2022_0804.zip

• 主な変更
  • 効果音を途中停止する$mplayer.stopSEを追加
  • オブジェクト大量生成時の点滅防止ライブラリ（スーパープロセッサ）を導入（デフォルト有効）
  • wavのステレオ対応・音質向上
    • 44100Hz8bitモノラル相当 → 44100Hz16bitステレオに音質向上
  • wav,mzoの音源をDirectSoundに変更
    • wavのレイテンシが短縮
  • wav,mzoの音量が大きい場合、音割れを防ぐ機能を追加（デフォルト有効）
    • $mplayer.setVolumeLimiterで設定変更
  • ランタイム版で起動時のウィンドウサイズや位置を指定する機能を追加
    • $Options.getEnv, $Options.setEnvを追加
  • switch文の自動インデントに対応
• ver1.30以降に作成したプロジェクトでの仕様変更(targetVersion>=1300の場合)
  • wav,mzoの音量が100%になるよう変更
    • ver1.21～1.29に作られたプロジェクトは、互換性のため音量が50%のままになります
  • スプライト描画の回転(angle)が１回転256段階だったのを36000段階に向上
    • ver1.29以前に作られたプロジェクトでは、互換性のため256段階のままになります
    • $System.setSpriteAngleAccuracyで精度を切り替え可能
  • sin,cosの精度を0～360°で360段階だったのを36000段階に向上
    • ver1.29以前に作られたプロジェクトは、互換性のため360段階のままになります
    • $Math.setSinCosAccuracyで精度を切り替え可能
• 互換性の設定を追加
  • 基本的には設定の必要はありませんが、オプションとして用意しました
  • $Options.setに関連項目を追加
• 仕様変更
  • sleep_timeはビジーループ設定時（$System.setLoopMode(0)）のみ効くよう変更
    • 現在のマルチメディアタイマー動作ではCPU負荷が低く、基本的にsleep_time設定の必要がないため仕様変更
    • どうしても変更したい場合は$System.setSleepTimeMMTで変更できます
  • $mplayer.setDelayは$mplayer.setSoundPlayMode(1or2)に設定時のみ効くよう変更
    • $mplayer.setSoundPlayMode(3)がデフォルト設定であり、自動でDelayを調整できるようになったため仕様変更
    • 手動で変更したい場合は$mplayer.setDelayDsで変更できます
  • $window.setDrawModeはWindows Vista以降で動作時は効かないよう変更
    • Windows Vista以降は描画方式A意外だと、重かったりカクついたりするため、メソッドからは変更できないようにしました
      • どうしても変更したい場合は$window.setDrawModeForceModeで効くように変更できます
    • ウィンドウ上部のメニューから選択した場合は変更できます
    • Windows XP以前では$window.setDrawModeは効きます
• 細かい修正
  • default.tonyuprjにtargetVersionを自動追記する機能追加
    • Tonyuのどのバージョンから対象プロジェクトを使っていたかを記録します
    • 互換性の自動維持の判定に使用されます
    • targetVersionが記録されていない場合、savedVersionの値をコピーする(開発環境版)か、savedVersionの値をtargetVersionとして使います(ランタイム版)
  • $map.scrollToでMap表示がおかしくなる場合があるのを修正
    • Tonyu1_29_2021_0705から発生
    • ゲーム画面サイズが奇数、かつ画面サイズ以上の移動をした後に左上スクロールすると発生
  • wav再生終了直後にノイズがなるのを修正
  • 実行後の初回wav再生で音飛びするのを修正
  • 11025Hz, 22050Hz, 44100Hz以外のwavの再生速度が速くなる不具合を修正
  • 44100Hzを超えるwavを鳴らすとエラー発生する不具合を修正
    • ただし44100Hzを超えるwavを鳴らしても44100Hzの音質で再生されます
  • wavの同時発音数を9→50に変更
  • deactivation_pauseが1の時、タスクバーから最小化した場合、一時停止しない不具合を修正
  • 起動時プロジェクト読み込み中にエラーした場合、以降ウィンドウのメニューが増えなくなるので修正
  • Copyrightの年を更新
• 追加したメソッド一覧
  • $mplayer.stopSE
  • $mplayer.setDelayDs
  • $mplayer.getAutoDelayDs
  • $mplayer.resetAutoDelayDs
  • $mplayer.setSoundPlayMode
  • $mplayer.setBaseVolume
  • $mplayer.setVolumeLimiter
  • $mplayer.setSeLoopEnable
  • $mplayer.setSeStopEnable
  • $Options.getEnv
  • $Options.setEnv
  • $System.setSleepTimeMMT
  • $System.setProcessSingle
  • $System.setLegacyFrameRate
  • $System.setSpriteAngleAccuracy
  • $Math.setSinCosAccuracy
  • $window.setDrawModeForceMode

Tonyu1_29_2021_1212.zip

• 細かい修正
  • マルチメディアタイマーの処理軽量化
  • タイマー分解能変更メソッド追加
    • $System.setTimerResolution
  • ゲームループ変更メソッド追加
    • $System.setLoopMode
  • スタッタリング防止自動調整メソッド追加
    • $System.setAutoAdjustScanLine
• グローバル変数追加
  • Windowsのビルド番号、$osBuildNumberを追加
    • Windows10とWindows11を判定できる
• ネットランキングのURLを更新

Tonyu1_29_2021_0730.zip

• 細かい修正
  • Win98SEでVSyncが効いてないので修正。（リフレッシュレートが取得できないので、60Hzと仮定してVSyncを行う）
  • 内部処理のディスプレイ情報取得を５秒１回に変更

Tonyu1_29_2021_0705.zip

• 既存不具合の修正、細かい修正、処理速度改善など
  • $map.scrollTo()の高速化
    • $map.scrollTo()でスクロール量が多い場合、処理が重いので軽量化
  • 特定のウィンドウサイズでTonyuを終了すると、エラーが大量に出る不具合を修正
    • BBS No.13705に該当
  • 起動中にクリックするとエラーが出る不具合を修正
  • ランタイム作成時Cookies.iniを残さない
    • ランタイムではCookies.iniの設定に関わらず、起動時ステータスバーを表示しないよう変更
  • Tonyu.exeと同じ場所にあるPlayer.exeを動作するように修正
  • 設計中のドラッグ移動・マップ移動を滑らかにした
  • 登録系のリスト削除で、最後の１項目の表示が消えないのを修正
  • 内部のSleep処理のタイミングを変更
  • アプリ終了判定を変更
• グローバル変数追加
  • Tonyuがアクティブ状態か取得する、$windowActiveを追加

Tonyu1_29_2021_0630.zip

• 数時間起動し続けると重くなって、2～4時間後にフリーズまたは強制終了になる不具合を修正（Tonyu1_29_2021_0501限定の不具合）
• FPS・RPS表示の小数第２位を、切り捨てから四捨五入に変更
• VSyncやフレームレート制御を調整
• グローバル変数追加
  • 実際のディスプレイの縦横ピクセル数、$_displayRealWidth, $_displayRealHeightを追加
  • ディスプレイのリフレッシュレート（周波数）と色数、$_displayFrequency, $_displayColorを追加

Tonyu1_29_2021_0501.zip

• フレームレート制御の実装を変更
  • ビジーループ＋Sleepから、マルチメディアタイマーに変更
• CPU使用率を軽減
• ゲーム画面のカクツキ（スタッタリング）軽減（Windows 8以降、Vista～7のAero有効時）
• カクツキ（ティアリング・スタッタリング）対策用のメソッド追加
  • $System.setVSync
  • $System.setAdjustScanLine
• $System.setFrameRateでFPSを小数単位でも指定できるようにしました
  • $System.setFrameRateのFPS制限を廃止
• グローバル変数追加
  • $_fps, $_rps追加（FPSとRPSが実数で取得できる）
  • ディスプレイの縦横ピクセル数、$displayWidth, $displayHeightを追加
  • Windowsのバージョン値、$osPlatformId、$osMajorVer、$osMinorVerを追加
• 効果音のDelayをOS毎に調整
  • XP以前は1350、Vista, 7は2400、8, 8.1は2500、10は3000
• 描画方式のデフォルト設定を、XP以前はB方式、Vista以降はA方式に変更
• ウィンドウの見た目が変化しました
• ランタイムではF3キーで一時停止禁止
• ウィンドウ移動中などでもゲームが止まらなくなりました
• フレームレート(FPS)がより正確になりました
• パフォーマンスウィンドウの変更
  • FPS表示変更、RPS（Run Per Second）（実行速度）の表示追加、SleepTimeの表示
• 非アクティブ時ページロードするとキーが効いてしまうのを防止
• exeにバージョン情報を追加

Tonyu1_28_2021_0407.zip

• Tonyu1_28_2021_0404で発生した不具合を修正
  • Tonyu.exeにcmmlファイルをD&Dや、cmmlファイルを関連付けして開いた時などに、自動的にプロジェクトを開く機能が効かなくなっていたのを修正
  • オプションからサウンドoffにするとエラーが出るのを修正

Tonyu1_28_2021_0404.zip

• switch文の実装
  • switch、case、defaultは変数名等には使えなくなります
• JoyStickの不具合を修正
  • JoyStickを刺して抜いた後、Tonyu1を再起動するとJoyStick取得が重くなる不具合を修正
    • BBS No.12342 に該当
  • JoyStick１つ接続の時、２つ目のJoyStickのボタンも押下しているように取得される不具合を修正
  • getkey()と同じ挙動にしました（getButton()等の取得値は１フレームごとに+1）
• ウィンドウが非アクティブ時の挙動修正
• 効果音のDelayを3000に変更（Vista以降）
• ファイルを開く・保存するダイアログを新しいタイプに変更（Vista以降）
• エディタ編集時、ゲーム側でキーが反応しないように修正
• エディタの30000バイト制限を廃止（Win9x系は制限を残しました）
• 稀にMidi再生・停止が失敗する不具合を軽減
• ウィンドウやUIの大きさ・位置の修正
• 文言の修正、URL・年の更新

Tonyu1_27_2019_1205.zip

• Midiプレイヤーの不具合修正
• Readme.txtの内容更新
• MidiPlay.exeは現在使っていないので削除

Tonyu1_27_2019_0930.zip

• Midiプレイヤー（Kernel/MidiPlayer2.exe）にYellowMusicPlayerを使用するようにしました．

Tonyu1_27_2015_0714.zip

• 描画方式を設定ファイル（Kernel/Cookies.ini）に保存するようにしました

Tonyu1_27_2015_0630.zip

• $InputBox.open で位置と大きさを指定できるようにしました。
• Mathクラスのpow関数で、乗数が整数の場合に誤差が出る不具合を直しました

Tonyu1_27_2015_0213.zip

• Windows8 対応パッチを組み込みました
• Player.exeを小さくしました
• Mathクラスに 指数関数・対数関数を追加しました

Tonyu1_27_2015_0212.zip ←Player.exeが大きいバージョン

Tonyu_patch_for_win8.zip

• (2015/01/10) Window8で起動しない場合，こちらの実行ファイルに差し替えて下さい

Tonyu1_27_2014_0129.zip

• $Options.setの sleep_time の動作を変更：設定値をdefault.tonyuprjには書き込まないようにしました。

Tonyu1_26_2011_0529.zip

• $Options.setに sleep_time を追加

Tonyu1_24_090816.zip

• 同梱のドキュメントをWeb版と同期

Tonyu1_24_080704.zip

• $mplayer.setVolume メソッドを使った際の効果音の不具合を修正

Tonyu1_24_071003.zip

• フルスクリーン時にmoveCursor メソッドの位置がずれる不具合を修正

Tonyu1_24_070903.zip

• $mplayer.setDelayメソッド
• Windows XP ではこの値の規定値は1000， Windows Vista では9000に設定してあります．
• files フォルダ内でサブフォルダ利用可能

Tonyu1_23_070422.zip

• MIDIプレイヤの変更がランタイムに反映されていなかった不具合を修正

Tonyu1_23_070402.zip

• MIDIプレイヤを変更
• プロジェクト作成・選択時にドライブを選択可能

Tonyu1_22_061020.zip

• ヘルプファイルに*.hlp 以外(*.chm等）が指定可能

Tonyu1_22_061004.zip

• ランタイム作成時，フルスクリーンの選択が無効になる不具合を修正

Tonyu1_22_01.exe

• Sprite.fillPolygon を実行後，他のページを開くとTonyuが強制終了する不具合を修正

Tonyu1_22.exe

• $System.setStackSize 追加
• Sprite.fillPolygon 追加
• ドキュメントをリニューアル
• for文，while文中におけるエラー位置の指摘方法を改善

フルスクリーンキット

作成したランタイムをフルスクリーンで動作させることが可能です.

fullscreen0_02.zip

古いバージョン

過去のバージョンアップ履歴

Tonyu1_21Beta.zip
Tonyu1_19Beta.exe
Tonyu1_1903.exe
Tonyu1_1902.zip
Tonyu1_1902.exe
Tonyu1_18_4.exe
Tonyu1_18_3.exe
Tonyu1_18_2.exe
Tonyu1_18.zip
Tonyu1_18.exe
Tonyu1_17Patch.zip
Tonyu1_17.exe
Tonyu1_16Light.exe
Tonyu1_16.exe
Tonyu1_15Light.exe
Tonyu1_15.exe
Tonyu1_14Light.exe
Tonyu1_14.exe
Tonyu1_13Light.exe
Tonyu1_13.exe
Tonyu1_12Light.exe
Tonyu1_12.exe
Tonyu1_11Light.exe
Tonyu1_11.exe
Tonyu1_09Light.exe
Tonyu1_09.exe

M-Two

M-Twoは音楽作成ツールです。MIDIとは異なり、MMLと呼ばれる言語でテキストファイルを作成することで音楽が演奏できます。
演奏される音はMIDIとは一風変わった、ファミコン風味の懐かしい音色です。
作成した音楽を自作のプログラムから使えるドライバMEZONETも用意してあります。

Tonyu System のBGMとして利用できます。

mtz12.zip (Ver 1.2)
mtz11.zip (Ver 1.1)

Wikiトップ

ダウンロード Wikiトップ

過去のバージョンアップ履歴

1.21

• panel.save、 panel.loadメソッドを追加
• $fullScreen 変数を追加
• $Window.setDrawModeメソッド
• スタックオーバーフロー（メソッド呼び出しの繰り返しによるエラー）検知機構追加

1.1903

• MIDIに関する機能を1.17に完全差し戻し

1.19(beta2)

• 1.18に搭載のMIDIに不具合が生じたため、1.17の仕組みと差し替え
• エディタで編集可能なプログラムサイズを30000Bに制限

1.18

• クラスのカテゴリわけ機能を追加
• MIDIの演奏前の待ち時間を削減
• CheckBox 追加
• RadioButton 追加
• $Math 追加
• $TextEditor 追加
• TextChar.edit 追加
• Sprite.centerText, Sprite.drawVerticalText, Sprite.drawPolygon, Sprite.drawRect, Sprite.drawRectDx, Sprite.drawTriangle, Sprite.gradationLine, Sprite.gradationRect, Sprite.gradationText 追加

1.17

• ヘルプ機能をリニューアル
• コード補完機能を追加
• メソッドの定義を任意の場所で可能に
• Object.colorHSLメソッド
• Panel.copyRectメソッド
• Object.amodメソッド
• Sprite.drawBrokenLine、Panel.drawBrokenLineメソッド
• Object.floorメソッド
• Matrixクラス
• Systemクラス

1.16

• ランタイム実行時にフルスクリーンで表示可能に（別途フルスクリーンキットが必要）
• $panel.drawDXSpriteメソッド追加
• $panel.setTransparentColorメソッド追加
• 貼り付け可能なクリップボードデータの上限を4KBに拡張

1.15

• エディタに置換機能を追加
• $panel.setPixel追加
• $windowX/$windowY変数を追加
• $SelectBox.open $SelectBox.getStatus waitSelectメソッド(はい・いいえ選択ダイアログ)追加
• $map.getBGColorメソッド追加
• $mplayer.playにおいて効果音の音量を設定可能に
• PanelChar::resizeメソッドの説明を追加
• ランタイムアイコンにpngを使用可能に

1.14

• ランタイム作成時に音楽データがコピーされない不具合を修正。
• ランタイム作成時にfilesフォルダの内容をコピー可能に。
• メッセージウィンドウを追加
• $projectManager.loadPage を実行後、数フレーム処理が続いてしまう不具合を修正。
• $Options.set,$Options.getメソッド追加。「Tonyuがアクティブでないときの実行の一時停止」「Tonyuがアクティブでないときのgetkeyメソッドの無効化」「ページを切り替えたときにBGMを停止しない」を可能に
• 「nullはオブジェクトではないので..」というエラーメッセージを「変数xxxは初期化されていないので...」というメッセージに変更。
• absメソッドの説明を追加
• getGreen,getBlue,getRedメソッド追加
• crashToLineメソッド追加

1.13

• timeStopメソッドを追加
• notifyメソッドによりオブジェクトの速度が２倍になる不具合を修正
• 実行開始時のフォントが直前のsetFontメソッドの呼び出し内容によって変化する不具合を修正
• waitInputメソッドを呼び出しによって表示されるウィンドウを右上の"x"によって閉じると処理が抜け出せなくなる不具合を修正
• BGM、効果音を同一プロジェクト内で共有(ページ毎に読み込む必要なし)
• randomizeメソッド、getTimeメソッド追加
• onAppearメソッド追加
• ハッシュテーブル追加
• エラー発生時および検索結果のダブルクリックによるソースコード表示の不具合を修正
• 新規ページを作成時に標準で設定されるフォルダをSamplesからProjectsに変更

1.12修正パッチからの変更点

• BGM、効果音が読み込まれない不具合を修正

1.12

• パネルオブジェクトを追加。テキスト等の回転に対応
• フレームマネージャを追加
• 配列にremove,indexOfメソッド追加、deleteメソッドの戻り値の仕様を変更
• 同一引数のgetkeyを１フレームに２回以上呼び出すと押した瞬間の判定ができない不具合を修正
• valueOfメソッドが負の値を表す文字列を変換できない不具合を修正
• エディタ内で範囲を選択することにより選択範囲のみインデントが可能に
• $InputBox, waitInputで表示される入力ウィンドウのプロンプト表示に複数行を表示可能に

1.11

• 起動画面をリニューアル
• ステータスバー設置
• レシピ集追加
• png画像読み込み対応
• 文字入力機能($InputBox, waitInput)追加
• ジョイスティック２個使用に対応

1.09

• APIリファレンスを命令リファレンスに改称。
• 代入文、if文、while文、メソッドの説明追加
• extends文、is 演算子の説明追加
• ++ , -- 演算子追加
• for文に機能追加
• break文追加
• $mouseManagerの各種メソッド追加,$mouseX,$mouseYを改良。画面外のマウス位置を検知

1.08

• プログラム内検索機能追加
• サテライトをリニューアル
• MIDI 演奏開始時に処理が止まらないように改良
• ファイル入出力機能を追加
• AnimationAdaptor 追加
• updateExメソッド 追加
• angleDiffメソッド 追加
• valueOfメソッド追加
• /* ... */ スタイルの注釈に対応

1.07

• ページ切り替え時のクラスのコンパイルを廃止、オブジェクトを破棄しないでのページの切り替えを可能に。
• $mplayer.playで効果音を連続して鳴らすと前の効果音が消える不具合を修正
• テキスト表示を強化。複数行表示対応。 フォント切り替え対応(setFontメソッド)
• APIリファレンスに文字列操作を追加
• オブジェクト一覧、パフォーマンスウィンドウを追加
• screenOut,gotoScreen,getScreenX,getScreenYメソッド追加
• ハイスコア登録CGIのバグを修正

1.06

• 02/3/24 ジョイスティック対応
• 3/23 ランタイムのアイコン変更を可能に
• 3/23 ツールバーウィンドウ改造
• 3/23 エディタの横にクラス一覧を表示

1.05

• 02/3/16 描画方法オプションを追加。半透明表示を高速化
• 3/15 途中に空の行があるときにインデントが狂うバグを修正
• 3/15 getVisibleメソッドを追加
• 3/14 キャラクタパターン選択ウィンドウを改良
• 3/10 一度コンパイルしたクラスのコンパイルを抑止することによりページ読み込み速度を向上
• 3/5 ランタイム実行開始時のTonyuロゴ表示を廃止
• 3/1 APIリファレンスの数学関数の項目にtruncメソッド追加

1.04

• 02/2/24 キャラクタパターン用ビットマップのパターン認識方法を改善
• 2/24 オブジェクトの貼り付けにより同名のオブジェクトができてしまうバグ を修正
• 2/24 $projectManager.getCurrentPageNameメソッド追加
• 2/24 文字列を== , != 演算子で比較可能に

1.03

• 02/2/17 $panel.getPixelメソッド追加
• 2/17 MIDIを使った後ページを切り替えるとI/Oエラーを出すバグを修正

1.02

• 02/2/14 実行中に画面サイズを変更すると画面表示がおかしくなるバグを修正

1.01

• 02/1/26 サンプルプログラムにHockey2追加
• 1/26 サンプルプログラムに注釈とサウンドをつける
• 1/26 ロード中に音楽がループするバグを修正
• 1/20 ランタイム作成前にページ保存
• 1/20 ランタイムでのリサイズ禁止
• 1/20 エラーウィンドウ作成
• 1/20 designMode() メソッド追加

0.112

• 1/13 exeファイル変更。Tonyu.exeとPlayer.exe。Player.exeはデモが実行される
• 1/13 サンプルプログラムにエアーホッケー(Hockey)を追加
• 02/1/1 ネットランキング機能追加
• 12/28 PlainCharクラスにwait,notifyメソッド追加
• 01/12/28 起動画面を変更

0.111

• 12/08 Char クラスを推奨されないクラスに。代わりにSpriteCharクラスを使うようにする
• 12/08 サンプルプログラムにMeteoGrazer(Meteo)を追加
• 12/08 rndメソッドに負の値を指定すると無限ループになるバグを修正
• 12/07 オブジェクト作成ダイアログを改造
• 12/06 TextChar , DxChar ,SecretCharクラス、drawDxSpriteメソッド追加
• 12/05 color定数8種類($clWhiteなど)を定義

0.110

• 12/02 サンプルプログラムにブロックくずしを追加
• 12/01 $panelを使用可能に
• 11/26 ZOrderを用いてキャラクタの表示順序を設定可能に

0.109

• 11/24 APIリファレンスに$map.get $map.set $map.scrollTo を追加
• 11/24 オブジェクトを選択しないでコピーや切り取りを行うとエラーが出るのを修正
• 11/24 null が使用可能に
• 11/21 識別子に漢字を使用可能に
• 11/16 Ball.bmpの絵を改良
• 11/08 インスペクタをリニューアル

0.108 ページ切り替え対応
0.107 マップ編集、表示対応
0.106 ProjectManager追加。クリップボードからの貼り付けによる不具合修正。マップスクロール機能追加、returnの後の式省略可能に。
0.104 サウンド機能追加
0.103 クラスリストの削除、並び替え追加、+=演算子追加
0.102 $map.setBackGround, $map.setBGColorメソッド追加
0.101 ビットマップ読み込みの不具合を修正

ダウンロード Wikiトップ

ダウンロード Wikiトップ

互換性の設定

この設定は、ver1.30以降で使えます。

主にver1.29～1.30でいくつか仕様変更をしたため、以前のバージョンと動作が違うことがあります。
ただし、動作が変わっては困るものは自動的に互換性を保つため、基本的にはここの設定をする必要ありません。

もし、動作に違和感を感じたり、以前の動作を再現したい場合は、下記の設定をお使いください。

下記２種類の項目があります

• 自動的に互換性を維持する項目
• 手動で互換性の設定をする項目

自動的に互換性を維持する項目

ここの項目は、主に最新バージョンで仕様変更があった項目で、
旧バージョンで作られたプロジェクトでは、自動的に旧バージョンの仕様で動作する項目です。

default.tonyuprjファイルのtargetVersion（無い場合はsavedVersion）の値で、
どのTonyuのバージョンで作られたのか判断し、自動的に互換性の設定をします。
手動で設定変更したい場合は、以降の説明の方法で設定するか、targetVersion（無い場合はtargetVersionを追記）の値を変更します。

※ targetVersionとsavedVersionの値は、バージョン値の1000倍です。
  例1）Tonyu1_29_2021_1212 → ver1.29 → 1290
  例2）Tonyu1_302_2024_0210 → ver1.302 → 1302

項目

• wav,mzoの音量
• スプライト描画の回転(angle)の精度
• sin,cosの精度
• ver1.22以前のゲームをver1.23以降で実行すると、wavがループしてしまう

wav,mzoの音量

各バージョンの仕様

• ver1.19以前、wavとmzoの音量は100%でした。
• ver1.21～1.29は、wavとmzoの音量は50%でした。
• ver1.30以降、wavとmzoの音量は100%になりました。

互換性維持の機能

• ver1.21～1.29のプロジェクトは、自動的にwavとmzoの音量が50%に設定されます。
• 手動で音量を変更したい場合は、下記設定をしてください。

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_base_volume" value="0.5"/>を追記してください。
valueの値（0.5の部分）は、$mplayer.setBaseVolumeを参照し、設定したい値に変えてください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$mplayer.setBaseVolumeを実行するようにプログラムしてください。

スプライト描画の回転(angle)の精度

各バージョンの仕様

• ver1.29以前は、１回転で256段階の精度でした（約1.4°ごとに角度が変わる）
• ver1.30以降、１回転で36000段階の精度に向上しました（0.01°ごとに角度が変わる）

互換性維持の機能

• ver1.29以前のプロジェクトは、自動的に１回転で256段階の精度に設定されます。
• 手動で精度を変更したい場合は、下記設定をしてください。

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_sprite_angle_accuracy" value="0"/>を追記してください。
valueの値（0の部分）は、$System.setSpriteAngleAccuracyを参照し、設定したい値に変えてください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$System.setSpriteAngleAccuracyを実行するようにプログラムしてください。

sin,cosの精度

各バージョンの仕様

• ver1.29以前は、0～360°で360段階の精度でした（1°単位の精度）
• ver1.30以降、0～360°で36000段階の精度に向上しました（0.01°単位の精度）

互換性維持の機能

• ver1.29以前のプロジェクトは、自動的に0～360°で360段階の精度に設定されます。
• 手動で精度を変更したい場合は、下記設定をしてください。

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_sin_cos_accuracy" value="0"/>を追記してください。
valueの値（0の部分）は、$Math.setSinCosAccuracyを参照し、設定したい値に変えてください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$Math.setSinCosAccuracyを実行するようにプログラムしてください。

ver1.22以前のゲームをver1.23以降で実行すると、wavがループしてしまう

• wavのループはver1.23から対応しました
• ver1.22以前でwavをループ再生指定してもループしませんが、
  そのままver1.23以降で実行するとwavがループ再生してしまいます（一部そのようなゲームがありました）

互換性維持の機能

• ver1.22以前のプロジェクトは、自動的にwavループ無効に設定されます。
• 手動で設定を変更したい場合は、下記設定をしてください。

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_se_loop_enable" value="0"/>を追記してください。
valueの値（0の部分）は、$mplayer.setSeLoopEnableを参照し、設定したい値に変えてください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$mplayer.setSeLoopEnableを実行するようにプログラムしてください。

手動で互換性の設定をする項目

ここの項目は、主に旧バージョンの不具合などの項目です
最新バージョンでは改善されている項目です
以前の動作を再現したい特殊な場合のみ、下記の設定をしてください

項目

• FPSが約61～63になる現象
• 11025Hz, 22050Hz, 44100Hz以外のwavで再生速度が速くなる（かつ音が高くなる）現象
• 効果音を多数大音量で鳴らすと音割れする現象
• オブジェクトを大量生成した際、点滅したり動作が遅くなる現象

FPSが約61～63になる現象

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

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_legacy_frame_rate" value="1"/>を追記してください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$System.setLegacyFrameRate(1);を実行するようにプログラムしてください。

11025Hz, 22050Hz, 44100Hz以外のwavで再生速度が速くなる（かつ音が高くなる）現象

• ver1.29以前は、サンプリングレートが11025Hz, 22050Hz, 44100Hz以外のwavは再生速度が速くなるバグがありました。
  （11025Hz, 22050Hz, 44100Hzは本来の再生速度で再生されています）
• ver1.30より、本来の再生速度で再生するようにバグ修正しました。
• ver1.29以前のなり方に戻したい場合は、下記の設定をしてください。
• ただし、ver1.29以前のサウンドの不具合や音質劣化、レイテンシが大きくなる等も発生してしまいます。
  （$mplayer.setSoundPlayModeのmode=1を参照）

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_sound_play_mode" value="1"/>を追記してください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$mplayer.setSoundPlayMode(1);を実行するようにプログラムしてください。

効果音を多数大音量で鳴らすと音割れする現象

• ver1.30より、音割れを防ぐ機能を追加したため、音割れしにくくなります。
• 大音量の際は音量が自動的に小さくなります。
• ver1.302より、この機能はデフォルトでOFFになりました。
• 機能を有効にするには、下記の設定をしてください。

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_volume_limiter" value="1"/>を追記してください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$mplayer.setVolumeLimiter(1);を実行するようにプログラムしてください。

オブジェクトを大量生成した際、点滅したり動作が遅くなる現象

• ver1.30より、点滅防止機能を追加したため、本現象は発生しにくくなります。
• 機能を無効にするには、下記の設定をしてください。

【ソースコードを編集しない方法】
該当プロジェクトのdefault.tonyuprjファイルを編集します。
<resourcelist name="params">で囲われた中に
<param name="init_process_single" value="1"/>を追記してください。

【ソースコードから設定する方法】
ゲーム起動時などのタイミングで、$System.setProcessSingle(1);を実行するようにプログラムしてください。

ダウンロード Wikiトップ

Wikiトップ

Tonyu Systemについて

配布規定

このプログラム(Tonyu System)の著作権は、作者(@hoge1e3)にあります。
再配布については、アーカイブの内容を変えない場合、自由に再配布が可能です。
内容を変更したものを配布する場合、事前に ｈｏｇｅ１ｅ３ あっと じーめーるどっとこむ
または @hoge1e3 まで連絡をください。

このプログラムを用いて作成されたプログラムの著作権は、そのプログラムの製作者にあります。
このプログラムのランタイム作成機能を用いて作成されたファイル(およびそのアーカイブファイル)は、製作者が自由に配布できます。

免責事項

このプログラムを使用したために発生したいかなる事故、問題等も作者は責任を負わないものとします

開発者

作者(@hoge1e3)のほか、Tonyu1_27_2019_0930 のバージョンからは主に @makkii_bcr が開発しています。

Wikiトップ

Wikiトップ

Tonyu1とは

Tonyu Systemは，アクションゲームの作成に適したプログラミング言語環境です．　　

特徴

視覚的デザイン

キャラクタの配置やマップの作成はマウス操作で行います。ゲーム画面のレイアウトが素早く簡単にできます。

↑ブロック崩しの面パターンなどは，マップエディタで作ることができます．

↑オブジェクトをクリックすると各種パラメータが表示されます。

↑オブジェクトをダブルクリックすると、コードエディタが開きます。

並列処理

ゲームの動きをプログラムするのに便利な並列処理を完全にサポートします。キャラクタの動きはキャラクタ毎に独立して記述します。
通常のゲームプログラムでは、「１フレーム（１コマ）毎に行う動作」を記述するのに対して「キャラクタが生まれてから、死ぬまでの動作」を自然に記述できます。

グラフィックス・サウンドライブラリ

グラフィックスの表示やキー入力、サウンドなど、ゲームに必要な機能を簡単に使えます。

↑回転表示や半透明表示もできます。

ネットランキング対応

CGIが実行可能なWebページをお持ちであれば、作成したゲームのハイスコア登録をWeb上で行えます。登録用CGIのPerlスクリプトが添付されています。

チュートリアル

初心者のために、簡単なゲームを作るための手順をヘルプに添付しました。これを読みながらTonyuの使い方を学習することができます。

サンプルプログラム

気軽に遊べるショートゲームを収録。ここで紹介した機能を一通り使っています。

動作環境

動作条件

• Windows 95以降（Windows専用）
• DirectX6以降

動作するOS

• 別途インストール無し
  • Windows 11, 10, 8.1, 8, 7, Vista, XP, 2000, Me, 98SE
• DirectX6のインストールが必要
  • Windows 98, 95

最低動作環境

• Windows98 / Pentium 266MHz / メモリ 128MB （BBS No.8836より）

Wikiトップ

ページが存在しません。

ダウンロード Wikiトップ

Tonyu1 プレリリースバージョン

開発中のバージョンを一旦公開しています。

Tonyu1_301_2022_0916.zip

• 細かい修正
  • wavの再生処理を軽量化
    • stopSE無効＆volumeLimiter無効の場合に、処理軽量化するよう実装
    • モノラルwavしかないときはモノラル再生にして軽量化
  • mzoでpcm(wav)音源が上手くならないのを修正（Tonyu1.30で発生）
  • 速いCPUでloopMode==0&&sleepTime==0の時、mzoの音が伸びたような音になるので修正
  • loopMode==0&&sleepTime==0の時、非アクティブになってもスリープがかからないので修正
  • loopMode==2を追加
    • loopMode==0(Busy Loop)とほぼ同じだが、FPSが維持できているときはsleepTime=1、FPSが維持できなくなるとsleepTime=0にする
  • エディタのインデント挙動修正・インデント高速化

ダウンロード Wikiトップ

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

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

入出力

• print
• getkey
• Joystick
• $mouseX,$mouseY
• $mouseManager
• $InputBox
  • waitInput
• $TextEditor
  • TextChar.edit
• $SelectBox
  • waitSelect

オブジェクトの種類

• スプライト(SpriteCharクラス)
• DXスプライト(DxCharクラス)
• テキスト(TextCharクラス)
• シークレット(SecretCharクラス)
• パネル(PanelCharクラス)
• フレームマネージャ(FrameManagerクラス)

オブジェクト制御

• die
• update
• updateEx
• wait
• notify
• appear
• setVisible
• timeStop

判定

• for (xx in $chars)
• crashTo
• isDead
• screenOut
• getVisible
• crashToLine

イベント

• onUpdate
• onMouseDown
• onDie
• onDraw
• onAppear

アニメーション

• newAnimation

グラフィックス

• drawText
• setFont
• drawLine
• fillRect
• color
• colorHSL
• getRed
• getGreen
• getBlue
• drawSprite
• drawDxSprite
• centerText
• drawVerticalText
• drawPolygon
• drawRect
• drawRectDx
• drawTriangle
• gradationLine
• gradationRect
• gradationText
• パネルの使い方

マップ

• $map
  • $map.set
  • $map.get

画面制御

• $map.scrollTo
• $viewX,$viewY
• getScreenX,getScreenY
• $screenWidth,$screenHeight,$window.sizeable
• $windowX,$windowY
• $map.setBGColor

ページ制御

• $projectManager.loadPage

サウンド

• $mplayer.play
• $mplayer.stop

数学関数

• $Math
• randomize
• rnd
• abs
• sin
• cos
• angle
• dist
• angleDiff
• trunc
• floor
• valueOf
• amod

配列

• Array

ハッシュテーブル

• Hashtable

文字列

• String
  • 文字列結合 +演算子
  • 文字列比較 ==演算子
  • String.length
  • String.substring
  • String.split

ファイル

• ファイルの扱いについて
• FileReader
• FileWriter

ネットランキング

• $ranking.setParam
• $ranking.openBrowser

設定

• $Options.set
• $Options.get

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

Wikiトップ

命令リファレンス

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

文法

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

グローバル変数一覧

オブジェクト・クラス一覧

Wikiトップ

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

AbstractHashtableクラス

Hashtable、LightHashtableの親クラスです。

命令リファレンス 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トップ

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トップ

算術演算

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

書式

式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トップ

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

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

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

++ , -- 演算子

書式

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

それぞれ、

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

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

命令リファレンス 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トップ

break

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

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

例1

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

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

命令リファレンス 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トップ

注釈

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

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

例1

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

▲ 緑色の部分が注釈です

命令リファレンス 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トップ

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トップ

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トップ

ファイルの扱いについて

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トップ

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トップ

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トップ

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トップ

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

※ 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トップ

$_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トップ

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トップ

$fullScreen

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

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

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

$osPlatformId、$osMajorVer、$osMinorVer、$osBuildNumber

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

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

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

命令リファレンス 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トップ

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トップ

$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トップ

is

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

書式

式 is クラス名

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

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

例1

for (xx in $chars) 参照

命令リファレンス 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トップ

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

キーID一覧

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

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

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

LightHashtableクラス

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

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

命令リファレンス 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トップ

$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トップ

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トップ

メソッドの呼び出し

メソッドとは、ある決まった処理をまとめたものです。
プログラムからメソッドを呼び出すことによりその処理を実行させることができます。

あらかじめ定義されているメソッドを呼ぶには、次の書式に従います。

書式

メソッド名 ( 引数 , 引数 ... )

メソッド名で指定された名前をもつメソッドを呼び出します。
引数は、呼び出すメソッドに渡す値です。
引数の詳細は、 それぞれのメソッドの説明のところに記載されています。

また、メソッドによっては呼び出す相手を指定する必要があります。
その場合は次の書式に従います。

書式

式. メソッド名 ( 引数 , 引数 ... )

式で表されるオブジェクトに対して、メソッド名で指定された名前をもつメソッドを呼び出します。
式がが初期化されていなかったり、式がオブジェクトでないと、 次のメッセージが表示されます。

変数$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トップ

メソッドの定義

メソッドは、あらかじめ定義されているものを呼び出すだけではなく、自分で定義（作成）することができます。

メソッドの定義をするには次の書式に従います。

書式

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トップ

$mouseX, $mouseY

マウスカーソルの位置($mouseX :x座標 / $mouseY :y座標) を返します。

メインウィンドウの左上が ($mouseX,$mouseY)=(0,0)
メインウィンドウの右下が ($mouseX,$mouseY)=($screenWidth,$screenHeight) になります。

ver 1.09から、画面外にいるマウスカーソルも位置がわかるようになりました。

• メインウィンドウより左側にいる場合、$mouseXが負の値になります。
• メインウィンドウより上にいる場合、$mouseYが負の値になります。

命令リファレンス 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トップ

$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トップ

null

nullとは、「何も値が入っていない」という意味です。変数に値が代入される前には、このnullという値が入っています。

ある変数がnullであるか(まだ値が入っていないか)どうかは、次のように判定できます

if (x==null) ...

次のように、変数にnullを代入することも可能です。

x=null;

命令リファレンス 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トップ

.演算子

他のオブジェクトの変数を参照するには . を使います。

書式

式 . 変数名

式 がオブジェクトの場合 、そのオブジェクトが持っている、変数名 で指定された名前をもつ変数を返します。
式 が初期化されていなかったり、式がオブジェクトでないと、 次のエラーメッセージが表示されます。

変数$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トップ

$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トップ

$panelとpanelの違い

$panel

１ページにつき１個、自動的に作成されます。２個以上は作成できません。
パネル全体の移動はできません

panel

パネルオブジェクトがそれぞれ１つずつ保有します。
パネルオブジェクトが移動するにつれてパネルも移動します

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

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

$panelオブジェクト

自動的に作成されるPanelクラスのオブジェクトです。

参考

$panelとpanelの違い

命令リファレンス 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トップ

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トップ

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トップ

$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トップ

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トップ

$rankingオブジェクト

ネットランキングCGIの呼び出しを行います

メソッド一覧

$ranking.openBrowser

メニューの「ウィンドウ」＞「ネットランキング」で指定したURLを開きます。

書式

openBrowser()

$ranking.setParam

ランキングCGIに渡すパラメータを設定します。

書式

setParam(name,value)

• name
   パラメータ名
• value  値

ネットランキングの詳しい設置法は、チュートリアルを参照してください

nameで指定される名前のパラメータに 値value を設定します。 valueには文字列または数値を指定します。

命令リファレンス 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();
}