Class ByNameRootBoneMapper

Implements a root bone selection strategy by searching for a matching bone name within the loaded model’s hierarchy. This mapper iterates over a predefined list of candidate root bone names (e.g., "Hips", "Bip01", "Pelvis") and returns the first match found based on the configured string comparison settings.

Inheritance

object

Object

ScriptableObject

RootBoneMapper

ByNameRootBoneMapper

Inherited Members

RootBoneMapper.Map(AssetLoaderContext)

ScriptableObject.SetDirty()

ScriptableObject.CreateInstance(string)

ScriptableObject.CreateInstance(Type)

ScriptableObject.CreateInstance<T>()

Object.GetInstanceID()

Object.GetHashCode()

Object.Equals(object)

Object.Instantiate(Object, Vector3, Quaternion)

Object.Instantiate(Object, Vector3, Quaternion, Transform)

Object.Instantiate(Object)

Object.Instantiate(Object, Transform)

Object.Instantiate(Object, Transform, bool)

Object.Instantiate<T>(T)

Object.Instantiate<T>(T, Vector3, Quaternion)

Object.Instantiate<T>(T, Vector3, Quaternion, Transform)

Object.Instantiate<T>(T, Transform)

Object.Instantiate<T>(T, Transform, bool)

Object.Destroy(Object, float)

Object.Destroy(Object)

Object.DestroyImmediate(Object, bool)

Object.DestroyImmediate(Object)

Object.FindObjectsOfType(Type)

Object.FindObjectsOfType(Type, bool)

Object.DontDestroyOnLoad(Object)

Object.DestroyObject(Object, float)

Object.DestroyObject(Object)

Object.FindSceneObjectsOfType(Type)

Object.FindObjectsOfTypeIncludingAssets(Type)

Object.FindObjectsOfType<T>()

Object.FindObjectsOfType<T>(bool)

Object.FindObjectOfType<T>()

Object.FindObjectOfType<T>(bool)

Object.FindObjectsOfTypeAll(Type)

Object.FindObjectOfType(Type)

Object.FindObjectOfType(Type, bool)

Object.ToString()

Object.name

Object.hideFlags

object.Equals(object, object)

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Namespace: TriLibCore.Mappers

Assembly: Assembly-CSharp.dll

Syntax

[CreateAssetMenu(menuName = "TriLib/Mappers/Root Bone/By Name Root Bone Mapper", fileName = "ByNameRootBoneMapper")]
public class ByNameRootBoneMapper : RootBoneMapper

Fields

CaseInsensitive

Indicates whether the string comparisons for matching root bone names should be case insensitive.

Declaration

public bool CaseInsensitive

Field Value

Type	Description
bool

RootBoneNames

A list of candidate root bone names to search for in the loaded model. Examples might include "Hips", "Bip01", and "Pelvis".

Declaration

public string[] RootBoneNames

Field Value

Type	Description
string[]

StringComparisonMode

Specifies the string comparison mode for matching loaded GameObject names against the candidate root bone names.

Declaration

[Header("Left = Loaded GameObjects Names, Right = Names in RootBoneNames")]
public StringComparisonMode StringComparisonMode

Field Value

Type	Description
StringComparisonMode

Remarks

The "left" value is the name of the loaded GameObject and the "right" value is one of the candidate names specified in RootBoneNames.

Methods

Map(AssetLoaderContext, IList<Transform>)

Declaration

public override Transform Map(AssetLoaderContext assetLoaderContext, IList<Transform> bones)

Parameters

Type	Name	Description
AssetLoaderContext	assetLoaderContext	The context used for loading the model, containing references and additional settings.
IList<Transform>	bones	A list of candidate bone transforms extracted from the loaded model's hierarchy.

Returns

Type	Description
Transform	The UnityEngine.Transform corresponding to the matched root bone name, or if no match is found, the result of the base implementation.

Overrides

RootBoneMapper.Map(AssetLoaderContext, IList<Transform>)

Remarks

This method iterates over the RootBoneNames array and, for each candidate name, calls FindDeepChild(IList<Transform>, string) to determine if any of the provided bones have a name that matches (according to the specified string comparison mode). If a match is found, that UnityEngine.Transform is immediately returned. If no candidate matches, the base mapper's implementation is used as a fallback.