Color Management: Documentation (#23430)

* Color Management: Documentation * Color Management: Clean up documentation * Documentation: Add color space constants. * Color management: Documentation revisions. * Color Management: Remove unused illustration. * Color Management: Revisions to documentation. * Color Management: Documentation should use title case.
mrdoob · Mar 16, 2022 · fe2bd0d · fe2bd0d
1 parent 775748d
commit fe2bd0d
Show file tree

Hide file tree

Showing 6 changed files with 428 additions and 19 deletions.
diff --git a/docs/api/en/constants/Core.html b/docs/api/en/constants/Core.html
@@ -12,19 +12,43 @@ <h1>Core Constants</h1>
 		<h2>Revision Number</h2>
 
 		<code>
-		THREE.REVISION
+THREE.REVISION
 		</code>
 
 		<div id="rev">
 			The current three.js [link:https://github.com/mrdoob/three.js/releases revision number].
 		</div>
 
-    <h2>Mouse Buttons</h2>
-    <code>
-		THREE.MOUSE.LEFT
-		THREE.MOUSE.MIDDLE
-		THREE.MOUSE.RIGHT
-    </code>
+		<h2>Color Spaces</h2>
+		<code>
+THREE.SRGBColorSpace
+THREE.LinearSRGBColorSpace
+		</code>
+
+		<p>
+			[page:SRGBColorSpace] (“sRGB”) refers to the color space defined by the Rec. 709 primaries, D65
+			white point, and nonlinear sRGB transfer functions. sRGB is the default color space in
+			CSS, and is often found in color palettes and color pickers. Colors expressed in
+			hexadecimal or CSS notation are typically in the sRGB color space.
+		</p>
+
+		<p>
+			[page:LinearSRGBColorSpace] (“Linear-sRGB”) refers to the sRGB color space (above) with
+			linear transfer functions. Linear-sRGB is the working color space in three.js, used
+			throughout most of the rendering process. RGB components found in three.js materials
+			and shaders are in the Linear-sRGB color space.
+		D</p>
+
+		<p>
+			For further background and usage, see <i>Color management</i>.
+		</p>
+
+		<h2>Mouse Buttons</h2>
+		<code>
+THREE.MOUSE.LEFT
+THREE.MOUSE.MIDDLE
+THREE.MOUSE.RIGHT
+		</code>
 
 		<h2>Source</h2>
 

diff --git a/docs/api/ko/constants/Core.html b/docs/api/ko/constants/Core.html
@@ -19,12 +19,36 @@ <h2>리비전 번호</h2>
 			three.js의 현재 리비전 번호([link:https://github.com/mrdoob/three.js/releases revision number]).
 		</div>
 
-    <h2>마우스 버튼</h2>
-    <code>
-		THREE.MOUSE.LEFT
-		THREE.MOUSE.MIDDLE
-		THREE.MOUSE.RIGHT
-    </code>
+		<h2>Color Spaces</h2>
+		<code>
+THREE.SRGBColorSpace
+THREE.LinearSRGBColorSpace
+		</code>
+
+		<p>
+			[page:SRGBColorSpace] (“sRGB”) refers to the color space defined by the Rec. 709 primaries, D65
+			white point, and nonlinear sRGB transfer functions. sRGB is the default color space in
+			CSS, and is often found in color palettes and color pickers. Colors expressed in
+			hexadecimal or CSS notation are typically in the sRGB color space.
+		</p>
+
+		<p>
+			[page:LinearSRGBColorSpace] (“Linear-sRGB”) refers to the sRGB color space (above) with
+			linear transfer functions. Linear-sRGB is the working color space in three.js, used
+			throughout most of the rendering process. RGB components found in three.js materials
+			and shaders are in the Linear-sRGB color space.
+		D</p>
+
+		<p>
+			For further background and usage, see <i>Color management</i>.
+		</p>
+
+		<h2>마우스 버튼</h2>
+		<code>
+			THREE.MOUSE.LEFT
+			THREE.MOUSE.MIDDLE
+			THREE.MOUSE.RIGHT
+		</code>
 
 		<h2>소스 코드</h2>
 

diff --git a/docs/api/zh/constants/Core.html b/docs/api/zh/constants/Core.html
@@ -19,12 +19,36 @@ <h2>修订版本号</h2>
 			当前three.js的修订版本号（ [link:https://github.com/mrdoob/three.js/releases revision number]）。
 		</div>
 
-	<h2>鼠标按钮</h2>
-	<code>
-		THREE.MOUSE.LEFT
-		THREE.MOUSE.MIDDLE
-		THREE.MOUSE.RIGHT
-	</code>
+		<h2>Color Spaces</h2>
+		<code>
+THREE.SRGBColorSpace
+THREE.LinearSRGBColorSpace
+		</code>
+
+		<p>
+			[page:SRGBColorSpace] (“sRGB”) refers to the color space defined by the Rec. 709 primaries, D65
+			white point, and nonlinear sRGB transfer functions. sRGB is the default color space in
+			CSS, and is often found in color palettes and color pickers. Colors expressed in
+			hexadecimal or CSS notation are typically in the sRGB color space.
+		</p>
+
+		<p>
+			[page:LinearSRGBColorSpace] (“Linear-sRGB”) refers to the sRGB color space (above) with
+			linear transfer functions. Linear-sRGB is the working color space in three.js, used
+			throughout most of the rendering process. RGB components found in three.js materials
+			and shaders are in the Linear-sRGB color space.
+		D</p>
+
+		<p>
+			For further background and usage, see <i>Color management</i>.
+		</p>
+
+		<h2>鼠标按钮</h2>
+		<code>
+			THREE.MOUSE.LEFT
+			THREE.MOUSE.MIDDLE
+			THREE.MOUSE.RIGHT
+		</code>
 
 		<h2>源代码</h2>
 

diff --git a/docs/list.json b/docs/list.json
@@ -12,6 +12,7 @@
 				"Drawing lines": "manual/en/introduction/Drawing-lines",
 				"Creating text": "manual/en/introduction/Creating-text",
 				"Loading 3D models": "manual/en/introduction/Loading-3D-models",
+				"Color management": "manual/en/introduction/Color-management",
 				"Libraries and Plugins": "manual/en/introduction/Libraries-and-Plugins",
 				"FAQ": "manual/en/introduction/FAQ",
 				"Useful links": "manual/en/introduction/Useful-links"