code: @Override
      public void setClip(Shape shape) {
          // null is handled fine here...
          this.clip = this.transform.createTransformedShape(shape);
          this.clipRef = null;
      }
docs: Sets the user clipping region.
  
  @param shape  the new user clipping region ({@code null} permitted).
  
  @see #getClip()