Line2d.points.resize(int) or slice() not working

[Serimert90]

Tested versions

-Reproducible in Godot 4.3 and Godot 4.4

System information

Godot v4.4.stable - Windows 10 (build 19045) - Multi-window, 1 monitor - Vulkan (Mobile) - dedicated NVIDIA GeForce RTX 3080 Ti (NVIDIA; 32.0.15.6094) - AMD Ryzen 9 5900X 12-Core Processor (24 threads)

Issue description

Check the reproduction project. Simply add line2d object to your scene. Add points programmatically or from editor.
Try to remove points by Line2d.points.resize and see it does not work. Points array does not change.

Steps to reproduce

Simply add line2d object to your scene. Add points programmatically or from editor.
Try to remove points by Line2d.points.resize and see it does not work.

Minimal reproduction project (MRP)

line2d_bug.zip

[AThousandShips]

This is documented, please see the documentation:

The returned array is copied and any changes to it will not update the original property value. See PackedVector2Array for more details.

This is a known limitation and is documented

[Serimert90]

This is documented, please see the documentation:

The returned array is copied and any changes to it will not update the original property value. See PackedVector2Array for more details.

This is a known limitation and is documented

How to get resized array then? resize returns int not the array.

[AThousandShips]

You replace it, just do:

var tmp := my_line.points
...
my_line.points = tmp

[Mickeon]

I guess you marked it as a documentation issue anyway, because one thing that could be done is document how to change the array. The description is correct but misleading, in that it makes you think it's entirely read-only.

"any changes to [the array] will not update the original"

To whom may interest, this note may be present elsewhere so update accordingly.

[AThousandShips]

I guess you marked it as a documentation issue anyway

Yes? Obviously as this is a discussion over how to improve the documentation if needed 🙃

Also the documentation specifies how to do it if you follow the link to the type, the note wasn't added to each instance because of verbosity

The returned packed array of these are a copies, and changing it will not affect the original value. To update a built-in property you need to modify the returned array, and then assign it to the property again.