Files
apt-nl-map/static/Magic4/js/three.js-dev/docs/examples/zh/loaders/MTLLoader.html
2024-12-04 10:21:04 +08:00

79 lines
3.2 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="utf-8" />
<base href="../../../" />
<script src="page.js"></script>
<link type="text/css" rel="stylesheet" href="page.css" />
</head>
<body>
[page:Loader] &rarr;
<h1>MTL加载器[name]</h1>
<p class="desc">一个用于加载 <em>.mtl</em> 资源的加载器,由 [page:OBJLoader] 在内部使用。<br />
材质模版库MTL或 .MTL 文件格式是 .OBJ 的配套文件格式,
用于描述一个或多个 .OBJ 文件中物体表面着色(材质)属性。
</p>
<h2>构造函数</h2>
<h3>[name]( [param:LoadingManager loadingManager] )</h3>
<p>
[page:LoadingManager manager] — 加载器使用的[page:LoadingManager loadingManager](加载管理器),默认值是[page:LoadingManager THREE.DefaultLoadingManager]。
</p>
<p>
创建一个新的[name]。
</p>
<h2>属性</h2>
<p>共有属性请参见其基类[page:Loader]。</p>
<h2>方法</h2>
<p>共有方法请参见其基类[page:Loader]。</p>
<h3>[method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
<p>
[page:String url] — 一个包含有 <em>.mtl</em> 文件的路径或URL的字符串。<br />
[page:Function onLoad] — 当加载过程成功完成以后将被调用的函数。<br />
[page:Function onProgress] — 可选加载过程正在进行的时候被调用的函数。其参数是一个XMLHttpRequest实例其包含了[page:Integer total] bytes总的字节数和[page:Integer loaded] bytes已经载入的字节数<br />
[page:Function onError] — (可选) 加载过程中若发生了错误将被调用的函数。这一函数接收错误作为参数。<br />
</p>
<p>
开始从URL中加载并返回已加载的材质。
</p>
<h3>[method:MTLLoader setMaterialOptions]( [param:Object options] )</h3>
<p>
[page:Object options] — required
<ul>
<li>side: Which side to apply the material. THREE.FrontSide (default), THREE.BackSide, THREE.DoubleSide</li>
<li>wrap: What type of wrapping to apply for textures. THREE.RepeatWrapping (default), THREE.ClampToEdgeWrapping, THREE.MirroredRepeatWrapping</li>
<li>normalizeRGB: RGBs need to be normalized to 0-1 from 0-255. Default: false, assumed to be already normalized</li>
<li>ignoreZeroRGBs: Ignore values of RGBs (Ka,Kd,Ks) that are all 0's. Default: false</li>
<li>invertTrProperty: Use values 1 of Tr field for fully opaque. This option is useful for obj exported from 3ds MAX, vcglib or meshlab. Default: false</li>
</ul>
</p>
<p>
设置构造材质的一些选项。
</p>
<h3>[method:MTLLoaderMaterialCreator parse]( [param:String text, param:String path] )</h3>
<p>
[page:String text] — 要解析的表示 <em>mtl</em> 结构的文本。
[page:String path] — MTL文件的路径。
</p>
<p>
解析 <em>mtl</em> 的文本结构,并返回一个 [page:MTLLoaderMaterialCreator MTLLoader.MaterialCreator] 实例。<br />
</p>
<h2>源码</h2>
<p>
[link:https://github.com/mrdoob/three.js/blob/master/examples/jsm/loaders/[name].js examples/jsm/loaders/[name].js]
</p>
</body>
</html>