Clipping Polygon Holes

[mzschwartz5]

Description

Clipping polygons with holes (regular and inverse clipping):

This PR adds a "holes" option to the ClippingPolygons API. Users specify the positions of the clipping polygon outline, as a list of Cartesian3, and a holes as a list of lists of Cartesian3 (where each sublist represents the outline of one hole). Because we now use BufferPolygonCollection as the backing data structure for clipping polygons, alongside the vector shader framework, we get support for holes nearly for free.

Issue number and link

#12939

Testing plan

This sandcastle demonstrates holes -- you can try it out with terrain or 3D tiles, and regular clipping or inverse.

Author checklist

• I have submitted a Contributor License Agreement
• I have added my name to CONTRIBUTORS.md
• I have updated CHANGES.md with a short summary of my change
• I have added or updated unit tests to ensure consistent code coverage
• I have updated the inline documentation, and included code examples where relevant
• I have performed a self-review of my code

AI acknowledgment

• I used AI to generate content in this PR
• If yes, I have reviewed the AI-generated content before submitting

If yes, I used the following Tools(s) and/or Service(s):

If yes, I used the following Model(s):

PR Dependency Tree

• PR Clipping polygon buffer migration #13623
  • PR Vector Textures for Polygon Clipping #13635
    • PR Clipping texture plumbing #13636
      • PR Shader rework for terrain polygon clipping #13637
        • PR Remove SDF polygon clipping from Globe #13638
          • PR Model clipping rework foundation #13641
            • PR Model polygon clipping shader impl #13647
              • PR Remove polygon clipping sdf path #13654
                • PR Clipping Polygon Holes #13660 👈
                  • PR ClippingPolygon immutable positions (performance) #13665

This tree was auto-generated by Charcoal

[github-actions]

Thank you for the pull request, @mzschwartz5!

✅ We can confirm we have a CLA on file for you.