Skip to content

Commit a100613

Browse files
committed
Docs: Mentioned the need for ImageBitmap.close().
1 parent 66d3ccb commit a100613

File tree

7 files changed

+42
-2
lines changed

7 files changed

+42
-2
lines changed

docs/examples/en/loaders/GLTFLoader.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,11 @@ <h1>[name]</h1>
2020
textures, skins, skeletons, morph targets, animations, lights, and/or cameras.
2121
</p>
2222

23+
<p>
24+
[name] uses [page:ImageBitmapLoader] whenever possible. Please keep in mind that image bitmaps are not automatically GC-collected when they are not referenced anymore.
25+
They require a 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.
26+
</p>
27+
2328
<h2>Extensions</h2>
2429

2530
<p>

docs/examples/zh/loaders/GLTFLoader.html

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,11 @@ <h1>GLTF加载器([name])</h1>
1919
包括网格、材质、贴图、蒙皮、骨架、变形目标、动画、灯光以及摄像机。
2020
</p>
2121

22+
<p>
23+
[name] uses [page:ImageBitmapLoader] whenever possible. Please keep in mind that image bitmaps are not automatically GC-collected when they are not referenced anymore.
24+
They require a special handling during the disposal process. More information in the [link:https://threejs.org/docs/#manual/zh/introduction/How-to-dispose-of-objects How to dispose of objects] guide.
25+
</p>
26+
2227
<h2>扩展</h2>
2328

2429
<p>

docs/manual/ar/introduction/How-to-dispose-of-objects.html

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,12 @@ <h2>الأنسجة (Textures)</h2>
3737
على غرار المخازن المؤقتة ، لا يمكن حذف هذا الكائن إلا عن طريق استدعاء [page:Texture.dispose]().
3838
</p>
3939

40+
<p>
41+
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]()
42+
on 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
43+
unusable and the engine does not know whether the image bitmap is used elsewhere or not.
44+
</p>
45+
4046
<h2>أهداف العرض</h2>
4147

4248
<p>

docs/manual/en/introduction/How-to-dispose-of-objects.html

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,12 @@ <h2>Textures</h2>
4444
Similar to buffers, this object can only be deleted by calling [page:Texture.dispose]().
4545
</p>
4646

47+
<p>
48+
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]()
49+
on 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
50+
unusable and the engine does not know whether the image bitmap is used elsewhere or not.
51+
</p>
52+
4753
<h2>Render Targets</h2>
4854

4955
<p>

docs/manual/ja/introduction/How-to-dispose-of-objects.html

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,12 @@ <h2>Textures</h2>
5050
バッファと同様に、このオブジェクトは[page:Texture.dispose]()を呼ぶことでしか削除できません。
5151
</p>
5252

53+
<p>
54+
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]()
55+
on 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
56+
unusable and the engine does not know whether the image bitmap is used elsewhere or not.
57+
</p>
58+
5359
<h2>Render Targets</h2>
5460

5561
<p>
@@ -127,4 +133,4 @@ <h2>Examples that demonstrate the usage of dispose()</h2>
127133

128134
</body>
129135

130-
</html>
136+
</html>

docs/manual/ko/introduction/How-to-dispose-of-objects.html

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,12 @@ <h2>텍스쳐</h2>
4242
buffer와 비슷하게, 이 오브젝트는 [page:Texture.dispose]() 호출로만 삭제가 가능합니다.
4343
</p>
4444

45+
<p>
46+
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]()
47+
on 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
48+
unusable and the engine does not know whether the image bitmap is used elsewhere or not.
49+
</p>
50+
4551
<h2>렌더링 대상</h2>
4652

4753
<p>
@@ -112,4 +118,4 @@ <h2>dispose() 사용법 예제</h2>
112118

113119
</body>
114120

115-
</html>
121+
</html>

docs/manual/zh/introduction/How-to-dispose-of-objects.html

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,12 @@ <h2>纹理</h2>
4444
和buffer相似,该对象只能通过调用[page:Texture.dispose]()来删除。
4545
</p>
4646

47+
<p>
48+
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]()
49+
on 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
50+
unusable and the engine does not know whether the image bitmap is used elsewhere or not.
51+
</p>
52+
4753
<h2>渲染目标</h2>
4854

4955
<p>

0 commit comments

Comments
 (0)