kicad-sch-api 0.3.1__py3-none-any.whl → 0.3.4__py3-none-any.whl

kicad_sch_api/core/schematic.py

@@ -1138,6 +1138,55 @@ class Schematic:
         logger.debug(f"Added text box: '{text}' at {position} size {size}")
         return text_box.uuid
 
+    def add_image(
+        self,
+        position: Union[Point, Tuple[float, float]],
+        data: str,
+        scale: float = 1.0,
+        uuid: Optional[str] = None,
+    ) -> str:
+        """
+        Add an image element.
+
+        Args:
+            position: Image position
+            data: Base64-encoded image data
+            scale: Image scale factor (default 1.0)
+            uuid: Optional UUID (auto-generated if None)
+
+        Returns:
+            UUID of created image element
+        """
+        if isinstance(position, tuple):
+            position = Point(position[0], position[1])
+
+        from .types import Image
+
+        import uuid as uuid_module
+
+        image = Image(
+            uuid=uuid if uuid else str(uuid_module.uuid4()),
+            position=position,
+            data=data,
+            scale=scale,
+        )
+
+        if "images" not in self._data:
+            self._data["images"] = []
+
+        self._data["images"].append(
+            {
+                "uuid": image.uuid,
+                "position": {"x": image.position.x, "y": image.position.y},
+                "data": image.data,
+                "scale": image.scale,
+            }
+        )
+        self._modified = True
+
+        logger.debug(f"Added image at {position} with {len(data)} bytes of data")
+        return image.uuid
+
     def add_rectangle(
         self,
         start: Union[Point, Tuple[float, float]],
@@ -1592,9 +1641,7 @@ class Schematic:
                     break
 
         # Fix string/symbol conversion issues in pin definitions
-        print(f"🔧 DEBUG: Before fix - checking for pin definitions...")
         self._fix_symbol_strings_recursively(modified_data)
-        print(f"🔧 DEBUG: After fix - symbol strings fixed")
 
         return modified_data
 
@@ -1607,15 +1654,10 @@ class Schematic:
                 if isinstance(item, list):
                     # Check for pin definitions that need fixing
                     if len(item) >= 3 and item[0] == sexpdata.Symbol("pin"):
-                        print(
-                            f"🔧 DEBUG: Found pin definition: {item[:3]} - types: {[type(x) for x in item[:3]]}"
-                        )
                         # Fix pin type and shape - ensure they are symbols not strings
                         if isinstance(item[1], str):
-                            print(f"🔧 DEBUG: Converting pin type '{item[1]}' to symbol")
                             item[1] = sexpdata.Symbol(item[1])  # pin type: "passive" -> passive
                         if len(item) >= 3 and isinstance(item[2], str):
-                            print(f"🔧 DEBUG: Converting pin shape '{item[2]}' to symbol")
                             item[2] = sexpdata.Symbol(item[2])  # pin shape: "line" -> line
 
                     # Recursively process nested lists

kicad_sch_api/core/types.py

@@ -372,6 +372,20 @@ class SchematicRectangle:
         )
 
 
+@dataclass
+class Image:
+    """Image element in schematic."""
+
+    uuid: str
+    position: Point
+    data: str  # Base64-encoded image data
+    scale: float = 1.0
+
+    def __post_init__(self):
+        if not self.uuid:
+            self.uuid = str(uuid4())
+
+
 @dataclass
 class Net:
     """Electrical net connecting components."""

kicad_sch_api/geometry/__init__.py

@@ -0,0 +1,26 @@
+"""
+Geometry module for KiCad schematic symbol bounding box calculations.
+
+This module provides accurate bounding box calculations for KiCad symbols,
+including font metrics and symbol geometry analysis.
+
+Migrated from circuit-synth to kicad-sch-api for better architectural separation.
+"""
+
+from .font_metrics import (
+    DEFAULT_PIN_LENGTH,
+    DEFAULT_PIN_NAME_OFFSET,
+    DEFAULT_PIN_NUMBER_SIZE,
+    DEFAULT_PIN_TEXT_WIDTH_RATIO,
+    DEFAULT_TEXT_HEIGHT,
+)
+from .symbol_bbox import SymbolBoundingBoxCalculator
+
+__all__ = [
+    "SymbolBoundingBoxCalculator",
+    "DEFAULT_TEXT_HEIGHT",
+    "DEFAULT_PIN_LENGTH",
+    "DEFAULT_PIN_NAME_OFFSET",
+    "DEFAULT_PIN_NUMBER_SIZE",
+    "DEFAULT_PIN_TEXT_WIDTH_RATIO",
+]

kicad_sch_api/geometry/font_metrics.py

@@ -0,0 +1,20 @@
+"""
+Font metrics and text rendering constants for KiCad schematic text.
+
+These constants are used for accurate text bounding box calculations
+and symbol spacing in schematic layouts.
+"""
+
+# KiCad default text size in mm
+# Increased to better match actual KiCad rendering
+DEFAULT_TEXT_HEIGHT = 2.54  # 100 mils (doubled from 50 mils)
+
+# Default pin dimensions
+DEFAULT_PIN_LENGTH = 2.54  # 100 mils
+DEFAULT_PIN_NAME_OFFSET = 0.508  # 20 mils - offset from pin endpoint to label text
+DEFAULT_PIN_NUMBER_SIZE = 1.27  # 50 mils
+
+# Text width ratio for proportional font rendering
+# KiCad uses proportional fonts where average character width is ~0.65x height
+# This prevents label text from extending beyond calculated bounding boxes
+DEFAULT_PIN_TEXT_WIDTH_RATIO = 0.65  # Width to height ratio for pin text (proportional font average)