three.js MTLLoader

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

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

構造函數(shù)

MTLLoader( loadingManager : LoadingManager )

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

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

屬性

共有屬性請參見其基類Loader。

方法

共有方法請參見其基類Loader。

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

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

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

.setMaterialOptions ( options : Object ) : this

options — 必要

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

設置構造材質(zhì)的一些選項。

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

text — 要解析的表示 mtl 結構的文本。 path — MTL文件的路徑。

解析 mtl 的文本結構，并返回一個 MTLLoader.MaterialCreator 實例。

源碼

examples/jsm/loaders/MTLLoader.js