three.js Loader

用于實(shí)現(xiàn)加載器的基類(lèi)。

構(gòu)造函數(shù)

Loader( manager : LoadingManager )

manager — 加載器將要使用的 loadingManager。默認(rèn)為 THREE.DefaultLoadingManager。

創(chuàng)建一個(gè)新的Loader。

屬性

.crossOrigin : String

crossOrigin 字符串用于實(shí)現(xiàn) CORS ，以從允許 CORS 的其他域加載url。 默認(rèn)為anonymous。

.manager : LoadingManager

加載器要使用的 loadingManager 。默認(rèn)為 DefaultLoadingManager 。

.path : String

將從中加載資產(chǎn)的基本路徑。 默認(rèn)為空字符串。

.resourcePath : String

將從中加載額外資源（例如紋理貼圖）的基本路徑。 默認(rèn)為空字符串。

.requestHeader : Object

request header 在 HTTP 請(qǐng)求中使用。 請(qǐng)參考 .setRequestHeader。 默認(rèn)為 undefined。

方法

.load () : undefined

該方法需要被所有具體的加載器來(lái)實(shí)現(xiàn)。它包含了從后端加載資產(chǎn)的邏輯。

.loadAsync ( url : String, onProgress : Function ) : Promise

url — 一個(gè)字符串，包含要加載的文件的路徑/URL。
onProgress — （可選）加載過(guò)程中將會(huì)被調(diào)用的函數(shù)。參數(shù)將是一個(gè)XMLHttpRequest實(shí)例，其包含了 .total （總）字節(jié)數(shù)和 .loaded （已加載）字節(jié)數(shù)。

該函數(shù)等效于.load，但返回的是一個(gè) Promise。

onLoad 由 Promise.resolve 處理，而 onError 則由 Promise.reject 處理。

.parse () : undefined

該方法需要被所有具體的加載器來(lái)實(shí)現(xiàn)。它包含了解析資產(chǎn)到 three.js 實(shí)體的邏輯。

.setCrossOrigin ( crossOrigin : String ) : this

crossOrigin — crossOrigin字符串用于實(shí)現(xiàn)CORS，以從允許CORS的其它域加載url。

.setPath ( path : String ) : this

path — 設(shè)置資產(chǎn)的基本路徑。

.setResourcePath ( resourcePath : String ) : this

resourcePath — 設(shè)置獨(dú)立資源（如紋理貼圖）的基本路徑。

.setRequestHeader ( requestHeader : Object ) : this

requestHeader - key: 要設(shè)置header的名稱(chēng)。 value：要設(shè)置header的值。設(shè)置在 HTTP 請(qǐng)求中使用的 request header（請(qǐng)求頭）。

源碼

src/loaders/Loader.js