summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorHugo Locurcio <hugo.locurcio@hugo.pro>2021-08-22 02:21:06 +0200
committerHugo Locurcio <hugo.locurcio@hugo.pro>2021-08-22 02:22:04 +0200
commit30a88f464ba6e0dc08b7cc84029df0e50e1a75b6 (patch)
treede56127c942f614d2735ad6535edf8db4e616d8a /doc
parentba96f31fad96b42d10a54fe968cee484b03d1bb5 (diff)
Document `Image.generate_mipmaps()` always running on the main thread
Diffstat (limited to 'doc')
-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">