Figure.grdview: Improve parameters plane/facade_fill/facade_pen to set the plane and facade

[seisman]

This PR splits the -N option into two parameters, plane for setting the z-level and facade_fill for setting the fill for facade.

Preview: https://pygmt-dev--4235.org.readthedocs.build/en/4235/api/generated/pygmt.Figure.grdview.html#pygmt.Figure.grdview

Related to #4208

[github-actions]

Summary of changed images

This is an auto-generated report of images that have changed on the DVC remote

Status	Path
added	pygmt/tests/baseline/test_grdview_facadepen_default_plane.png

Image diff(s)

Details

Added images

• test_grdview_facadepen_default_plane.png

Modified images

Path	Old	New

Report last updated at commit 178dd65

[Copilot]

Pull request overview

This PR improves the Figure.grdview method by refactoring how plane and facade parameters are handled. It migrates facadepen to the new alias system and splits the GMT -N option into two separate parameters (plane and facadefill) for better API clarity.

Key changes:

• Split the plane parameter into two distinct parameters: plane for z-level specification and facadefill for facade fill color
• Migrated facadepen from the old @use_alias decorator to the new AliasSystem
• Added automatic plane enabling when facadefill or facadepen is specified

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
pygmt/src/grdview.py	Updated function signature with new parameters, migrated to AliasSystem for -N and -Wf options, added auto-enable logic for plane
pygmt/tests/test_grdview.py	Updated existing test to use new API, added new test for facadepen with default plane
pygmt/tests/baseline/test_grdview_facadepen_default_plane.png.dvc	Added baseline image for new test case
examples/tutorials/advanced/draping_on_3d_surface.py	Updated examples to use new facadefill parameter instead of plane="+g..." syntax
examples/tutorials/advanced/3d_perspective_image.py	Updated examples and comments to use new facadefill parameter

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[seisman]

Changes in this PR will affect our Figure 3, so ping @yvonnefroehlich for a review.