ＲＰＧキャラクター制御関数

関数一覧

RpgCharaOn	キャラクターをアクティブにする
RpgCharaOff	キャラクターを非アクティブにする
RpgCharaTurn	キャラクターの向きを設定する
RpgCharaPos	キャラクターの位置を設定する
RpgCharaWarp	キャラクターをワープさせる
RpgCharaMove	キャラクターを移動させる
RpgCharaMoveTo	キャラクターを経路探索で移動させる
RpgCharaToPlayer	キャラクターをプレーヤーの位置まで移動させる
RpgCharaDrag	キャラクターをドラッグ移動させる
RpgCharaAlpha	キャラクターの不透明度を設定する
RpgCharaColor	キャラクターのカラーを設定する
RpgCharaImage	キャラクターのイメージを設定する
RpgCharaStep	キャラクターの足踏みを設定する
RpgCharaBatch	キャラクターにバッチ処理を設定する
RpgCharaBaloonOn	キャラクターのバルーンを表示する
RpgCharaBaloonOff	キャラクターのバルーンを非表示にする

関数詳細

RpgCharaOn()

機能

キャラクターをアクティブにする

書式

void RpgCharaOn( charaName )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)

戻り値

なし

RpgCharaOff()

機能

キャラクターを非アクティブにする

書式

void RpgCharaOff( charaName )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)

戻り値

なし

RpgCharaTurn()

機能

キャラクターの向きを設定する

書式

void RpgCharaTurn( charaName, direction )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
direction	列挙型	×	―	キャラクターの向きを示す列挙子

戻り値

なし

列挙型

キャラクターの向き

列挙子	略字	説明
Left	L	左向き
Right	R	右向き
Up	U	上向き
Down	D	下向き

RpgCharaPos()

機能

キャラクターの位置を設定する

書式

void RpgCharaPos( charaName, tileX, tileY )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
tileX	整数	◯	現在のＸ座標	タイルＸ座標
tileY	整数	◯	現在のＹ座標	タイルＹ座標

戻り値

なし

RpgCharaWarp()

機能

キャラクターを指定したワープポイントにワープさせる

書式

void RpgCharaWarp( charaName, warpPoint )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
warpPoint	文字列	◯	null	ワープポイント名。null の場合は初期位置にワープする

戻り値

なし

RpgCharaMove()

機能

キャラクターを移動させる

書式

void RpgCharaMove( charaName, direction, distance, speed )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
direction	文字列	×	―	移動方向を示す列挙子
distance	整数	◯	1	移動タイル数
speed	実数	◯	デフォルト値	移動速度 (１秒間に進むタイル数)

戻り値

なし

RpgCharaMoveTo()

機能

キャラクターを経路探索で移動させる

書式

void RpgCharaMoveTo( charaName, tileX, tileY, speed, maxCost )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
tileX	整数	×	―	移動先のタイルＸ座標
tileY	整数	×	―	移動先のタイルＹ座標
speed	実数	◯	デフォルト値	移動速度 (１秒間に進むタイル数)
maxCost	整数	◯	128	最大移動タイル数

戻り値

なし

RpgCharaToPlayer()

機能

キャラクターをプレーヤーの位置まで経路探索で移動させる

書式

void RpgCharaToPlayer( charaName, pos, speed, maxCost )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
pos	列挙型	×	―	目標位置を示す列挙子。プレーヤーから見てどの方向に立つかを指定する
speed	実数	◯	デフォルト値	移動速度 (１秒間に進むタイル数)
maxCost	整数	◯	128	最大移動タイル数

戻り値

なし

列挙型

目標位置

列挙子	略字	説明
Left	L	左
Right	R	右
Up	U	上
Down	D	下
LeftUp	LU	左上
LeftDown	LD	左下
RightUp	RU	右上
RightDown	RD	右下

RpgCharaDrag()

機能

キャラクターの座標のみ移動させる。RpgCharaMove() と異なり向きの変更や歩行アニメーションは行わない

書式

void RpgCharaDrag( charaName, direction, distance, speed )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
direction	文字列	×	―	移動方向を示す列挙子
distance	整数	◯	1	移動タイル数
speed	実数	◯	初期速度	移動速度 (１秒間に進むタイル数)

戻り値

なし

RpgCharaAlpha()

機能

キャラクターの不透明度を設定する

書式

void RpgCharaAlpha( charaName, alpha, fadeTime )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
alpha	整数	×	―	不透明度 (0～255)
fadeTime	実数	◯	0.0	フェード時間。0 以下の場合はフェード無し

戻り値

なし

RpgCharaColor()

機能

キャラクターの表示カラーを設定する

書式

void RpgCharaColor( charaName, red, green, blue, alpha, fadeTime )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
red	整数	◯	現在の値	赤色値 (0～255)
green	整数	◯	現在の値	緑色値 (0～255)
blue	整数	◯	現在の値	青色値 (0～255)
alpha	整数	◯	現在の値	不透明度 (0～255)
fadeTime	実数	◯	0.0	フェード時間。0 以下の場合はフェード無し

戻り値

なし

RpgCharaImage()

機能

キャラクターのイメージを設定する

書式

void RpgCharaImage( charaName, imageName )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
imageName	文字列	×	―	イメージ名。DirectionalAnimationControl に設定されている名前を指定する

戻り値

なし

RpgCharaStep()

機能

キャラクターの強制足踏みフラグを設定する。Ｏｎにすると歩行中でなくても足踏みアニメーションを続ける

書式

void RpgCharaStep( charaName, step )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
step	真偽値	◯	true	足踏みさせるか

戻り値

なし

RpgCharaBatch()

機能

キャラクターにバッチ処理を設定する。第二引数以降は {コマンド, パラメータ} の対を連続して記述することができる。パラメータは以下の表にある各コマンドに合わせた値を設定する。移動系のコマンドを使用するとキャラクターが目的地に到達するまで次のコマンドの実行を保留する

書式

void RpgCharaBatch( charaName [, command, param] ... )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
command	列挙型	×	―	コマンド列挙子
param	不定	×	true	コマンドに対するパラメータ

戻り値

なし

コマンド

コマンド

コマンド	パラメータ		機能
Turn	文字列	向きを示す列挙子	向きを変更する。RpgCharaTurn() と同じ
Speed	実数	移動速度	移動速度を変更する。この値はスクリプトからの移動のみに使用され通常移動には影響しない
MoveLeft	整数	移動タイル数	左に移動する。移動中は次のコマンドの実行を保留する。RpgCharaMove() と同じ
MoveRight	整数	移動タイル数	右に移動する。移動中は次のコマンドの実行を保留する。RpgCharaMove() と同じ
MoveUp	整数	移動タイル数	上に移動する。移動中は次のコマンドの実行を保留する。RpgCharaMove() と同じ
MoveDown	整数	移動タイル数	下に移動する。移動中は次のコマンドの実行を保留する。RpgCharaMove() と同じ
DragLeft	整数	移動タイル数	左にドラッグ移動する。移動中は次のコマンドの実行を保留する。RpgCharaDrag() と同じ
DragRight	整数	移動タイル数	右にドラッグ移動する。移動中は次のコマンドの実行を保留する。RpgCharaDrag() と同じ
DragUp	整数	移動タイル数	上にドラッグ移動する。移動中は次のコマンドの実行を保留する。RpgCharaDrag() と同じ
DragDown	整数	移動タイル数	下にドラッグ移動する。移動中は次のコマンドの実行を保留する。RpgCharaDrag() と同じ
Step	真偽値	足踏みフラグ	強制足踏みフラグを設定する。RpgCharaStep() と同じ
Image	文字列	イメージ名	キャラクターのイメージを設定する。RpgCharaImage() と同じ
FadeIn	実数	フェード時間	キャラクターをフェードインさせる
FadeOut	実数	フェード時間	キャラクターをフェードアウトさせる
DoorOpen	文字列	ドア名	指定したドアを開ける。RpgDoorClose() と同じ
DoorClose	文字列	ドア名	指定したドアを閉める。RpgDoorOpen() と同じ
PlaySe	文字列	ファイルのパス	効果音を再生する。PlaySe() と同じ
Sleep	実数	待機時間 (秒)	指定秒数バッチ処理を待機させる。他のスクリプト処理には影響しない

ML	整数	移動タイル数	MoveLeft コマンドの短縮表記
MR	整数	移動タイル数	MoveRight コマンドの短縮表記
MU	整数	移動タイル数	MoveUp コマンドの短縮表記
MD	整数	移動タイル数	MoveDown コマンドの短縮表記
DL	整数	移動タイル数	DragLeft コマンドの短縮表記
DR	整数	移動タイル数	DragRight コマンドの短縮表記
DU	整数	移動タイル数	DragUp コマンドの短縮表記
DD	整数	移動タイル数	DragDown コマンドの短縮表記

キャラクターの向き

列挙子	略字	説明
Left	L	左向き
Right	R	右向き
Up	U	上向き
Down	D	下向き

RpgCharaBaloonOn()

機能

キャラクターに設置されたバルーンを表示する

書式

void RpgCharaBaloonOn( charaName, baloonType )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)
baloonType	列挙子	◯	現在値	バルーンタイプを示す以下の列挙子

戻り値

なし

列挙型

バルーンタイプ

列挙子	説明
Up	上三角アイコン
Rihgt	右三角アイコン
Down	下三角アイコン
Left	左三角アイコン
Start	Start アイコン
Enter	Enter アイコン
Event	Event アイコン
Rest	Rest アイコン
Boss	Boss アイコン
Heart	ハートアイコン

RpgCharaBaloonOff()

機能

キャラクターに設置されたバルーンを非表示にする

書式

void RpgCharaBaloonOff( charaName )

引数

引数	型	省略	規定値	詳細
charaName	文字列	×	―	キャラクター名 (オブジェクト名)

戻り値

なし