相対名

ActionSource または ActionSource は、パラメータへのパスを相対名で保存します。相対名は、SIObject.FullName または SIObject::GetFullName、Parameter または Parameter(Model または Model の名前なし)。たとえば、Cricket というモデルの下にある立方体の posx パラメータのフルネームは、Cricket.cube.kine.global.posx になります。相対名を使用すると、異なるモデル間でアクションソースの共有が簡単になります。cube.kine.global.posx のようにパラメータの相対名はどの場所でも同じだからです。

ヒント:

アクションソースを作成し、Mixer または Mixer 内でそれらをインスタンス化するスクリプトを実行している場合、パラメータに関するアクションの接続方法を確認する接続マッピングダイアログがポップアップされることがあります。これは、パラメータがモデルにネストされている状態で、相対名の代わりにパラメータのフルネームを使ってソースを作成する場合にしばしば発生します。パラメータがシーンルートの下に存在する場合は、パラメータはフルネームの中にシーンルートを使用しないので発生しません。

JScript の例: 相対名を取得する

次に、指定された Parameter オブジェクトを受け取り、その相対名を戻す JScript 関数を示します。 GetRelativePathForTarget は、指定したパラメータの FullName からモデル名を検索して取り去るために正規表現を使用します。

function GetRelativeNameForTarget( in_param )
{
	var mdlname = in_param.Model.FullName;
	if ( mdlname == "Scene_Root" ) {
		return in_param.FullName;
	} else {
		var tmp = in_param.FullName;
		var re = new RegExp( mdlname + ".", "i" );
		return tmp.replace( re, "" );
	}
}

Python の例: 相対名を取得する

次の例は、上の JScript コードを Python で記述した場合の関数です。この場合の GetRelativePathForTarget も同じく、指定したパラメータの FullName からモデル名を削除するために正規表現を使用します。

def GetRelativeNameForTarget( in_param ) :
	import string as s
	mdlname = in_param.Model.FullName
	if mdlname == "Scene_Root" :
		return in_param.FullName
	else :
		return s.replace( in_param.FullName,  mdlname + ".", "" )

C++ の例: 相対名を取得する

次の例は、C++ API の場合のよく似た関数です。ただし、C++ では文字列の操作に正規表現を使用できないため、C++ API CString::IsEqualNoCase 関数を使用して同じ内容を実現します。

CString GetRelativeNameForTarget( Parameter& in_param )
{
	Model mdl = in_param.GetModel();
	CString mdlname = mdl.GetFullName();
	if ( mdlname.IsEqualNoCase(L"Scene_Root") ) {
		// We don't care about an object under the scene root 
		// (it automatically uses relative names anyways)
		return in_param.GetFullName();
	} else {
		CString tmp = in_param.GetFullName();
		CString lookfor = mdlname + L".";
		CString foundsofar = L"";
		CString relpath = L"";
		
		// This loop looks to find the modelname in the full path. 
		// When it finds it, it collects the rest of the string 
		// as the relative name 
		for ( ULONG i=0; i<tmp.Length(); ++i ) {
			if ( foundsofar.IsEqualNoCase(lookfor) ) {
				relpath += tmp[i];
			} else {
				foundsofar += tmp[i];
			}
		}
		
		// Return the relative name extracted from the full path
		return relpath;
	}
}