Modularize the Color Picker via properties and new picker mode.

[cridenour]

As noted in #67663, the new color picker removed some flexibility. The new options are great, but limited how we could use the control in game.

Inspired by this, I took a stab at giving full flexibility in the color picker. Properties are exposed to hide all elements outside the picker itself, which can also be disabled with a new Picker Mode.

The existing presets_visible property was no longer respected (launching with it enabled still hid the presets until Swatches was clicked) so I used that to hide the Swatches and Recent Colors buttons.

Similarly, after the new UX presets_enabled worked correctly, but was confusing as internally both recent colors and swatches are considered presets. I changed the name of this property to can_add_swatches.

The picker itself is a fantastic control and the hope is to make it helpful in more scenarios with additional customization options.

Bugsquad edit:

• Fixes [4.0] New ColorPicker UX lacks customization options #67663

[RedMser]

Seems like the XML documentation is missing the SHAPE_NONE constant.

[cridenour]

Seems like the XML documentation is missing the SHAPE_NONE constant.

Thanks for the catch. Updated.

[cridenour]

New push to fix property ordering (actually using doctool this time)

[KoBeWi]

I tested this and it's overall good. But I have a few notes:

• all something_visible properties should be inside a group, e.g. "Customization"
• modes_visible should be color_modes_visible
• I wonder if can_add_swatches is even necessary. I know it was there, but it just disables a button. Kind of pointless if you can just disable presets altogether. Up to discussion I guess
• it would be nice if the properties were ordered in the order of elements they represent. Right now it seems random

[cridenour]

Updated per @KoBeWi's review:

• Added a Customization group for the properties.
• Re-ordered properties to match the visually flow of the control
• Renamed modes_visible to color_modes_visible
• Updated documentation wording to suggested

Outstanding:

• Resolution on open comments
• Discussion about can_add_swatches and the utility it provides.

[KoBeWi]

Left some minor comments, but otherwise looks ok.

As for the can_add_swatches property, its removal can still be discussed and done in another PR. But with the changes here, it's possible to make a ColorPicker that contains only swatches, so disabling the button might make sense. But maybe it would be better if the property was hiding it, idk

[cridenour]

Thanks @KoBeWi! All outstanding comments have been resolved.

[akien-mga]

Thanks! And congrats for your first merged Godot contribution 🎉