メインキャラ制御関数

関数一覧

DrawChara	ＡＤＶでキャラを表示する
EraseChara	ＡＤＶでキャラを非表示にする
CharaCostume	キャラのコスチュームを設定する
CharaPartsOn	キャラのパーツをＯＮにする
CharaPartsOff	キャラのパーツをＯＦＦにする
CharaCanCostumeChange	キャラのコスチューム変更(裸への変更)の許可を取得、設定する
CharaCanDarkelfChange	キャラのダークエルフへの変更の許可を取得、設定する
AutoFaceThumbnail	顔グラの自動制御のＯｎ/Ｏｆｆを切替える
DrawFaceThumbnail	顔グラを表示する (手動で変更する)
CharaLevel	キャラのレベルを取得する
CharaHp	キャラのＨＰを取得、設定する
CharaMaxHp	キャラの最大ＨＰを取得する
CharaSp	キャラのＳＰを取得、設定する
CharaMaxSp	キャラの最大ＳＰを取得する
CharaAtk	キャラの攻撃力を取得する
CharaDef	キャラの防御力を取得する
CharaMagAtk	キャラの魔法攻撃力を取得する
CharaMagDef	キャラの魔法防御力を取得する
CharaAntiDebuff	キャラのデバフ耐性を取得する
CharaHasSkill	キャラがスキルを所持しているか
CharaAddSkill	キャラのスキルを追加する
CharaHasHSkill	キャラがＨスキルを所持しているか
CharaAddHSkill	キャラのＨスキルを追加する

関数詳細

DrawChara()

機能

ＡＤＶでキャラを表示する
初回表示の際は必ず layer 引数を設定する必要がある。既に表示されているキャラの場合は layer 引数を省略することができる。また、同じキャラを複数のレイヤーで同時に表示することは出来ない

書式

void DrawChara( charaId, face, cheek, pose, fadeTime, delayTime, layer, x, y )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
face	整数	◯	現在値	表情番号
cheek	整数	◯	現在値	頬番号
pose	整数	◯	現在値	ポーズ番号
fadeTime	実数	◯	―	フェード時間
delayTime	実数	◯	―	ディレイ時間
layer	実数	◯	現在値	レイヤー番号 (初回表示字は省略不可)
x	実数列挙子	◯	現在値	Ｘ座標。数値を指定した場合は絶対座標。以下の列挙子を指定した場合は定義座標になる
y	実数	◯	現在値	Ｙ座標

戻り値

なし

列挙型

キャラクターの表示位置

列挙子	説明
L	左側
LC	左側中央寄り
C	中央
RC	右側中央寄り
R	右側

EraseChara()

機能

ＡＤＶでキャラを非表示にする

書式

void EraseChara( charaId, fadeTime, delayTime )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
fadeTime	実数	◯	―	フェード時間
delayTime	実数	◯	―	ディレイ時間

戻り値

なし

CharaCostume()

機能

キャラのコスチュームを取得する。costume にコスチューム番号を指定した場合はコスチュームを変更する。但し、ＲＰＧマップ上のドット絵キャラは即座に反映されるが、ＡＤＶの立絵は DrawChara() 関数を使用するまで表示は更新されない (ツクール版イデオローグと同じ仕様)

書式

int CharaCostume( charaId, costume )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
costume	整数	◯	-1	コスチューム番号

戻り値

現在のコスチューム番号を返す

CharaPartsOn()

機能

キャラのパーツをＯＮにする。DrawChara() 関数を使用するまで表示は更新されない

書式

void CharaPartsOn( charaId, partsNo [, partsNo] ... )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
partsNo	パーツ番号	×	―	パーツ番号

戻り値

なし

CharaPartsOff()

機能

キャラのパーツをＯＦＦにする。DrawChara() 関数を使用するまで表示は更新されない

書式

void CharaPartsOff( charaId, partsNo [, partsNo] ... )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
partsNo	パーツ番号	×	―	パーツ番号

戻り値

なし

CharaCanCostumeChange()

機能

キャラのコスチューム変更の許可状態を取得する。許可状態を変更するには canChange に値を指定する

書式

bool CharaCanCostumeChange( charaId [, canChange] )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
canChange	真偽値	◯	現在の値	許可フラグ

戻り値

コスチューム変更の許可状態

CharaCanDarkelfChange()

機能

キャラのダークエルフへの変更の許可状態を取得する。許可状態を変更するには canChange に値を指定する

書式

bool CharaCanDarkelfChange( charaId [, canChange] )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
canChange	真偽値	◯	現在の値	許可フラグ

戻り値

ダークエルフへの変更の許可状態

AutoFaceThumbnail()

機能

顔グラの自動制御のＯｎ/Ｏｆｆを切替える

書式

void AutoFaceThumbnail( enable )

引数

引数	型	省略	規定値	詳細
enable	真偽値	×	―	true なら顔グラの自動制御を有効にし、false なら無効にする

戻り値

なし

DrawFaceThumbnail()

機能

顔グラを表示状態を設定する。顔グラの自動制御が有効な場合でもこの関数で指定した設定が優先される

書式

void DrawFaceThumbnail( charaId, face, cheek, pose, costume )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
face	整数	◯	現在値	表情番号
cheek	整数	◯	現在値	頬番号
pose	整数	◯	現在値	ポーズ番号
costume	整数	◯	現在値	コスチューム番号

戻り値

なし

CharaLevel()

機能

キャラのレベルを取得する

書式

number CharaLevel( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

キャラクタのレベル (1 が最小レベル)

CharaHp()

機能

キャラのＨＰを取得する。ＨＰを設定する場合は引数 hp に値を指定する

書式

void CharaHp( charaId, hp )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
hp	整数	◯	現在の値	ＨＰ値

戻り値

現在のＨＰ

CharaMaxHp()

機能

キャラの最大ＨＰを取得する

書式

void CharaMaxHp( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

最大ＨＰ

CharaSp()

機能

キャラのＳＰを取得する。ＳＰを設定する場合は引数 sp に値を指定する

書式

void CharaSp( charaId, sp )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
sp	整数	◯	現在の値	ＳＰ値

戻り値

現在のＳＰ

CharaMaxSp()

機能

キャラの最大ＳＰを取得する

書式

void CharaMaxSp( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

最大ＳＰ

CharaAtk()

機能

キャラの攻撃力を取得する

書式

void CharaAtk( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

攻撃力

CharaDef()

機能

キャラの防御力を取得する

書式

void CharaDef( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

防御力

CharaMagAtk()

機能

キャラの魔法攻撃力を取得する

書式

void CharaMagAtk( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

魔法攻撃力

CharaMagDef()

機能

キャラの魔法防御力を取得する

書式

void CharaMagDef( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

魔法防御力

CharaAntiDebuff()

機能

キャラのデバフ耐性を取得する

書式

void CharaAntiDebuff( charaId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ

戻り値

デバフ耐性

CharaHasSkill()

機能

キャラがスキルを所持しているか

書式

bool CharaHasSkill( charaId, skillId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
skillId	整数	×	―	スキルのＩＤ

戻り値

スキルを所持している場合は true、未所持の場合は false を返す

CharaAddSkill()

機能

キャラのスキルを追加する

書式

bool CharaAddSkill( charaId, skillId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
skillId	整数	×	―	追加するスキルのＩＤ

戻り値

新しく追加された場合は true、既に所持済みのスキルだった場合は false を返す

CharaHasHSkill()

機能

キャラがＨスキルを所持しているか

書式

bool CharaHasHSkill( charaId, skillId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
skillId	整数	×	―	スキルのＩＤ

戻り値

スキルを所持している場合は true、未所持の場合は false を返す

CharaAddHSkill()

機能

キャラのＨスキルを追加する

書式

bool CharaAddHSkill( charaId, skillId )

引数

引数	型	省略	規定値	詳細
charaId	列挙型	×	―	キャラクターＩＤ
skillId	整数	×	―	追加するスキルのＩＤ

戻り値

新しく追加された場合は true、既に所持済みのスキルだった場合は false を返す

メイン キャラ制御関数

関数一覧

関数詳細

DrawChara()

EraseChara()

CharaCostume()

CharaPartsOn()

CharaPartsOff()

CharaCanCostumeChange()

CharaCanDarkelfChange()

AutoFaceThumbnail()

DrawFaceThumbnail()

CharaLevel()

CharaHp()

CharaMaxHp()

CharaSp()

CharaMaxSp()

CharaAtk()

CharaDef()

CharaMagAtk()

CharaMagDef()

CharaAntiDebuff()

CharaHasSkill()

CharaAddSkill()

CharaHasHSkill()

CharaAddHSkill()

メインキャラ制御関数