Skip to content

Commit eeeffc8

Browse files
authored
Docs: Clarify reuse of disposed objects. (mrdoob#26498)
1 parent 33487fb commit eeeffc8

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

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

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,8 +99,10 @@ <h3>What happens when you call `dispose()` on a texture but the image is not loa
9999
<h3>What happens when I call `dispose()` and then use the respective object at a later point?</h3>
100100

101101
<p>
102-
The deleted internal resources will be created again by the engine. So no runtime error will occur but you might notice a negative performance impact for the current frame,
103-
especially when shader programs have to be compiled.
102+
That depends. For geometries, materials, textures, render targets and post processing passes the deleted internal resources can be created again by the engine.
103+
So no runtime error will occur but you might notice a negative performance impact for the current frame, especially when shader programs have to be compiled.
104+
105+
Controls and renderers are an exception. Instances of these classes can not be used after `dispose()` has been called. You have to create new instances in this case.
104106
</p>
105107

106108
<h3>How should I manage *three.js* objects in my app? When do I know how to dispose things?</h3>

0 commit comments

Comments
 (0)