From 4b648e2d6e09d260b95adfd829012c40b5855b4d Mon Sep 17 00:00:00 2001
From: Michael Herzog <michael.herzog@human-interactive.org>
Date: Fri, 29 Apr 2022 09:29:06 +0200
Subject: [PATCH] Docs: Mentioned the need for ImageBitmap.close(). (#23959)

---
 docs/examples/en/loaders/GLTFLoader.html                   | 5 +++++
 docs/examples/zh/loaders/GLTFLoader.html                   | 5 +++++
 docs/manual/ar/introduction/How-to-dispose-of-objects.html | 5 +++++
 docs/manual/en/introduction/How-to-dispose-of-objects.html | 5 +++++
 docs/manual/ja/introduction/How-to-dispose-of-objects.html | 7 ++++++-
 docs/manual/ko/introduction/How-to-dispose-of-objects.html | 7 ++++++-
 docs/manual/zh/introduction/How-to-dispose-of-objects.html | 5 +++++
 7 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/docs/examples/en/loaders/GLTFLoader.html b/docs/examples/en/loaders/GLTFLoader.html
index 57b8cbcc11cfce..2074f7d531ef36 100644
--- a/docs/examples/en/loaders/GLTFLoader.html
+++ b/docs/examples/en/loaders/GLTFLoader.html
@@ -20,6 +20,11 @@ <h1>[name]</h1>
 		textures, skins, skeletons, morph targets, animations, lights, and/or cameras.
 		</p>
 
+		<p>
+			[name] uses [page:ImageBitmapLoader] whenever possible. Be advised that image bitmaps are not automatically GC-collected when they are no longer referenced,
+			and they require special handling during the disposal process. More information in the [link:https://threejs.org/docs/#manual/en/introduction/How-to-dispose-of-objects How to dispose of objects] guide.
+		</p>
+
 		<h2>Extensions</h2>
 
 		<p>
diff --git a/docs/examples/zh/loaders/GLTFLoader.html b/docs/examples/zh/loaders/GLTFLoader.html
index 725d3f16aaeb3c..6e4e7d9b3e04e8 100644
--- a/docs/examples/zh/loaders/GLTFLoader.html
+++ b/docs/examples/zh/loaders/GLTFLoader.html
@@ -19,6 +19,11 @@ <h1>GLTF加载器（[name]）</h1>
 		包括网格、材质、贴图、蒙皮、骨架、变形目标、动画、灯光以及摄像机。
 		</p>
 
+		<p>
+			[name] uses [page:ImageBitmapLoader] whenever possible. Be advised that image bitmaps are not automatically GC-collected when they are no longer referenced,
+			and they require special handling during the disposal process. More information in the [link:https://threejs.org/docs/#manual/en/introduction/How-to-dispose-of-objects How to dispose of objects] guide.
+		</p>
+
 		<h2>扩展</h2>
 
 		<p>
diff --git a/docs/manual/ar/introduction/How-to-dispose-of-objects.html b/docs/manual/ar/introduction/How-to-dispose-of-objects.html
index 644130dccff00f..478ab6ec33fa3c 100644
--- a/docs/manual/ar/introduction/How-to-dispose-of-objects.html
+++ b/docs/manual/ar/introduction/How-to-dispose-of-objects.html
@@ -37,6 +37,11 @@ <h2>الأنسجة (Textures)</h2>
 			على غرار المخازن المؤقتة ، لا يمكن حذف هذا الكائن إلا عن طريق استدعاء [page:Texture.dispose]().
 		</p>
 
+		<p>
+			If you use an *ImageBitmap* as the texture's data source, you have to call [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap/close ImageBitmap.close]() at the application level to dispose of all CPU-side resources.
+			An automated call of *ImageBitmap.close()* in [page:Texture.dispose]() is not possible, since the image bitmap becomes unusable, and the engine has no way of knowing if the image bitmap is used elsewhere.
+		</p>
+
 		<h2>أهداف العرض</h2>
 
 		<p>
diff --git a/docs/manual/en/introduction/How-to-dispose-of-objects.html b/docs/manual/en/introduction/How-to-dispose-of-objects.html
index 3a8ff2b4886146..3b5a00c385808f 100644
--- a/docs/manual/en/introduction/How-to-dispose-of-objects.html
+++ b/docs/manual/en/introduction/How-to-dispose-of-objects.html
@@ -44,6 +44,11 @@ <h2>Textures</h2>
 		Similar to buffers, this object can only be deleted by calling [page:Texture.dispose]().
 	</p>
 
+	<p>
+		If you use an *ImageBitmap* as the texture's data source, you have to call [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap/close ImageBitmap.close]() at the application level to dispose of all CPU-side resources.
+		An automated call of *ImageBitmap.close()* in [page:Texture.dispose]() is not possible, since the image bitmap becomes unusable, and the engine has no way of knowing if the image bitmap is used elsewhere.
+	</p>
+
 	<h2>Render Targets</h2>
 
 	<p>
diff --git a/docs/manual/ja/introduction/How-to-dispose-of-objects.html b/docs/manual/ja/introduction/How-to-dispose-of-objects.html
index 545f92ed443ad9..e556d1bee27e40 100644
--- a/docs/manual/ja/introduction/How-to-dispose-of-objects.html
+++ b/docs/manual/ja/introduction/How-to-dispose-of-objects.html
@@ -50,6 +50,11 @@ <h2>Textures</h2>
 		バッファと同様に、このオブジェクトは[page:Texture.dispose]()を呼ぶことでしか削除できません。
 	</p>
 
+	<p>
+		If you use an *ImageBitmap* as the texture's data source, you have to call [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap/close ImageBitmap.close]() at the application level to dispose of all CPU-side resources.
+		An automated call of *ImageBitmap.close()* in [page:Texture.dispose]() is not possible, since the image bitmap becomes unusable, and the engine has no way of knowing if the image bitmap is used elsewhere.
+	</p>
+
 	<h2>Render Targets</h2>
 
 	<p>
@@ -127,4 +132,4 @@ <h2>Examples that demonstrate the usage of dispose()</h2>
 
 </body>
 
-</html>
\ No newline at end of file
+</html>
diff --git a/docs/manual/ko/introduction/How-to-dispose-of-objects.html b/docs/manual/ko/introduction/How-to-dispose-of-objects.html
index 5febb311eae2fe..ab18e557b98f26 100644
--- a/docs/manual/ko/introduction/How-to-dispose-of-objects.html
+++ b/docs/manual/ko/introduction/How-to-dispose-of-objects.html
@@ -42,6 +42,11 @@ <h2>텍스쳐</h2>
         buffer와 비슷하게, 이 오브젝트는 [page:Texture.dispose]() 호출로만 삭제가 가능합니다.
 	</p>
 
+	<p>
+        If you use an *ImageBitmap* as the texture's data source, you have to call [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap/close ImageBitmap.close]() at the application level to dispose of all CPU-side resources.
+        An automated call of *ImageBitmap.close()* in [page:Texture.dispose]() is not possible, since the image bitmap becomes unusable, and the engine has no way of knowing if the image bitmap is used elsewhere.
+	</p>
+
 	<h2>렌더링 대상</h2>
 
 	<p>
@@ -112,4 +117,4 @@ <h2>dispose() 사용법 예제</h2>
 
 </body>
 
-</html>
\ No newline at end of file
+</html>
diff --git a/docs/manual/zh/introduction/How-to-dispose-of-objects.html b/docs/manual/zh/introduction/How-to-dispose-of-objects.html
index 84345e1f136adf..766f9e506572af 100644
--- a/docs/manual/zh/introduction/How-to-dispose-of-objects.html
+++ b/docs/manual/zh/introduction/How-to-dispose-of-objects.html
@@ -44,6 +44,11 @@ <h2>纹理</h2>
 		和buffer相似，该对象只能通过调用[page:Texture.dispose]()来删除。
 	</p>
 
+	<p>
+		If you use an *ImageBitmap* as the texture's data source, you have to call [link:https://developer.mozilla.org/en-US/docs/Web/API/ImageBitmap/close ImageBitmap.close]() at the application level to dispose of all CPU-side resources.
+		An automated call of *ImageBitmap.close()* in [page:Texture.dispose]() is not possible, since the image bitmap becomes unusable, and the engine has no way of knowing if the image bitmap is used elsewhere.
+	</p>
+
 	<h2>渲染目标</h2>
 
 	<p>