three.js MMDLoader

一个用于加载MMD资源的加载器。

MMDLoader从MMD资源（例如PMD、PMX、VMD和VPD文件）中创建Three.js物体（对象）。 请参阅MMDAnimationHelper来了解MMD动画的处理，例如IK、Grant和Physics。

如果你想要MMD资源的原始内容，请使用.loadPMD/PMX/VMD/VPD方法。

代码示例

// Instantiate a loader
const loader = new MMDLoader();

// Load a MMD model
loader.load(
	// path to PMD/PMX file
	'models/mmd/miku.pmd',
	// called when the resource is loaded
	function ( mesh ) {

		scene.add( mesh );

	},
	// called when loading is in progresses
	function ( xhr ) {

		console.log( ( xhr.loaded / xhr.total * 100 ) + '% loaded' );

	},
	// called when loading has errors
	function ( error ) {

		console.log( 'An error happened' );

	}
);

例子

webgl_loader_mmd
webgl_loader_mmd_pose
webgl_loader_mmd_audio

构造函数

MMDLoader( manager : LoadingManager )

manager — 加载器使用的loadingManager（加载管理器），默认值是THREE.DefaultLoadingManager。

创建一个新的MMDLoader。

属性

共有属性请参见其基类Loader。

方法

共有方法请参见其基类Loader。

.load ( url : String, onLoad : Function, onProgress : Function, onError : Function ) : undefined

url — 一个包含有.pmd或.pmx文件的路径或URL的字符串。
onLoad — 当加载过程成功完成以后将被调用的函数。
onProgress — （可选）加载过程正在进行的时候被调用的函数。其参数是一个XMLHttpRequest实例，其包含了total bytes（总的字节数）和loaded bytes（已经载入的字节数）。
onError — （可选） 加载过程中若发生了错误将被调用的函数。这一函数接收错误作为参数。

开始从URL中加载PMD/PMX模型文件，并使用包含有已被解析的SkinnedMesh和MeshToonMaterial数组的BufferGeometry对象来触发回调函数。

.loadAnimation ( url : String, object : Object3D, onLoad : Function, onProgress : Function, onError : Function ) : undefined

url — 一个包含有.vmd文件的路径或URL的字符串或字符串数组。如果两个及以上文件被指定，它们将会合并。
object — SkinnedMesh 或 Camera。 剪辑及其轨道将会适应到该对象。
onLoad — 成功加载完成后被调用的函数。
onProgress — （可选）当加载正在进行时被调用的函数，参数将是XMLHttpRequest实例，其包含了 .total （总的）和 .loaded （已加载的）字节数。
onError — （可选）如果加载过程中发生错误时被调用的函数，该函数接受一个错误来作为参数。

开始从url(s)加载VMD动画文件（可能有多个文件），并使用已解析的AnimatioinClip触发回调函数。

.loadWithAnimation ( modelUrl : String, vmdUrl : String, onLoad : Function, onProgress : Function, onError : Function ) : undefined

modelUrl — 一个包含有.pmd或.pmx文件的路径或URL的字符串。
vmdUrl — 一个包含有.vmd文件的路径或URL的字符串或字符串数组。
onLoad — 成功加载完成后被调用的函数。
onProgress — （可选）当加载正在进行时被调用的函数，参数将是XMLHttpRequest实例，其包含了 .total （总的）和 .loaded （已加载的）字节数。
onError — （可选）如果加载过程中发生错误时被调用的函数，该函数接受一个错误来作为参数。

开始从URL中加载PMD/PMX模型文件和VMD动画文件（可能有多个文件），并使用一个Object —— 包含有已解析的SkinnedMesh和适应SkinnedMesh的AnimationClip，来触发回调函数。

.setAnimationPath ( animationPath : String ) : this

animationPath — 用于加载动画数据（VMD/VPD 文件）的基础路径。

设置额外资源（例如贴图）的基础路径。

源代码

examples/jsm/loaders/MMDLoader.js