Update docs for custom shapes and related features

[GregStanton]

Issues

Addresses #6560
Addresses #6766

Pull requests

• setAttribute() function for defining custom shader attributes #7276
• Overhaul custom shapes for p5.js 2.0 #7373
• Implement splineProperty #7471
• Add splineProperties #7528
• Fix endShape() to Properly Close Paths and Prevent Shape Merging #7583
• Remove old overloads for bezierVertex() and quadraticVertex() #7600
• Fix endShape() to Properly Close Paths and Prevent Shape Merging #7601
• Minor 2.0 shape changes #7656
• Rename curvePoint/curveTangent to splinePoint/splineTangent #7703

Changes

This PR updates docs for user-facing changes to custom shapes and related features.

Custom shapes:

• Move vertex.js into custom_shapes.js
• Update vertex() docs
  • New signature x, y, u, v
  • There's an example of this in ref page for texture(), but not yet documented on ref page for vertex()
  • relevant PR: #7373
• Document bezierOrder()
  • Might update examples in quadraticVertex() and move them here
  • relevant PR: #7373
  • relevant issue: #6766
• Update bezierVertex() docs
  • located in custom_shapes.js (after removal of vertex.js)
  • new x, y, u, v and x, y, z, u, v signatures
  • maybe just show default usage, link to docs for bezierOrder()?
  • relevant PRs: #7373, #7600
  • relevant Issues: #6560, #6766
• Remove quadraticVertex() docs (if needed)
  - relevant PRs: #7373, 7600
  - relevant Issue: #6766
• Document splineVertex()
  • start from curveVertex() docs
  • new x, y, u, v and x, y, z, u, v signatures.
  • spline ends are now interpolated by default (show non-default behavior in splineProperty() and link to it?)
  • splines now close smoothly
  • relevant issue: #7373
  • relevant issues: #6560, [p5.js 2.0 RFC Proposal]: New API for vertex functions #6766
• Remove curveVertex() (it's already supported by the 1.x compatibility add-on for shapes)
  • relevant PR: #7373
  • relevant Issue: #6766
• Review vertexProperty() docs
  • located in custom_shapes.js (after removal of vertex.js)
  • relevant PR: #7276
• Document splineProperty()
  • might start from existing docs for vertexProperty(), curveTightness()
  • relevant PR: #7471
  • relevant Issue #6766
• Document splineProperties()
  • relevant PR: #7528
  • relevant Issue: #6766
• Update beginShape() docs
  • remove reference to quadraticVertex()
  • PATH is the new name for the default shape kind
  • composite paths can now be made from mixed vertex types
  • relevant PR: #7373
• Update beginContour() docs
  • contours are now general subshapes, essentially
  • they can now be created with a kind parameter, just like shapes.
  • PATH is the default kind.
  • composite shapes can be made from mixed contour types
  • Mixing contour kinds might not work in WebGL yet
  • relevant PR: #7373
• Document new endShape/Contour(CLOSE) behavior for splines
  • splines now close smoothly (may just want to mention this and link to splineVertex()?)
  • relevant PRs: #7373, #7583, #7601
  • relevant issues: #6560, #6766
• Update endContour(CLOSE) docs
  • see custom_shapes.js
  • Contours are now open by default (default is OPEN)
  • relevant PRs: #7373
  • relevant issues: #6560, #6766
    Curves:
• Update curve() docs to reflect name change to spline() (if needed)
  • relevant PR: #7656
• Remove curveTightness() docs if needed
  • relevant PR: Implement splineProperty #7471
• Update curvePoint() docs to reflect name change to splinePoint() (if needed)
  • relevant PR: #7703
• Update curveTangent() docs to reflect name change to splineTangent() (if needed)
  • relevant PR: #7703
• Update curveDetail() docs, possibly incorporating adapted examples from bezierDetail() docs
  • Replaces count with density, so that it works more generally (including for custom shapes, I think?)
  • See visitors for Béziers and splines in custom_shapes.js
  • Note that the user-facing function is currently located in 3d_primitives.js (it should be moved to curves.js)
  • relevant PR: #7373
• Remove bezierDetail() docs (if needed)
  • relevant PR: #7656

3D:

• remove beginGeometry()/endGeometry() docs (if needed)
  • Removed from 3d_primitives.js, in favor of buildGeometry().
  • Summary from the PR: "Removing beginGeometry()/endGeometry() eliminates an inconsistency with beginShape()/endShape(), reduces the size of the user-facing API, and prevents confusion (endGeometry() is effectively used as a constructor, in contrast with how objects are usually created in p5)."
  • relevant PR: #7373

Notes

• Except where noted above, reference dependencies¹ can be updated in a separate PR.
• A simple change to behavior of endShape(CLOSE) for Bézier curves was discussed; decided we can implement this for 2.0

Screenshots

[Reminder] Might be helpful to provide screenshots of top-level listings from main reference page.

PR Checklist

• npm run lint passes
• Inline reference is included / updated
• Unit tests are included / updated

Footnotes

1. Here, reference dependency refers to a reference page that depends on one of the new or changed features mentioned under the Changes section, either because it mentions it or because it uses it in a code example. ↩