MPLCAIRO_SCRIPT_SURFACE.

Author: anntzer

README.rst

@@ -390,10 +390,12 @@ The API is similar:
 ``cairo-script`` output
 -----------------------
 
-Setting the ``MPLCAIRO_DEBUG`` environment variable to a non-empty value allows
-one to save figures (with ``savefig``) in the ``.cairoscript`` format, which is
-a "native script that matches the cairo drawing model".  This may be helpful
-for troubleshooting purposes.
+Setting the ``MPLCAIRO_SCRIPT_SURFACE`` environment variable to ``vector``
+or ``raster`` allows one to save figures (with ``savefig``) in the
+``.cairoscript`` format, which is a "native script that matches the cairo
+drawing model".  The value of the variable determines the rendering path used
+(e.g., whether marker stamping is used at all).  This may be helpful for
+troubleshooting purposes.
 
 Note that this may crash the process after the file is written, due to `cairo
 bug #104410 <cairo-104410_>`_.

lib/mplcairo/base.py

@@ -255,7 +255,7 @@ def _print_method(
         _print_method, GraphicsContextRendererCairo._for_svg_output)
     print_svgz = partialmethod(
         _print_method, GraphicsContextRendererCairo._for_svgz_output)
-    if os.environ.get("MPLCAIRO_DEBUG"):
+    if os.environ.get("MPLCAIRO_SCRIPT_SURFACE") in ["raster", "vector"]:
         print_cairoscript = partialmethod(
             _print_method, GraphicsContextRendererCairo._for_script_output)
 

src/_util.cpp

@@ -115,8 +115,16 @@ bool has_vector_surface(cairo_t* cr)
     case CAIRO_SURFACE_TYPE_PS:
     case CAIRO_SURFACE_TYPE_SVG:
     case CAIRO_SURFACE_TYPE_RECORDING:
-    case CAIRO_SURFACE_TYPE_SCRIPT:
       return true;
+    case CAIRO_SURFACE_TYPE_SCRIPT:
+      if (auto script_surface =
+            std::string{std::getenv("MPLCAIRO_SCRIPT_SURFACE")};
+          script_surface == "raster") {
+        return false;
+      } else if (script_surface == "vector") {
+        return true;
+      }
+      [[fallthrough]];
     default:
       throw
         std::invalid_argument(