Revert "WebGLRenderer: Remove RGBEEncoding and RGBEFormat. (mrdoob#23060)"

This reverts commit cee9706.

Author: chubei-oppen

docs/api/en/constants/Textures.html

@@ -151,6 +151,7 @@ <h2>Formats</h2>
 		THREE.RGBAIntegerFormat
 		THREE.LuminanceFormat
 		THREE.LuminanceAlphaFormat
+		THREE.RGBEFormat
 		THREE.DepthFormat
 		THREE.DepthStencilFormat
 		</code>
@@ -198,6 +199,8 @@ <h2>Formats</h2>
 		The same process occurs as for the [page:constant LuminanceFormat], except that the
 		alpha channel may have values other than *1.0*.<br /><br />
 
+		[page:constant RGBEFormat] is identical to [page:constant RGBAFormat].<br /><br />
+
 		[page:constant DepthFormat] reads each element as a single depth value, converts it to floating point, and clamps to the range [0,1].
 		This is the default for [page:DepthTexture DepthTexture].<br /><br />
 
@@ -556,6 +559,7 @@ <h2>Encoding</h2>
 		<code>
 		THREE.LinearEncoding
 		THREE.sRGBEncoding
+		THREE.RGBEEncoding
 		THREE.BasicDepthPacking
 		THREE.RGBADepthPacking
 		</code>

docs/api/en/extras/PMREMGenerator.html

@@ -42,15 +42,15 @@ <h3>[method:WebGLRenderTarget fromEquirectangular]( [param:Texture equirectangul
 		<p>
 			[page:Texture equirectangular] - The equirectangular texture.<br /><br />
 
-			Generates a PMREM from an equirectangular texture, which can be either LDR or HDR.
+			Generates a PMREM from an equirectangular texture, which can be either LDR (RGBFormat) or HDR (RGBEFormat).
 			The ideal input image size is 1k (1024 x 512), as this matches best with the 256 x 256 cubemap output.
 		</p>
 
 		<h3>[method:WebGLRenderTarget fromCubemap]( [param:CubeTexture cubemap] )</h3>
 		<p>
 			[page:CubeTexture cubemap] - The cubemap texture.<br /><br />
 
-			Generates a PMREM from an cubemap texture, which can be either LDR or HDR.
+			Generates a PMREM from an cubemap texture, which can be either LDR (RGBFormat) or HDR (RGBEFormat).
 			The ideal input cube size is 256 x 256, as this matches best with the 256 x 256 cubemap output.
 		</p>
 

docs/api/ko/constants/Textures.html

@@ -148,6 +148,7 @@ <h2>포맷</h2>
 		THREE.RGBAIntegerFormat
 		THREE.LuminanceFormat
 		THREE.LuminanceAlphaFormat
+		THREE.RGBEFormat
 		THREE.DepthFormat
 		THREE.DepthStencilFormat
 		</code>
@@ -194,6 +195,8 @@ <h2>포맷</h2>
 		The same process occurs as for the [page:constant LuminanceFormat]와 같은 절차가 이루어지며, 알파 채널에 *1.0* 이외의 값이 들어갈 수 있다는 점만 다릅니다.
 		<br /><br />
 
+		[page:constant RGBEFormat]은 [page:constant RGBAFormat]과 동일합니다..<br /><br />
+
 		[page:constant DepthFormat]은 각 요소를 단일 깊이 값으로 일거들이며 부동 소수점으로 변환하고, [0,1]범위에 고정합니다.
 		[page:DepthTexture DepthTexture]의 기본값이기도 합니다.<br /><br />
 
@@ -550,6 +553,7 @@ <h2>인코딩</h2>
 		<code>
 		THREE.LinearEncoding
 		THREE.sRGBEncoding
+		THREE.RGBEEncoding
 		THREE.BasicDepthPacking
 		THREE.RGBADepthPacking
 		</code>

docs/api/ko/extras/PMREMGenerator.html

@@ -11,7 +11,7 @@ <h1>[name]</h1>
 
 		<p class="desc">
 			이 클래스는 큐브맵 환경 텍스처로부터 사전 필터링된 Mipmap Radiance Environment Map(PMREM)을 생성합니다.
-이를 통해 재질의 거칠기에 따라 다양한 수준의 블러를 빠르게 적용할 수 있습니다. RGBE와 같은 비선형 형식을 지원할 수 있도록 사용자 지정 보간을 수행할 수 있는 특수 CubeUV 형식으로 포장되어 있습니다.
+이를 통해 재질의 거칠기에 따라 다양한 수준의 블러를 빠르게 적용할 수 있습니다. RGBE와 같은 비선형 형식을 지원할 수 있도록 사용자 지정 보간을 수행할 수 있는 특수 CubeUV 형식으로 포장되어 있습니다. 
 기존의 mipmap 체인과는 달리, LOD_MIN 수준까지만 내려가며(위), 더 높은 거칠기 수준과 연관된 동일한 LOD_MIN 해상도에서 훨씬 더 많은 필터링된 'mips'를 생성합니다.
 이러한 방법으로 샘플링 계산을 제한하면서 확산 조명을 부드럽게 보간하기 위한 해상도를 유지합니다.
 		</p>
@@ -40,15 +40,15 @@ <h3>[method:WebGLRenderTarget fromEquirectangular]( [param:Texture equirectangul
 		<p>
 			[page:Texture equirectangular] - 등장방형 텍스쳐입니다.<br /><br />
 
-			LDR 또는 HDR일 수 있는 등장방형 텍스처로부터 PMREM을 생성합니다.
+			LDR(RGBFormat) 또는 HDR(RGBEFormat)일 수 있는 등장방형 텍스처로부터 PMREM을 생성합니다.
 			이상적인 입력 이미지 크기는 1k(1024 x 512)로, 256 x 256 큐브 맵 출력과 가장 잘 일치합니다.
 		</p>
 
 		<h3>[method:WebGLRenderTarget fromCubemap]( [param:CubeTexture cubemap] )</h3>
 		<p>
 			[page:CubeTexture cubemap] - 큐브맵 텍스쳐입니다.<br /><br />
 
-			LDR 또는 HDR일 수 있는 큐브맵 텍스처로부터 PMREM을 생성합니다.
+			LDR(RGBFormat) 또는 HDR(RGBEFormat)일 수 있는 큐브맵 텍스처로부터 PMREM을 생성합니다.
 			이상적인 입력 이미지 크기는 1k(1024 x 512)로, 256 x 256 큐브 맵 출력과 가장 잘 일치합니다.
 		</p>
 
@@ -64,8 +64,8 @@ <h3>[method:undefined compileEquirectangularShader]()</h3>
 
 		<h3>[method:undefined dispose]()</h3>
 		<p>
-			PMREM 제너레이터의 내장 메모리를 폐기합니다.
-			PMREMGenerator는 정적 클래스이므로 두 개 이상의 PMREMGenerator 개체가 필요하지 않습니다.
+			PMREM 제너레이터의 내장 메모리를 폐기합니다. 
+			PMREMGenerator는 정적 클래스이므로 두 개 이상의 PMREMGenerator 개체가 필요하지 않습니다. 
 			이 경우 둘 중 하나에 대해 dispose()를 호출하면 다른 항목도 사용할 수 없게 됩니다.
 		</p>
 

docs/api/zh/constants/Textures.html

@@ -141,6 +141,7 @@ <h2>格式</h2>
 		THREE.RGBAIntegerFormat
 		THREE.LuminanceFormat
 		THREE.LuminanceAlphaFormat
+		THREE.RGBEFormat
 		THREE.DepthFormat
 		THREE.DepthStencilFormat
 	</code>
@@ -184,6 +185,8 @@ <h2>格式</h2>
 		[page:constant LuminanceAlphaFormat] 将每个元素同时作为亮度分量和Alpha分量来读取。
 		和上面[page:constant LuminanceFormat]的处理过程是一致的，除了Alpha分量具有除了*1.0*以外的值。<br /><br />
 
+		[page:constant RGBEFormat] 与 [page:constant RGBAFormat] 是相同的。<br /><br />
+
 		[page:constant DepthFormat]将每个元素作为单独的深度值来读取，将其转换为范围限制在[0,1]区间的浮点数。
 		它是[page:DepthTexture DepthTexture]的默认值。<br /><br />
 
@@ -545,6 +548,7 @@ <h2>编码</h2>
 	<code>
 		THREE.LinearEncoding
 		THREE.sRGBEncoding
+		THREE.RGBEEncoding
 		THREE.BasicDepthPacking
 		THREE.RGBADepthPacking
 		</code>

docs/api/zh/extras/PMREMGenerator.html

@@ -42,15 +42,15 @@ <h3>[method:WebGLRenderTarget fromEquirectangular]( [param:Texture equirectangul
 		<p>
 			[page:Texture equirectangular] - The equirectangular texture.<br /><br />
 
-			Generates a PMREM from an equirectangular texture, which can be either LDR or HDR.
+			Generates a PMREM from an equirectangular texture, which can be either LDR (RGBFormat) or HDR (RGBEFormat).
 			The ideal input image size is 1k (1024 x 512), as this matches best with the 256 x 256 cubemap output.
 		</p>
 
 		<h3>[method:WebGLRenderTarget fromCubemap]( [param:CubeTexture cubemap] )</h3>
 		<p>
 			[page:CubeTexture cubemap] - The cubemap texture.<br /><br />
 
-			Generates a PMREM from an cubemap texture, which can be either LDR or HDR.
+			Generates a PMREM from an cubemap texture, which can be either LDR (RGBFormat) or HDR (RGBEFormat).
 			The ideal input cube size is 256 x 256, as this matches best with the 256 x 256 cubemap output.
 		</p>
 

editor/js/libs/ui.three.js

@@ -56,7 +56,7 @@ class UITexture extends UISpan {
 
 					// assuming RGBE/Radiance HDR iamge format
 
-					const loader = new RGBELoader();
+					const loader = new RGBELoader().setDataType( THREE.FloatType );
 					loader.load( event.target.result, function ( hdrTexture ) {
 
 						hdrTexture.sourceFile = file.name;

examples/jsm/loaders/HDRCubeTextureLoader.js

@@ -7,7 +7,11 @@ import {
 	LinearEncoding,
 	LinearFilter,
 	Loader,
-	RGBFormat
+	NearestFilter,
+	RGBAFormat,
+	RGBEEncoding,
+	RGBFormat,
+	UnsignedByteType
 } from '../../../build/three.module.js';
 import { RGBELoader } from '../loaders/RGBELoader.js';
 
@@ -43,6 +47,15 @@ class HDRCubeTextureLoader extends Loader {
 
 		switch ( texture.type ) {
 
+			case UnsignedByteType:
+
+				texture.encoding = RGBEEncoding;
+				texture.format = RGBAFormat;
+				texture.minFilter = NearestFilter;
+				texture.magFilter = NearestFilter;
+				texture.generateMipmaps = false;
+				break;
+
 			case FloatType:
 
 				texture.encoding = LinearEncoding;

examples/jsm/loaders/RGBELoader.js

@@ -5,7 +5,11 @@ import {
 	HalfFloatType,
 	LinearEncoding,
 	LinearFilter,
+	NearestFilter,
+	RGBEEncoding,
+	RGBEFormat,
 	RGBFormat,
+	UnsignedByteType
 } from '../../../build/three.module.js';
 
 // https://github.com/mrdoob/three.js/issues/5552
@@ -374,6 +378,13 @@ class RGBELoader extends DataTextureLoader {
 
 				switch ( this.type ) {
 
+					case UnsignedByteType:
+
+						data = image_rgba_data;
+						format = RGBEFormat; // handled as THREE.RGBAFormat in shaders
+						type = UnsignedByteType;
+						break;
+
 					case FloatType:
 
 						numElements = image_rgba_data.length / 4;
@@ -444,6 +455,15 @@ class RGBELoader extends DataTextureLoader {
 
 			switch ( texture.type ) {
 
+				case UnsignedByteType:
+
+					texture.encoding = RGBEEncoding;
+					texture.minFilter = NearestFilter;
+					texture.magFilter = NearestFilter;
+					texture.generateMipmaps = false;
+					texture.flipY = true;
+					break;
+
 				case FloatType:
 
 					texture.encoding = LinearEncoding;

examples/jsm/nodes/utils/ColorSpaceNode.js

@@ -1,5 +1,6 @@
 import {
 	LinearEncoding,
+	RGBEEncoding,
 	sRGBEncoding
 } from '../../../../build/three.module.js';
 
@@ -122,10 +123,31 @@ ColorSpaceNode.Nodes = ( function () {
 		}`
 	);
 
+	const RGBEToLinear = new FunctionNode( /* glsl */`
+		vec4 RGBEToLinear( in vec4 value ) {
+
+			return vec4( value.rgb * exp2( value.a * 255.0 - 128.0 ), 1.0 );
+
+		}`
+	);
+
+	const LinearToRGBE = new FunctionNode( /* glsl */`
+		vec4 LinearToRGBE( in vec4 value ) {
+
+			float maxComponent = max( max( value.r, value.g ), value.b );
+			float fExp = clamp( ceil( log2( maxComponent ) ), -128.0, 127.0 );
+			return vec4( value.rgb / exp2( fExp ), ( fExp + 128.0 ) / 255.0 );
+
+		}`
+	);
+
+
 	return {
 		LinearToLinear: LinearToLinear,
 		sRGBToLinear: sRGBToLinear,
-		LinearTosRGB: LinearTosRGB
+		LinearTosRGB: LinearTosRGB,
+		RGBEToLinear: RGBEToLinear,
+		LinearToRGBE: LinearToRGBE
 	};
 
 } )();
@@ -135,6 +157,9 @@ ColorSpaceNode.LINEAR_TO_LINEAR = 'LinearToLinear';
 ColorSpaceNode.SRGB_TO_LINEAR = 'sRGBToLinear';
 ColorSpaceNode.LINEAR_TO_SRGB = 'LinearTosRGB';
 
+ColorSpaceNode.RGBE_TO_LINEAR = 'RGBEToLinear';
+ColorSpaceNode.LINEAR_TO_RGBE = 'LinearToRGBE';
+
 ColorSpaceNode.getEncodingComponents = function ( encoding ) {
 
 	switch ( encoding ) {
@@ -143,6 +168,13 @@ ColorSpaceNode.getEncodingComponents = function ( encoding ) {
 			return [ 'Linear' ];
 		case sRGBEncoding:
 			return [ 'sRGB' ];
+<<<<<<< HEAD
+=======
+		case RGBEEncoding:
+			return [ 'RGBE' ];
+		case GammaEncoding:
+			return [ 'Gamma', new ExpressionNode( 'float( GAMMA_FACTOR )', 'f' ) ];
+>>>>>>> parent of cee9706c1c... WebGLRenderer: Remove RGBEEncoding and RGBEFormat. (#23060)
 
 	}