summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorK. S. Ernest (iFire) Lee <fire@users.noreply.github.com>2021-08-25 11:17:23 -0700
committerGitHub <noreply@github.com>2021-08-25 11:17:23 -0700
commitb3ada9cb1a3060c94c744f6a59b7ab6ee3b24818 (patch)
tree51169613038ac820071a4c5d38511e9c3c686c4a
parentee4a8e6a85db8cf2e1a1d533c6453dd7df3008f3 (diff)
parent30a88f464ba6e0dc08b7cc84029df0e50e1a75b6 (diff)
downloadredot-engine-b3ada9cb1a3060c94c744f6a59b7ab6ee3b24818.tar.gz
Merge pull request #51969 from Calinou/doc-image-generate-mipmaps-no-threading
Document `Image.generate_mipmaps()` always running on the main thread
-rw-r--r--doc/classes/Image.xml1
1 files changed, 1 insertions, 0 deletions
diff --git a/doc/classes/Image.xml b/doc/classes/Image.xml
index 34c5fb582e..5d79e22c49 100644
--- a/doc/classes/Image.xml
+++ b/doc/classes/Image.xml
@@ -180,6 +180,7 @@
<argument index="0" name="renormalize" type="bool" default="false" />
<description>
Generates mipmaps for the image. Mipmaps are precalculated lower-resolution copies of the image that are automatically used if the image needs to be scaled down when rendered. They help improve image quality and performance when rendering. This method returns an error if the image is compressed, in a custom format, or if the image's width/height is [code]0[/code].
+ [b]Note:[/b] Mipmap generation is done on the CPU, is single-threaded and is [i]always[/i] done on the main thread. This means generating mipmaps will result in noticeable stuttering during gameplay, even if [method generate_mipmaps] is called from a [Thread].
</description>
</method>
<method name="get_data" qualifiers="const">