Deprecate shapes in bevy_render::mesh::shape

[Jondolf]

Objective

#11431 and #11688 implemented meshing support for Bevy's new geometric primitives. The next step is to deprecate the shapes in bevy_render::mesh::shape and to later remove them completely for 0.14.

Solution

Deprecate the shapes and reduce code duplication by utilizing the primitive meshing API for the old shapes where possible.

Note that some shapes have behavior that can't be exactly reproduced with the new primitives yet:

• Box is more of an AABB with min/max extents
• Plane supports a subdivision count
• Quad has a flipped property

These types have not been changed to utilize the new primitives yet.

---

Changelog

• Deprecated all shapes in bevy_render::mesh::shape
• Changed all examples to use new primitives for meshing

Migration Guide

Bevy has previously used rendering-specific types like UVSphere and Quad for primitive mesh shapes. These have now been deprecated to use the geometric primitives newly introduced in version 0.13.

Some examples:

let before = meshes.add(shape::Box::new(5.0, 0.15, 5.0));
let after = meshes.add(Cuboid::new(5.0, 0.15, 5.0));

let before = meshes.add(shape::Quad::default());
let after = meshes.add(Rectangle::default());

let before = meshes.add(shape::Plane::from_size(5.0));
// The surface normal can now also be specified when using `new`
let after = meshes.add(Plane3d::default().mesh().size(5.0, 5.0));

let before = meshes.add(
    Mesh::try_from(shape::Icosphere {
        radius: 0.5,
        subdivisions: 5,
    })
    .unwrap(),
);
let after = meshes.add(Sphere::new(0.5).mesh().ico(5).unwrap());

[NthTensor]

Hooray!

[alice-i-cecile]

Nice deprecation notices :)

[NthTensor]

Looks great. This must have been pretty tedious. Really appreceate how quickly you got this in.

[NthTensor]

Document the purpose of this test please. I'm not sure I could fix this if I broke it.

[Jondolf]

It's not my test, it was added by #11017. Personally, I find it to be a bit redundant and would remove it, but it was on the old RegularPolygon type so I kept it for now.

[NthTensor]

"Document RegularPolygon by writing a test" and then proceeds to write no documentation for the test.

Fair enough.