javascript
/
three.js
mirror of https://github.com/tazdij/three.js.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110
							<!DOCTYPE html>
<html lang="zh">
	<head>
		<meta charset="utf-8" />
		<base href="../../../" />
		<script src="list.js"></script>
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		<h1>加载器（[name]）</h1>

		<p class="desc">用于实现加载器的基类。</p>


		<h2>构造函数</h2>


		<h3>[name]( [param:LoadingManager manager] )</h3>
		<p>
			[page:LoadingManager manager] — 加载器将要使用的 [page:LoadingManager loadingManager]。默认为 [page:LoadingManager THREE.DefaultLoadingManager]。
		</p>
		<p>
			创建一个新的[name]。
		</p>


		<h2>属性</h2>

		<h3>[property:string crossOrigin]</h3>
		<p>
		crossOrigin 字符串用于实现 CORS ，以从允许 CORS 的其他域加载url。
		默认为*anonymous*。
		</p>

		<h3>[property:LoadingManager manager]</h3>
		<p>
			加载器要使用的 [page:LoadingManager loadingManager] 。默认为 [page:DefaultLoadingManager] 。
		</p>

		<h3>[property:String path]</h3>
		<p>
			将从中加载资产的基本路径。
			默认为空字符串。
		</p>

		<h3>[property:String resourcePath]</h3>
		<p>
			将从中加载额外资源（例如纹理贴图）的基本路径。
			默认为空字符串。
		</p>

		<h3>[property:object requestHeader]</h3>
		<p>
			[link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header] 在 HTTP 请求中使用。 请参考 [page:.setRequestHeader]。 默认为 *undefined*。
		</p>	

		<h2>方法</h2>

		<h3>[method:void load]()</h3>
		<p>
			该方法需要被所有具体的加载器来实现。它包含了从后端加载资产的逻辑。
		</p>

		<h3>[method:Promise loadAsync]( [param:String url], [param:Function onProgress] )</h3>
		<p>
		[page:String url] — 一个字符串，包含要加载的文件的路径/URL。<br />
		[page:Function onProgress] — （可选）加载过程中将会被调用的函数。参数将是一个XMLHttpRequest实例，其包含了 .[page:Integer total] （总）字节数和 .[page:Integer loaded] （已加载）字节数。<br />
		</p>
		<p>
		该函数等效于[page:.load]，但返回的是一个 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise Promise]。
		</p>
		<p>
		[page:Function onLoad] 由 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve Promise.resolve] 处理，而 [page:Function onError] 则由 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/reject Promise.reject] 处理。
		</p>

		<h3>[method:void parse]()</h3>
		<p>
			该方法需要被所有具体的加载器来实现。它包含了解析资产到 three.js 实体的逻辑。
		</p>

		<h3>[method:Loader setCrossOrigin]( [param:String crossOrigin] )</h3>
		<p>
			[page:String crossOrigin] — crossOrigin字符串用于实现CORS，以从允许CORS的其它域加载url。
		</p>

		<h3>[method:Loader setPath]( [param:String path] )</h3>
		<p>
			[page:String path] — 设置资产的基本路径。
		</p>

		<h3>[method:Loader setResourcePath]( [param:String resourcePath] )</h3>
		<p>
			[page:String resourcePath] — 设置独立资源（如纹理贴图）的基本路径。
		</p>

		<h3>[method:Loader setRequestHeader]( [param:Object requestHeader] )</h3>
		<p>
			[page:object requestHeader] - key: 要设置header的名称。 value：要设置header的值。<br /><br />

			设置在 HTTP 请求中使用的 [link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header]（请求头）。
		</p>

		<h2>源码</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
		</p>
	</body>
</html>