首页 发现 帮助
登录
javascript
/
three.js
镜像自地址 https://github.com/tazdij/three.js.git
2
0
派生 0
文件 工单管理 0 Wiki
浏览代码

Merge pull request #10393 from looeee/BinaryTextureLoader/Deprecate

Deprecated BinaryTextureLoader in favour of DataTextureLoader
Mr.doob 8 年之前
父节点
cc8c356847 27b566ecbc
当前提交
309dd0b10a
共有 8 个文件被更改，包括 66 次插入 和 75 次删除
分列视图 显示文件统计
  1. 2 0
      docs/api/deprecated/DeprecatedList.html
  2. 0 62
      docs/api/loaders/BinaryTextureLoader.html
  3. 47 2
      docs/api/loaders/DataTextureLoader.html
  4. 0 1
      docs/list.js
  5. 5 5
      examples/js/loaders/RGBELoader.js
  6. 8 0
      src/Three.Legacy.js
  7. 1 1
      src/Three.js
  8. 3 4
      src/loaders/DataTextureLoader.js

+ 2 - 0
docs/api/deprecated/DeprecatedList.html
查看文件 

@@ -34,6 +34,8 @@
 
 		<h3>[page:AudioAnalyser]</h3>
 
 		<div>AudioAnalyser.getData() has been renamed to [page:AudioAnalyser.getFrequencyData]().</div>
 
 
+		<h3>[page:BinaryTextureLoader]</h3>
 
+		<div>BinaryTextureLoader has been renamed to [page:DataTextureLoader].</div>

+ 0 - 62
docs/api/loaders/BinaryTextureLoader.html
查看文件 

@@ -1,62 +0,0 @@
 
-<!DOCTYPE html>
 
-<html lang="en">
 
-	<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>
 
-
 
-		<div class="desc">
 
-		Abstract base class to load generic binary textures formats (rgbe, hdr, ...).
 
-		This uses the [page:FileLoader] internally for loading files.
 
-		</div>
 
-
 
-		<h2>Examples</h2>
 
-
 
-		<div>
 
-			See the [link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/RGBELoader.js RGBELoader]
 
-			for an example of a derived class.
 
-		</div>
 
-
 
-		<h2>Constructor</h2>
 
-
 
-		<h3>[name]( [page:LoadingManager manager] )</h3>
 
-		<div>
 
-		[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use.
 
-		Default is [page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
-
 
-		Creates a new [name].
 
-		</div>
 
-
 
-
 
-		<h2>Properties</h2>
 
-
 
-		<h3>[property:LoadingManager manager]</h3>
 
-		<div>
 
-		The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].
 
-		</div>
 
-
 
-
 
-		<h2>Methods</h2>
 
-
 
-		<h3>[method:null load]( [page:String url], [page:Function onLoad], [page:Function onProgress], [page:Function onError] )</h3>
 
-		<div>
 
-		[page:String url] — the path or URL to the file. This can also be a
 
-			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
 
-		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded texture.<br />
 
-		[page:Function onProgress] — Will be called while load progresses. The argument will be the XmlHttpRequest instance, that contain .[page:Integer total] and .[page:Integer loaded] bytes.<br />
 
-		[page:Function onError] — Will be called when load errors.<br />
 
-		</div>
 
-		<div>
 
-		Begin loading from url and pass the loaded texture to onLoad.
 
-		</div>
 
-
 
-		<h2>Source</h2>
 
-
 
-		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 
-	</body>
 
-</html>

+ 47 - 2
docs/api/loaders/DataTextureLoader.html
查看文件 

@@ -10,9 +10,54 @@
 
 	<body>
 
 		<h1>[name]</h1>
 
 
-		<div class="desc">This is an alias for the [page:BinaryTextureLoader BinaryTextureLoader].
 
-			See that page for details.
 
+		<div class="desc">
 
+		Abstract base class to load generic binary textures formats (rgbe, hdr, ...).
 
+		This uses the [page:FileLoader] internally for loading files, and creates a new
 
+		[page:DataTexture].
 
 		</div>
 
 
+		<h2>Examples</h2>
 
+
 
+		<div>
 
+			See the [link:https://github.com/mrdoob/three.js/blob/master/examples/js/loaders/RGBELoader.js RGBELoader]
 
+			for an example of a derived class.
 
+		</div>
 
+
 
+		<h2>Constructor</h2>
 
+
 
+		<h3>[name]( [page:LoadingManager manager] )</h3>
 
+		<div>
 
+		[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use.
 
+		Default is [page:LoadingManager THREE.DefaultLoadingManager].<br /><br />
 
+
 
+		Creates a new [name].
 
+		</div>
 
+
 
+
 
+		<h2>Properties</h2>
 
+
 
+		<h3>[property:LoadingManager manager]</h3>
 
+		<div>
 
+		The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].
 
+		</div>
 
+
 
+
 
+		<h2>Methods</h2>
 
+
 
+		<h3>[method:null load]( [page:String url], [page:Function onLoad], [page:Function onProgress], [page:Function onError] )</h3>
 
+		<div>
 
+		[page:String url] — the path or URL to the file. This can also be a
 
+			[link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
 
+		[page:Function onLoad] — Will be called when load completes. The argument will be the loaded texture.<br />
 
+		[page:Function onProgress] — Will be called while load progresses. The argument will be the XmlHttpRequest instance, that contain .[page:Integer total] and .[page:Integer loaded] bytes.<br />
 
+		[page:Function onError] — Will be called when load errors.<br />
 
+		</div>
 
+		<div>
 
+		Begin loading from url and pass the loaded texture to onLoad.
 
+		</div>
 
+
 
+		<h2>Source</h2>
 
+
 
+		[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 
 	</body>
 
 </html>

+ 0 - 1
docs/list.js
查看文件 

@@ -195,7 +195,6 @@ var list = {
 
 		"Loaders": [
 
 			[ "AnimationLoader", "api/loaders/AnimationLoader" ],
 
 			[ "AudioLoader", "api/loaders/AudioLoader" ],
 
-			[ "BinaryTextureLoader", "api/loaders/BinaryTextureLoader" ],
 
 			[ "BufferGeometryLoader", "api/loaders/BufferGeometryLoader" ],
 
 			[ "Cache", "api/loaders/Cache" ],
 
 			[ "CompressedTextureLoader", "api/loaders/CompressedTextureLoader" ],

+ 5 - 5
examples/js/loaders/RGBELoader.js
查看文件 

@@ -11,8 +11,8 @@ THREE.HDRLoader = THREE.RGBELoader = function ( manager ) {
 
 
 };
 
 
-// extend THREE.BinaryTextureLoader
 
-THREE.RGBELoader.prototype = Object.create( THREE.BinaryTextureLoader.prototype );
 
+// extend THREE.DataTextureLoader
 
+THREE.RGBELoader.prototype = Object.create( THREE.DataTextureLoader.prototype );
 
 
 // adapted from http://www.graphics.cornell.edu/~bjw/rgbe.html
 
 THREE.RGBELoader.prototype._parser = function( buffer ) {
 
@@ -112,16 +112,16 @@ THREE.RGBELoader.prototype._parser = function( buffer ) {
 
 
 					programtype: 'RGBE',              /* listed at beginning of file to identify it
 
 													* after "#?".  defaults to "RGBE" */
 
-														
+
 
 					format: '',                       /* RGBE format, default 32-bit_rle_rgbe */
 
 
 					gamma: 1.0,                       /* image has already been gamma corrected with
 
 													* given gamma.  defaults to 1.0 (no correction) */
 
-														
+
 
 					exposure: 1.0,                    /* a value of 1.0 in an image corresponds to
 
 													* <exposure> watts/steradian/m^2.
 
 													* defaults to 1.0 */
 
-														
+
 
 					width: 0, height: 0               /* image dimensions, width/height */
 
 
 				}

+ 8 - 0
src/Three.Legacy.js
查看文件 

@@ -35,6 +35,7 @@ import { Light } from './lights/Light.js';
 
 import { FileLoader } from './loaders/FileLoader.js';
 
 import { AudioLoader } from './loaders/AudioLoader.js';
 
 import { CubeTextureLoader } from './loaders/CubeTextureLoader.js';
 
+import { DataTextureLoader } from './loaders/DataTextureLoader.js';
 
 import { TextureLoader } from './loaders/TextureLoader.js';
 
 import { Material } from './materials/Material.js';
 
 import { LineBasicMaterial } from './materials/LineBasicMaterial.js';
 
@@ -269,6 +270,13 @@ export function XHRLoader( manager ) {
 
 
 }
 
 
+export function BinaryTextureLoader( manager ) {
 
+
 
+	console.warn( 'THREE.BinaryTextureLoader has been renamed to THREE.DataTextureLoader.' );
 
+	return new DataTextureLoader( manager );
 
+
 
+}
 
+
 
 //
 
 
 Object.assign( Box2.prototype, {

+ 1 - 1
src/Three.js
查看文件 

@@ -32,7 +32,7 @@ export { Texture } from './textures/Texture.js';
 
 export * from './geometries/Geometries.js';
 
 export * from './materials/Materials.js';
 
 export { CompressedTextureLoader } from './loaders/CompressedTextureLoader.js';
 
-export { BinaryTextureLoader, DataTextureLoader } from './loaders/BinaryTextureLoader.js';
 
+export { DataTextureLoader } from './loaders/DataTextureLoader.js';
 
 export { CubeTextureLoader } from './loaders/CubeTextureLoader.js';
 
 export { TextureLoader } from './loaders/TextureLoader.js';
 
 export { ObjectLoader } from './loaders/ObjectLoader.js';

+ 3 - 4
src/loaders/BinaryTextureLoader.js → src/loaders/DataTextureLoader.js
查看文件 

@@ -9,8 +9,7 @@ import { DefaultLoadingManager } from './LoadingManager';
 
  * Abstract Base class to load generic binary textures formats (rgbe, hdr, ...)
 
  */
 
 
-var DataTextureLoader = BinaryTextureLoader;
 
-function BinaryTextureLoader( manager ) {
 
+function DataTextureLoader( manager ) {
 
 
 	this.manager = ( manager !== undefined ) ? manager : DefaultLoadingManager;
 
 
@@ -19,7 +18,7 @@ function BinaryTextureLoader( manager ) {
 
 
 }
 
 
-Object.assign( BinaryTextureLoader.prototype, {
 
+Object.assign( DataTextureLoader.prototype, {
 
 
 	load: function ( url, onLoad, onProgress, onError ) {
 
 
@@ -93,4 +92,4 @@ Object.assign( BinaryTextureLoader.prototype, {
 
 } );
 
 
 
-export { BinaryTextureLoader, DataTextureLoader };
 
+export { DataTextureLoader };