figquilt 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

figquilt/compose_pdf.py

@@ -87,14 +87,27 @@ class PDFComposer:
                 src_page = src_doc[0]
                 src_rect = src_page.rect
 
-            aspect = src_rect.height / src_rect.width
+            src_aspect = src_rect.height / src_rect.width
 
+            # Calculate cell height
             if panel.height is not None:
                 h = to_pt(panel.height, self.units)
             else:
-                h = w * aspect
-
-            rect = fitz.Rect(x, y, x + w, y + h)
+                # No height specified: use source aspect ratio
+                h = w * src_aspect
+
+            # Calculate content rect using fit mode
+            from .units import calculate_fit
+
+            content_w, content_h, offset_x, offset_y = calculate_fit(
+                src_aspect, w, h, panel.fit
+            )
+            rect = fitz.Rect(
+                x + offset_x,
+                y + offset_y,
+                x + offset_x + content_w,
+                y + offset_y + content_h,
+            )
 
             if src_doc.is_pdf:
                 page.show_pdf_page(rect, src_doc, 0)

figquilt/compose_svg.py

@@ -59,30 +59,50 @@ class SVGComposer:
         try:
             src_page = src_doc[0]
             src_rect = src_page.rect
-            aspect = src_rect.height / src_rect.width
+            src_aspect = src_rect.height / src_rect.width
 
             if panel.height is not None:
                 h = to_pt(panel.height, self.units)
             else:
-                h = w * aspect
+                h = w * src_aspect
+
+            # Calculate content dimensions using fit mode
+            from .units import calculate_fit
+
+            content_w, content_h, offset_x, offset_y = calculate_fit(
+                src_aspect, w, h, panel.fit
+            )
 
             # Group for the panel
             g = etree.SubElement(root, "g")
             g.set("transform", f"translate({x}, {y})")
 
+            # For cover mode, add a clip path to crop the overflow
+            if panel.fit == "cover":
+                clip_id = f"clip-{panel.id}"
+                defs = etree.SubElement(g, "defs")
+                clip_path = etree.SubElement(defs, "clipPath")
+                clip_path.set("id", clip_id)
+                clip_rect = etree.SubElement(clip_path, "rect")
+                clip_rect.set("x", "0")
+                clip_rect.set("y", "0")
+                clip_rect.set("width", str(w))
+                clip_rect.set("height", str(h))
+
             # Insert content
             # Check if SVG
             suffix = panel.file.suffix.lower()
             if suffix == ".svg":
                 # Embed SVG by creating an <image> tag with data URI to avoid DOM conflicts
-                # This is safer than merging trees for V0.
-                # Merging trees requires stripping root, handling viewbox/transform matching.
-                # <image> handles scaling automatically.
                 data_uri = self._get_data_uri(panel.file, "image/svg+xml")
                 img = etree.SubElement(g, "image")
-                img.set("width", str(w))
-                img.set("height", str(h))
+                img.set("x", str(offset_x))
+                img.set("y", str(offset_y))
+                img.set("width", str(content_w))
+                img.set("height", str(content_h))
                 img.set("{http://www.w3.org/1999/xlink}href", data_uri)
+                if panel.fit == "cover":
+                    img.set("clip-path", f"url(#{clip_id})")
             else:
                 # PDF or Raster Image
                 # For PDF, we rasterize to PNG (easiest for SVG compatibility without huge libs)
@@ -112,12 +132,16 @@ class SVGComposer:
                     data_uri = self._get_data_uri(data_path, mime)
 
                 img = etree.SubElement(g, "image")
-                img.set("width", str(w))
-                img.set("height", str(h))
+                img.set("x", str(offset_x))
+                img.set("y", str(offset_y))
+                img.set("width", str(content_w))
+                img.set("height", str(content_h))
                 img.set("{http://www.w3.org/1999/xlink}href", data_uri)
+                if panel.fit == "cover":
+                    img.set("clip-path", f"url(#{clip_id})")
 
-            # Label
-            self._draw_label(g, panel, w, h, index)
+            # Label (positioned relative to content, not cell)
+            self._draw_label(g, panel, content_w, content_h, offset_x, offset_y, index)
         finally:
             src_doc.close()
 
@@ -128,7 +152,14 @@ class SVGComposer:
         return f"data:{mime};base64,{b64}"
 
     def _draw_label(
-        self, parent: etree.Element, panel: Panel, w: float, h: float, index: int
+        self,
+        parent: etree.Element,
+        panel: Panel,
+        content_w: float,
+        content_h: float,
+        offset_x: float,
+        offset_y: float,
+        index: int,
     ):
         style = panel.label_style if panel.label_style else self.layout.page.label
         if not style.enabled:
@@ -142,9 +173,9 @@ class SVGComposer:
         if style.uppercase:
             text_str = text_str.upper()
 
-        # Offset (relative to panel top-left, which is 0,0 inside the group)
-        x = mm_to_pt(style.offset_x_mm)
-        y = mm_to_pt(style.offset_y_mm)
+        # Offset relative to the content position
+        x = offset_x + mm_to_pt(style.offset_x_mm)
+        y = offset_y + mm_to_pt(style.offset_y_mm)
 
         # Create text element
         txt = etree.SubElement(parent, "text")

figquilt/layout.py

@@ -1,7 +1,10 @@
-from typing import Optional, List, Tuple, Union
+from typing import Literal, Optional, List
 from pathlib import Path
 from pydantic import BaseModel, Field, field_validator
 
+FitMode = Literal["contain", "cover"]
+
+
 class LabelStyle(BaseModel):
     enabled: bool = True
     auto_sequence: bool = True
@@ -12,6 +15,7 @@ class LabelStyle(BaseModel):
     bold: bool = True
     uppercase: bool = True
 
+
 class Panel(BaseModel):
     id: str
     file: Path
@@ -19,6 +23,7 @@ class Panel(BaseModel):
     y: float
     width: float
     height: Optional[float] = None  # If None, compute from aspect ratio
+    fit: FitMode = "contain"
     label: Optional[str] = None
     label_style: Optional[LabelStyle] = None
 
@@ -29,6 +34,7 @@ class Panel(BaseModel):
         # but we could add it if desired. The parser/logic will check it.
         return v
 
+
 class Page(BaseModel):
     width: float
     height: float
@@ -37,6 +43,7 @@ class Page(BaseModel):
     background: Optional[str] = "white"
     label: LabelStyle = Field(default_factory=LabelStyle)
 
+
 class Layout(BaseModel):
     page: Page
     panels: List[Panel]

figquilt/units.py

@@ -23,3 +23,48 @@ def to_pt(value: float, units: str) -> float:
         return value
     else:
         raise ValueError(f"Unknown unit: {units}")
+
+
+def calculate_fit(
+    src_aspect: float, cell_w: float, cell_h: float, fit_mode: str
+) -> tuple[float, float, float, float]:
+    """
+    Calculate content dimensions and offset based on fit mode.
+
+    Args:
+        src_aspect: Source aspect ratio (height / width)
+        cell_w: Cell width in points
+        cell_h: Cell height in points
+        fit_mode: "contain" or "cover"
+
+    Returns:
+        Tuple of (content_w, content_h, offset_x, offset_y)
+    """
+    cell_aspect = cell_h / cell_w
+
+    if fit_mode == "cover":
+        # Scale to cover entire cell (may crop)
+        if src_aspect > cell_aspect:
+            # Source is taller: scale by width, crop top/bottom
+            content_w = cell_w
+            content_h = cell_w * src_aspect
+        else:
+            # Source is wider: scale by height, crop left/right
+            content_h = cell_h
+            content_w = cell_h / src_aspect
+    else:  # contain (default)
+        # Scale to fit within cell, preserving aspect ratio
+        if src_aspect > cell_aspect:
+            # Source is taller: fit by height
+            content_h = cell_h
+            content_w = cell_h / src_aspect
+        else:
+            # Source is wider: fit by width
+            content_w = cell_w
+            content_h = cell_w * src_aspect
+
+    # Center in cell
+    offset_x = (cell_w - content_w) / 2
+    offset_y = (cell_h - content_h) / 2
+
+    return content_w, content_h, offset_x, offset_y

{figquilt-0.1.3.dist-info → figquilt-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: figquilt
-Version: 0.1.3
+Version: 0.1.4
 Summary: figquilt is a small, language-agnostic CLI tool that composes multiple figures (PDF/SVG/PNG) into a single publication-ready figure, based on a simple layout file (YAML/JSON). The key function is creating a PDF by composing multiple PDFs and adding subfigure labels and minimal annotations.
 Author: YY Ahn
 Author-email: YY Ahn <yongyeol@gmail.com>

figquilt-0.1.4.dist-info/RECORD

@@ -0,0 +1,13 @@
+figquilt/__init__.py,sha256=91447944015cec709e8aa7655f7e9d64e1e4508e7023a57fe3746911c0fc6fed,22
+figquilt/cli.py,sha256=d73f2f97ca86b0d932e5a4dac8596e3137017517e2b7017916920bfe8e36a789,6930
+figquilt/compose_pdf.py,sha256=b9418a415eb52da82b3126501cdded8048083418ba69cb6e9c281f0ecc0ebe0f,6172
+figquilt/compose_svg.py,sha256=3a3499c9805508c38906568e984d46cd391f1432ab2fea21b3fe2be783816c81,7418
+figquilt/errors.py,sha256=6f4001dcae85d2171f7aa7df4161926771dbe8c21068ccb70a7865298f05cf2b,298
+figquilt/images.py,sha256=c613655fb3a0790fca98182c558c584e632a8822225220a5feb6080c7c68eb9e,815
+figquilt/layout.py,sha256=12a1169f05630ba97b3b29f2d269708b38da697357e5d511e12fad5e484fbfbe,1226
+figquilt/parser.py,sha256=d33d21178721072bbf681be940312b5fda0275f451fca3be2affad707f80a7fb,1065
+figquilt/units.py,sha256=25098b6d7559cb78214fe1a9889fd38ce88633993d0c92819cc609510654275d,2124
+figquilt-0.1.4.dist-info/WHEEL,sha256=76443c98c0efcfdd1191eac5fa1d8223dba1c474dbd47676674a255e7ca48770,79
+figquilt-0.1.4.dist-info/entry_points.txt,sha256=8f70ce07f585bed28aca569052c7f0029384ac67c5e738faeb0daeb31695bc85,48
+figquilt-0.1.4.dist-info/METADATA,sha256=a21301d1e2a2d00ae70e43531d0e2145f79cc0cffa93eac07be19fadc39a4463,3330
+figquilt-0.1.4.dist-info/RECORD,,

figquilt-0.1.3.dist-info/RECORD

@@ -1,13 +0,0 @@
-figquilt/__init__.py,sha256=91447944015cec709e8aa7655f7e9d64e1e4508e7023a57fe3746911c0fc6fed,22
-figquilt/cli.py,sha256=d73f2f97ca86b0d932e5a4dac8596e3137017517e2b7017916920bfe8e36a789,6930
-figquilt/compose_pdf.py,sha256=5c0391e2259c830cfaa760a5f06b33b3173ecfd8fb067ca63321dae15ea252dc,5700
-figquilt/compose_svg.py,sha256=161042f0067d87891cc0d95e363b759fb6b3d40e3c55d50673d7c2bfe9011ba2,6246
-figquilt/errors.py,sha256=6f4001dcae85d2171f7aa7df4161926771dbe8c21068ccb70a7865298f05cf2b,298
-figquilt/images.py,sha256=c613655fb3a0790fca98182c558c584e632a8822225220a5feb6080c7c68eb9e,815
-figquilt/layout.py,sha256=44514c72f8883afe02f5dd05e674410440dc52c40966a8028f1d9693d4be3364,1159
-figquilt/parser.py,sha256=d33d21178721072bbf681be940312b5fda0275f451fca3be2affad707f80a7fb,1065
-figquilt/units.py,sha256=cb14151b8b456a53d823ac5021b339bddefe3aac09e945d81a8306c1370f49fd,684
-figquilt-0.1.3.dist-info/WHEEL,sha256=76443c98c0efcfdd1191eac5fa1d8223dba1c474dbd47676674a255e7ca48770,79
-figquilt-0.1.3.dist-info/entry_points.txt,sha256=8f70ce07f585bed28aca569052c7f0029384ac67c5e738faeb0daeb31695bc85,48
-figquilt-0.1.3.dist-info/METADATA,sha256=fda0ebf7ae6118a48a337b983a8e9bd09c31c1df4bb8f5b329af404ae46a37fb,3330
-figquilt-0.1.3.dist-info/RECORD,,