Resolve physical font names from logical names

Author: pityka

.gitignore

@@ -13,3 +13,4 @@ website/static/api
 _gen/
 .hugo_build.lock
 .claude/settings.local.json
+.vscode/mcp.json

awt/src/main/scala/org/nspl/awtutil.scala

@@ -120,7 +120,8 @@ trait JavaAWTUtil {
       build: Build[K],
       os: java.io.OutputStream,
       width: Int = 500,
-      format: String = "pdf"
+      format: String = "pdf",
+      textAsShapes : Boolean = true
   )(implicit
       er: Renderer[K, JavaRC]
   ) = {
@@ -135,7 +136,7 @@ trait JavaAWTUtil {
     val aspect = elem.bounds.h / elem.bounds.w
     val height = (width * aspect).toInt
     val g2d = new VectorGraphics2D()
-    val renderingContext = new JavaRC(g2d, doRender = true, textAsShapes = true)
+    val renderingContext = new JavaRC(g2d, doRender = true, textAsShapes = textAsShapes)
 
     val processor =
       format match {
@@ -156,13 +157,14 @@ trait JavaAWTUtil {
       elem: Build[K],
       os: java.io.OutputStream,
       width: Int = 1000,
-      mimeType: String = "image/png"
+      mimeType: String = "image/png",
+      textAsShapes : Boolean = true
   )(implicit
       er: Renderer[K, JavaRC]
   ) = {
     mimeType.split("/").last match {
       case "pdf" | "svg" | "eps" | "svg+xml" =>
-        writeVector(elem, os, width, mimeType.split("/").last)
+        writeVector(elem, os, width, mimeType.split("/").last, textAsShapes)
       case _ => writeBitmap(elem, os, width, mimeType)
     }
   }
@@ -308,13 +310,14 @@ trait JavaAWTUtil {
       f: File,
       elem: Build[K],
       width: Int,
-      mimeType: String
+      mimeType: String,
+      textAsShapes : Boolean
   )(implicit
       er: Renderer[K, JavaRC]
   ): File = {
     val os = new BufferedOutputStream(new FileOutputStream(f))
     try {
-      write(elem, os, width, mimeType)
+      write(elem, os, width, mimeType, textAsShapes)
     } finally {
       os.close
     }
@@ -324,39 +327,43 @@ trait JavaAWTUtil {
   def svgToFile[K <: Renderable[K]](
       f: File,
       elem: Build[K],
-      width: Int
+      width: Int,
+      textAsShapes : Boolean
   )(implicit
       er: Renderer[K, JavaRC]
   ): File = {
-    renderToFile(f, elem, width, "svg")
+    renderToFile(f, elem, width, "svg", textAsShapes : Boolean)
     f
   }
   def pdfToFile[K <: Renderable[K]](
       f: File,
       elem: Build[K],
-      width: Int
+      width: Int,
+      textAsShapes : Boolean
   )(implicit
       er: Renderer[K, JavaRC]
   ): File = {
-    renderToFile(f, elem, width, "application/pdf")
+    renderToFile(f, elem, width, "application/pdf", textAsShapes)
     f
   }
 
   def pdfToFile[K <: Renderable[K]](
       f: File,
-      elem: Build[K]
+      elem: Build[K],
+      textAsShapes : Boolean
   )(implicit
       er: Renderer[K, JavaRC]
-  ): File = pdfToFile(f, elem, 500)
+  ): File = pdfToFile(f, elem, 500, textAsShapes)
 
   def pdfToFile[K <: Renderable[K]](
       elem: Build[K],
-      width: Int = 500
+      width: Int = 500,
+      textAsShapes : Boolean = true
   )(implicit
       er: Renderer[K, JavaRC]
   ) = {
     val f = java.io.File.createTempFile("nspl", ".pdf")
-    renderToFile(f, elem, width, "application/pdf")
+    renderToFile(f, elem, width, "application/pdf", textAsShapes)
     f
   }
 
@@ -367,7 +374,7 @@ trait JavaAWTUtil {
   )(implicit
       er: Renderer[K, JavaRC]
   ): File = {
-    renderToFile(f, elem, width, "image/png")
+    renderToFile(f, elem, width, "image/png", false)
     f
   }
 

saddle/src/test/scala/plots/plots.test.scala

@@ -455,7 +455,7 @@ class SaddlePlotSpec extends munit.FunSuite {
 
         // show(gallery)
         println(pngToFile(gallery.build, width = 10000))
-        println(pdfToFile(gallery.build))
+        println(pdfToFile(gallery.build, textAsShapes = false))
         println(pdfToFile(text))
         while (false) {
           gallery.build

shared-jvm/src/main/scala/org/nspl/font.scala

@@ -2,8 +2,48 @@ package org.nspl
 import java.awt.{Font => JFont}
 
 private[nspl] object JavaFontConversion {
-  def font2font(myFont: Font): JFont =  new JFont(myFont.name, JFont.PLAIN, myFont.size)
-  
+
+  /** Logical font names that Java maps to composite fonts.
+    * VectorGraphics2D hangs on macOS when trying to resolve these
+    * to physical fonts during PDF/SVG/EPS generation.
+    */
+  private val logicalFontNames = Set(
+    "sansserif", "serif", "monospaced", "dialog", "dialoginput"
+  )
+
+  /** Cache of logical font name -> resolved physical font family name */
+  private lazy val physicalFontMap: Map[String, String] = {
+    val ge = java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment()
+    val available = ge.getAvailableFontFamilyNames()
+    logicalFontNames.flatMap { logical =>
+      val jf = new JFont(logical, JFont.PLAIN, 12)
+      val family = jf.getFamily()
+      if (!logicalFontNames.contains(family.toLowerCase)) {
+        Some(logical -> family)
+      } else {
+        val fallback = logical match {
+          case "sansserif" | "dialog" | "dialoginput" =>
+            available.find(f => f == "Helvetica" || f == "Arial" || f == "Liberation Sans")
+          case "serif" =>
+            available.find(f => f == "Times" || f == "Times New Roman" || f == "Liberation Serif")
+          case "monospaced" =>
+            available.find(f => f == "Courier" || f == "Courier New" || f == "Liberation Mono")
+          case _ => None
+        }
+        fallback.map(logical -> _)
+      }
+    }.toMap
+  }
+
+  private def resolvePhysicalName(name: String): String = {
+    val lower = name.toLowerCase
+    if (logicalFontNames.contains(lower))
+      physicalFontMap.getOrElse(lower, name)
+    else name
+  }
+
+  def font2font(myFont: Font): JFont =
+    new JFont(resolvePhysicalName(myFont.name), JFont.PLAIN, myFont.size)
 
 }