Merge pull request #76308 from Calinou/doc-custom-mouse-cursor

Document custom mouse cursors larger than 128×128 potentially having issues
This commit is contained in:
Rémi Verschelde 2023-04-21 15:51:13 +02:00
commit c6f5e78c89
No known key found for this signature in database
GPG key ID: C3336907360768E1

View file

@ -300,7 +300,7 @@
<param index="2" name="hotspot" type="Vector2" default="Vector2(0, 0)" />
<description>
Sets a custom mouse cursor image, which is only visible inside the game window. The hotspot can also be specified. Passing [code]null[/code] to the image parameter resets to the system cursor. See [enum CursorShape] for the list of shapes.
[param image]'s size must be lower than 256×256.
[param image]'s size must be lower than or equal to 256×256. To avoid rendering issues, sizes lower than or equal to 128×128 are recommended.
[param hotspot] must be within [param image]'s size.
[b]Note:[/b] [AnimatedTexture]s aren't supported as custom mouse cursors. If using an [AnimatedTexture], only the first frame will be displayed.
[b]Note:[/b] Only images imported with the [b]Lossless[/b], [b]Lossy[/b] or [b]Uncompressed[/b] compression modes are supported. The [b]Video RAM[/b] compression mode can't be used for custom cursors.