asgardius/virtualx-engine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

[3.x] Document some Image methods can unlock it (making set_pixel fail)

Browse source
This commit is contained in:
kleonc 2024-02-04 02:30:43 +01:00
parent e9949a6db7
commit d0f9fe2ac5
1 changed files with 14 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
doc/classes/Image.xml
View file

@ -385,6 +385,13 @@
img.unlock()
img.set_pixel(x, y, color) # Does not have an effect
[/codeblock]
[b]Note:[/b] Some image methods can leave the image unlocked, making subsequent [method set_pixel] calls fail unless the image is locked again. Methods potentially unlocking the image: [method blend_rect], [method blend_rect_mask], [method blit_rect_mask], [method convert], [method fill], [method fill_rect], [method get_used_rect], and [method rgbe_to_srgb].
[codeblock]
img.lock()
img.set_pixel(x, y, color) # Works
img.fill(color) # Unlocks the image
img.set_pixel(x, y, color) # Does not have an effect
[/codeblock]
</description>
</method>
<method name="set_pixelv">
@ -401,6 +408,13 @@
img.unlock()
img.set_pixelv(Vector2(x, y), color) # Does not have an effect
[/codeblock]
[b]Note:[/b] Some image methods can leave the image unlocked, making subsequent [method set_pixelv] calls fail unless the image is locked again. Methods potentially unlocking the image: [method blend_rect], [method blend_rect_mask], [method blit_rect_mask], [method convert], [method fill], [method fill_rect], [method get_used_rect], and [method rgbe_to_srgb].
[codeblock]
img.lock()
img.set_pixelv(Vector2(x, y), color) # Works
img.fill(dcolor) # Unlocks the image
img.set_pixelv(Vector2(x, y), color) # Does not have an effect
[/codeblock]
</description>
</method>
<method name="shrink_x2">