Skip to content

Commit

Permalink
Docs: Clarify reuse of disposed objects.
Browse files Browse the repository at this point in the history
  • Loading branch information
Mugen87 committed Jul 26, 2023
1 parent 78acb52 commit 0a758e7
Showing 1 changed file with 4 additions and 2 deletions.
6 changes: 4 additions & 2 deletions docs/manual/en/introduction/How-to-dispose-of-objects.html
Original file line number Diff line number Diff line change
Expand Up @@ -99,8 +99,10 @@ <h3>What happens when you call `dispose()` on a texture but the image is not loa
<h3>What happens when I call `dispose()` and then use the respective object at a later point?</h3>

<p>
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,
especially when shader programs have to be compiled.
That depends. For geometries, materials, textures, render targets and post processing passes the deleted internal resources can be created again by the engine.
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.

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.
</p>

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

0 comments on commit 0a758e7

Please sign in to comment.