three.js MTLLoader

一個(gè)用于加載 .mtl 資源的加載器，由 OBJLoader 在內(nèi)部使用。

材質(zhì)模版庫(kù)（MTL）或 .MTL 文件格式是 .OBJ 的配套文件格式， 用于描述一個(gè)或多個(gè) .OBJ 文件中物體表面著色（材質(zhì)）屬性。

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

MTLLoader( loadingManager : LoadingManager )

manager — 加載器使用的loadingManager（加載管理器），默認(rèn)值是THREE.DefaultLoadingManager。

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

屬性

共有屬性請(qǐng)參見其基類Loader。

方法

共有方法請(qǐng)參見其基類Loader。

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

url — 一個(gè)包含有 .mtl 文件的路徑或URL的字符串。
onLoad — 當(dāng)加載過程成功完成以后將被調(diào)用的函數(shù)。
onProgress — （可選）加載過程正在進(jìn)行的時(shí)候被調(diào)用的函數(shù)。其參數(shù)是一個(gè)XMLHttpRequest實(shí)例，其包含了total bytes（總的字節(jié)數(shù)）和loaded bytes（已經(jīng)載入的字節(jié)數(shù)）。
onError — （可選） 加載過程中若發(fā)生了錯(cuò)誤將被調(diào)用的函數(shù)。這一函數(shù)接收錯(cuò)誤作為參數(shù)。

開始從URL中加載，并返回已加載的材質(zhì)。

.setMaterialOptions ( options : Object ) : this

options — 必要

• side: 在哪一側(cè)應(yīng)用材料。 THREE.FrontSide（默認(rèn)），THREE.BackSide，THREE.DoubleSide
• wrap: 什么類型的包裝適用于紋理。 THREE.RepeatWrapping（默認(rèn)），THREE.ClampToEdgeWrapping，THREE.MirroredRepeatWrapping
• normalizeRGB: RGB 需要從 0-255 標(biāo)準(zhǔn)化為 0-1。默認(rèn)值：false，假設(shè)已經(jīng)歸一化
• ignoreZeroRGBs: 忽略全為 0 的 RGB (Ka,Kd,Ks) 值。默認(rèn)值：假
• invertTrProperty: 使用 Tr 字段的值 1 表示完全不透明。此選項(xiàng)對(duì)于從 3ds MAX、vcglib 或 meshlab 導(dǎo)出的對(duì)象很有用。默認(rèn)值：假

設(shè)置構(gòu)造材質(zhì)的一些選項(xiàng)。

.parse ( [param:String text, param:String path] ) : MTLLoaderMaterialCreator

text — 要解析的表示 mtl 結(jié)構(gòu)的文本。 path — MTL文件的路徑。

解析 mtl 的文本結(jié)構(gòu)，并返回一個(gè) MTLLoader.MaterialCreator 實(shí)例。

源碼

examples/jsm/loaders/MTLLoader.js