v10: Pillow speech bubbles overlay for legible dialogue + Gemini 3 Pro primary

app.py

@@ -270,6 +270,98 @@ def build_page_prompt(page_data, script, style):
     return prompt[:1800]
 
 # ── GENERATE ONE PAGE ─────────────────────────────────────────────────────────
+
+def draw_speech_bubbles(img, panels):
+    """Draw readable speech bubbles with Pillow over the comic page."""
+    draw = ImageDraw.Draw(img)
+    W, H = img.size
+    
+    # Calculate panel zones (4 panels: top-wide, mid-left, mid-right, bottom-wide)
+    panel_zones = [
+        (0, 0, W, H//2),           # Panel 1 top half
+        (0, H//2, W//2, H),        # Panel 2 bottom-left
+        (W//2, H//2, W, H),        # Panel 3 bottom-right
+    ]
+    if len(panels) >= 4:
+        panel_zones = [
+            (0, 0, W, H//3),           # Panel 1 top strip
+            (0, H//3, W//2, 2*H//3),   # Panel 2 mid-left
+            (W//2, H//3, W, 2*H//3),   # Panel 3 mid-right
+            (0, 2*H//3, W, H),         # Panel 4 bottom strip
+        ]
+    
+    font_b = fnt(_B, 22)
+    font_r = fnt(_R, 20)
+    
+    for i, panel in enumerate(panels[:len(panel_zones)]):
+        if i >= len(panel_zones):
+            break
+        px0, py0, px1, py1 = panel_zones[i]
+        dialogues = panel.get('dialogue', [])
+        caption   = panel.get('caption', '')
+        
+        bubble_y = py1 - 15  # Start from bottom of panel
+        
+        # Draw dialogues (from bottom up)
+        for j, dlg in enumerate(reversed(dialogues[-2:])):  # max 2 bubbles per panel
+            char = dlg.get('character', '')
+            text = dlg.get('text', '')
+            if not text:
+                continue
+            
+            # Wrap text
+            max_chars = 25
+            words = text.split()
+            wrapped_lines = []
+            line = ''
+            for w in words:
+                if len(line) + len(w) + 1 <= max_chars:
+                    line = (line + ' ' + w).strip()
+                else:
+                    if line: wrapped_lines.append(line)
+                    line = w
+            if line: wrapped_lines.append(line)
+            wrapped_lines = wrapped_lines[:3]  # max 3 lines
+            
+            # Calculate bubble dimensions
+            line_h = 26
+            text_h = len(wrapped_lines) * line_h + 8
+            char_w = max(len(l) for l in wrapped_lines) * 13 + 20
+            char_w = min(char_w, (px1 - px0) - 20)
+            bub_h  = text_h + 30  # space for char name
+            
+            # Position bubble
+            bub_x0 = px0 + 15
+            bub_y1 = bubble_y
+            bub_y0 = bub_y1 - bub_h
+            bub_x1 = bub_x0 + char_w
+            
+            if bub_y0 < py0 + 10:
+                break  # No space
+            
+            # Draw white rounded bubble
+            draw.rounded_rectangle([bub_x0, bub_y0, bub_x1, bub_y1], radius=12,
+                                   fill=(255,255,255), outline=(20,20,20), width=2)
+            
+            # Character name in bold
+            draw.text((bub_x0+10, bub_y0+6), char[:12] + ':', font=font_b, fill=(20,20,80))
+            
+            # Dialogue text
+            for k, wl in enumerate(wrapped_lines):
+                draw.text((bub_x0+10, bub_y0+28+k*line_h), wl, font=font_r, fill=(20,20,20))
+            
+            bubble_y = bub_y0 - 8  # Stack bubbles upward
+        
+        # Draw caption box at top of panel if exists
+        if caption:
+            cap_text = caption[:50]
+            cap_w = len(cap_text) * 10 + 20
+            cap_w = min(cap_w, px1 - px0 - 10)
+            draw.rectangle([px0+5, py0+5, px0+cap_w, py0+30], fill=(255,255,220), outline=(100,100,0), width=1)
+            draw.text((px0+10, py0+8), cap_text, font=fnt(_R, 16), fill=(60,40,0))
+    
+    return img
+
 def generate_page(page_data, script, style, title, page_num, total, api_key):
     prompt = build_page_prompt(page_data, script, style)
     seed = page_num * 137
@@ -291,6 +383,10 @@ def generate_page(page_data, script, style, title, page_num, total, api_key):
         print('  Using placeholder')
         art = placeholder(page_num, title)
 
+    # Add readable speech bubbles with Pillow (works even with Pollinations)
+    panels = page_data.get('panels', [])
+    art = draw_speech_bubbles(art.copy(), panels)
+    
     final = add_header_footer(art, page_num, total, title)
     print('Page ' + str(page_num) + ' done')
     return final