Fix: preload cairo DLL on Windows for 2D board view rendering (#160)

cairocffi uses cffi's ffi.dlopen('cairo-2') which requires the DLL to
be on the system PATH. On Windows, prepend KiCad's bin directory to
PATH early in kicad_interface.py (before any cairocffi import) so
cairo-2.dll can be found. Checks PYTHONPATH, Python executable dir,
and default KiCad 9/8 install paths.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Gavin Colonese
2026-05-18 13:39:30 -04:00
committed by GitHub
parent 319a65bd0b
commit 07483623be
2 changed files with 109 additions and 0 deletions

View File

@@ -18,6 +18,21 @@ from datetime import datetime
from pathlib import Path
from typing import Any, Dict, List, Optional, Tuple
# Fix cairo DLL loading on Windows before any cairocffi import.
# cairocffi uses cffi's ffi.dlopen('cairo-2') which needs the DLL on PATH.
if sys.platform == "win32":
for _bin_dir in [
os.environ.get("PYTHONPATH", ""),
os.path.dirname(sys.executable),
r"C:\Program Files\KiCad\9.0\bin",
r"C:\Program Files\KiCad\8.0\bin",
]:
if _bin_dir and os.path.isfile(os.path.join(_bin_dir, "cairo-2.dll")):
_current_path = os.environ.get("PATH", "")
if _bin_dir not in _current_path:
os.environ["PATH"] = _bin_dir + os.pathsep + _current_path
break
import sexpdata
from annotations import AnnotationLoader
from commands.wire_manager import WireManager