This is an overloaded function with a variety of argument lists which NEED DOCUMENTATION.

When called from Fortran, this overloaded routine has the same effect as when invoked from C. See examples/fortran/x??f.f90 for various ways to call plshade from Fortran.