Docs: Add `dispersion`. (#28058)

* Docs: Add `dispersion`.

* Examples: Add transmission tag to dispersion demo.

* Docs: Update `dispersion` description.

docs/api/ar/materials/MeshPhysicalMaterial.html

@@ -153,7 +153,14 @@
 		
 		يستخدم هذا بواسطة [page:WebGLRenderer] لتحديد المُظَهِّرات.
 		</p>
-		
+
+		<h3>[property:Float dispersion]</h3>
+		<p>
+			Defines the strength of the angular separation of colors (chromatic aberration) transmitting through a relatively clear volume.
+			Any value zero or larger is valid, the typical range of realistic values is `[0, 1]`.
+			Default is `0` (no dispersion).
+			This property can be only be used with transmissive objects, see [page:.transmission].
+		</p>
 
 		<h3>[property:Float ior]</h3>
 		<p>

docs/api/en/materials/MeshPhysicalMaterial.html

@@ -187,6 +187,14 @@
 			This is used by the [page:WebGLRenderer] for selecting shaders.
 		</p>
 
+		<h3>[property:Float dispersion]</h3>
+		<p>
+			Defines the strength of the angular separation of colors (chromatic aberration) transmitting through a relatively clear volume.
+			Any value zero or larger is valid, the typical range of realistic values is `[0, 1]`.
+			Default is `0` (no dispersion).
+			This property can be only be used with transmissive objects, see [page:.transmission].
+		</p>
+
 		<h3>[property:Float ior]</h3>
 		<p>
 			Index-of-refraction for non-metallic materials, from `1.0` to `2.333`.

docs/api/fr/materials/MeshPhysicalMaterial.html

@@ -131,6 +131,14 @@
 			Est utilisé par [page:WebGLRenderer] pour sélectionner les shaders.
 		</p>
 
+		<h3>[property:Float dispersion]</h3>
+		<p>
+			Defines the strength of the angular separation of colors (chromatic aberration) transmitting through a relatively clear volume.
+			Any value zero or larger is valid, the typical range of realistic values is `[0, 1]`.
+			Default is `0` (no dispersion).
+			This property can be only be used with transmissive objects, see [page:.transmission].
+		</p>
+
 		<h3>[property:Float ior]</h3>
 		<p>
 			Indice de réfraction pour les matériaux non métalliques, de "1,0" à "2,333". La valeur par défaut est `1.5`.<br />

docs/api/it/materials/MeshPhysicalMaterial.html

@@ -136,6 +136,14 @@
 			Questo viene utilizzato dal [page:WebGLRenderer] per selezionare gli shader.
 		</p>
 
+		<h3>[property:Float dispersion]</h3>
+		<p>
+			Defines the strength of the angular separation of colors (chromatic aberration) transmitting through a relatively clear volume.
+			Any value zero or larger is valid, the typical range of realistic values is `[0, 1]`.
+			Default is `0` (no dispersion).
+			This property can be only be used with transmissive objects, see [page:.transmission].
+		</p>
+
 		<h3>[property:Float ior]</h3>
 		<p>
 			Indice di rifrazione per materiali non metallici, da `1.0` a `2.333`. Il valore predefinito è `1.5`.<br />

docs/api/zh/materials/MeshPhysicalMaterial.html

@@ -119,6 +119,14 @@
 			[page:WebGLRenderer]使用它来选择shaders。
 		</p>
 
+		<h3>[property:Float dispersion]</h3>
+		<p>
+			Defines the strength of the angular separation of colors (chromatic aberration) transmitting through a relatively clear volume.
+			Any value zero or larger is valid, the typical range of realistic values is `[0, 1]`.
+			Default is `0` (no dispersion).
+			This property can be only be used with transmissive objects, see [page:.transmission].
+		</p>
+
 		<h3>[property:Float ior]</h3>
 		<p>
 			为非金属材质所设置的折射率，范围由*1.0*到*2.333*。默认为*1.5*。

docs/examples/en/exporters/GLTFExporter.html

@@ -41,6 +41,7 @@
 		<ul>
 			<li>KHR_lights_punctual</li>
 			<li>KHR_materials_clearcoat</li>
+			<li>KHR_materials_dispersion</li>
 			<li>KHR_materials_emissive_strength</li>
 			<li>KHR_materials_ior</li>
 			<li>KHR_materials_iridescence</li>		

docs/examples/en/loaders/GLTFLoader.html

@@ -46,6 +46,7 @@
 		<ul>
 			<li>KHR_draco_mesh_compression</li>
 			<li>KHR_materials_clearcoat</li>
+			<li>KHR_materials_dispersion</li>
 			<li>KHR_materials_ior</li>
 			<li>KHR_materials_specular</li>
 			<li>KHR_materials_transmission</li>

docs/examples/zh/exporters/GLTFExporter.html

@@ -39,6 +39,7 @@
 	<ul>
 		<li>KHR_lights_punctual</li>
 		<li>KHR_materials_clearcoat</li>
+		<li>KHR_materials_dispersion</li>
 		<li>KHR_materials_emissive_strength</li>
 		<li>KHR_materials_ior</li>
 		<li>KHR_materials_iridescence</li>

docs/examples/zh/loaders/GLTFLoader.html

@@ -45,6 +45,7 @@
 		<ul>
 			<li>KHR_draco_mesh_compression</li>
 			<li>KHR_materials_clearcoat</li>
+			<li>KHR_materials_dispersion</li>
 			<li>KHR_materials_ior</li>
 			<li>KHR_materials_specular</li>
 			<li>KHR_materials_transmission</li>

examples/tags.json

@@ -39,6 +39,7 @@
 	"webgl_lights_pointlights": [ "multiple" ],
 	"webgl_lines_fat": [ "gpu", "stats", "panel" ],
 	"webgl_lines_fat_raycasting": [ "gpu", "stats", "panel", "raycast" ],
+	"webgl_loader_gltf_dispersion": [ "transmission" ],
 	"webgl_loader_ifc": [ "external" ],
 	"webgl_loader_ldraw": [ "lego" ],
 	"webgl_loader_pdb": [ "molecules", "css2d" ],