import cv2 import numpy as np import gradio as gr from PIL import Image import tensorflow as tf import keras from huggingface_hub import snapshot_download import pytesseract import io import math import os import re import tempfile from collections import defaultdict import matplotlib matplotlib.use("Agg") import matplotlib.pyplot as plt from reportlab.lib.pagesizes import letter from reportlab.lib.units import inch from reportlab.lib.styles import getSampleStyleSheet from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, Image as RLImage import requests _msi_model = None LOGO_PATH = "logo.png" COUNTAPI_BASE = "https://countapi.mileshilliard.com/api/v1" COUNTAPI_KEY = "haanilango-design-analyzer-images-analyzed" def format_count_badge(count): return ( f'
' f'
{count:,} images were tested
' f'
' ) def get_current_count(): try: resp = requests.get(f"{COUNTAPI_BASE}/get/{COUNTAPI_KEY}", timeout=5) if resp.status_code == 200: return resp.json().get("value", 0) except Exception: pass return 0 def increment_count(): try: resp = requests.get(f"{COUNTAPI_BASE}/hit/{COUNTAPI_KEY}", timeout=5) if resp.status_code == 200: return resp.json().get("value", None) except Exception: pass return None def add_watermark(pil_img, logo_path=LOGO_PATH, scale=0.20, opacity=0.95): if not os.path.exists(logo_path): return pil_img try: base = pil_img.convert("RGBA") logo = Image.open(logo_path).convert("RGBA") bbox = logo.getbbox() if bbox: logo = logo.crop(bbox) img_w, img_h = base.size logo_w = max(50, int(img_w * scale)) logo_ratio = logo.height / logo.width logo_h = int(logo_w * logo_ratio) logo_resized = logo.resize((logo_w, logo_h), Image.LANCZOS) r, g, b, a = logo_resized.split() a = a.point(lambda p: int(p * opacity)) logo_resized = Image.merge("RGBA", (r, g, b, a)) margin = max(10, int(img_w * 0.015)) pos = (img_w - logo_w - margin, img_h - logo_h - margin) base.paste(logo_resized, pos, logo_resized) return base.convert("RGB") except Exception: return pil_img def load_msi_net(): global _msi_model if _msi_model is None: hf_dir = snapshot_download(repo_id="alexanderkroner/MSI-Net") _msi_model = keras.layers.TFSMLayer(hf_dir, call_endpoint="serving_default") return _msi_model def get_target_shape(original_shape): ar = original_shape[0] / original_shape[1] square_mode = abs(ar - 1.0) landscape_mode = abs(ar - 240 / 320) portrait_mode = abs(ar - 320 / 240) best = min(square_mode, landscape_mode, portrait_mode) if best == square_mode: return (320, 320) elif best == landscape_mode: return (240, 320) else: return (320, 240) def preprocess_input(input_image, target_shape): t = tf.expand_dims(input_image, axis=0) t = tf.image.resize(t, target_shape, preserve_aspect_ratio=True) vp = target_shape[0] - t.shape[1] hp = target_shape[1] - t.shape[2] v1, v2 = vp // 2, vp - vp // 2 h1, h2 = hp // 2, hp - hp // 2 t = tf.pad(t, [[0, 0], [v1, v2], [h1, h2], [0, 0]]) return t, [v1, v2], [h1, h2] def postprocess_output(output_tensor, vp, hp, original_shape): output_tensor = output_tensor[:, vp[0]:output_tensor.shape[1] - vp[1], hp[0]:output_tensor.shape[2] - hp[1], :] output_tensor = tf.image.resize(output_tensor, original_shape) return output_tensor.numpy().squeeze() def compute_text_boost_map(pil_img): img_arr = np.array(pil_img.convert("RGB")) h, w = img_arr.shape[:2] data = pytesseract.image_to_data(img_arr, config="--psm 11", output_type=pytesseract.Output.DICT) text_map = np.zeros((h, w), dtype=np.float32) for i in range(len(data['text'])): word = data['text'][i].strip() tw_, th_ = data['width'][i], data['height'][i] if not word or th_ < 8 or tw_ < 5: continue x, y = data['left'][i], data['top'][i] weight = min(1.0, (th_ / h) * 6) pad = int(th_ * 0.15) y0, y1 = max(0, y - pad), min(h, y + th_ + pad) x0, x1 = max(0, x - pad), min(w, x + tw_ + pad) text_map[y0:y1, x0:x1] = np.maximum(text_map[y0:y1, x0:x1], weight) return text_map def compute_saliency_map(pil_image): model = load_msi_net() input_image = np.array(pil_image.convert("RGB"), dtype=np.float32) original_shape = input_image.shape[:2] target_shape = get_target_shape(original_shape) input_tensor, v_pad, h_pad = preprocess_input(input_image, target_shape) raw_output = model(input_tensor) output_tensor = list(raw_output.values())[0] if isinstance(raw_output, dict) else raw_output msi_saliency = postprocess_output(output_tensor, v_pad, h_pad, original_shape) msi_saliency = msi_saliency.astype(np.float32) msi_saliency -= msi_saliency.min() if msi_saliency.max() > 0: msi_saliency /= msi_saliency.max() text_boost = compute_text_boost_map(pil_image) combined = 0.7 * msi_saliency + 0.3 * text_boost return combined def render_heatmap_overlay(img_bgr, saliency_map, alpha=0.45): heat_u8 = (saliency_map * 255).astype(np.uint8) heat_color = cv2.applyColorMap(heat_u8, cv2.COLORMAP_JET) return cv2.addWeighted(heat_color, alpha, img_bgr, 1 - alpha, 0) def compute_attention_scores(saliency_map): flat = np.sort(saliency_map.flatten()) n = len(flat) cum = np.cumsum(flat) gini = (n + 1 - 2 * np.sum(cum) / (cum[-1] + 1e-8)) / n focus_score = float(gini) * 100 spread_score = float((saliency_map >= 0.5).mean()) * 100 return {"focus_score": round(focus_score, 1), "spread_score": round(spread_score, 1)} def compute_readability_score(read): if read['words_checked'] == 0: return None penalty = 12 * math.sqrt(read['contrast_issues']) + 8 * math.sqrt(read['small_text_issues']) return round(max(0, 100 - penalty), 1) def coverage_grade_score(spread_score): if spread_score < 40: return 100.0 return max(0.0, 100.0 - (spread_score - 40) * 2) def compute_overall_grade(focus_score, spread_score, readability_score): coverage_score = coverage_grade_score(spread_score) if readability_score is None: total = round((0.55 / 0.75) * focus_score + (0.20 / 0.75) * coverage_score) else: total = round(0.55 * focus_score + 0.20 * coverage_score + 0.25 * readability_score) total = max(0, min(100, total)) if total >= 75: grade = "Strong" elif total >= 50: grade = "Good Start" else: grade = "Room to Grow" return total, grade def explain_grade(focus_score, spread_score, readability_score, read): coverage_score = coverage_grade_score(spread_score) weighted_coverage_deficit = 0.20 * max(0, 100 - coverage_score) if readability_score is None: if weighted_coverage_deficit > 0.55 * max(0, 100 - focus_score): return "based on attention alone (this design's text couldn't be reliably read, so readability wasn't scored) - mainly because attention is spread too widely without settling anywhere" elif focus_score < 50: return "based on attention alone (this design's text couldn't be reliably read, so readability wasn't scored) - mainly because attention is spread out without one clear focal point" elif focus_score > 90: return "based on attention alone (this design's text couldn't be reliably read, so readability wasn't scored) - attention is very tightly focused on one spot" else: return "based on attention alone - this design's text couldn't be reliably read, so readability wasn't included" total_issues = read['contrast_issues'] + read['small_text_issues'] weighted_focus_deficit = 0.55 * max(0, 100 - focus_score) weighted_read_deficit = 0.25 * max(0, 100 - readability_score) if weighted_coverage_deficit > weighted_focus_deficit and weighted_coverage_deficit > weighted_read_deficit: return "mainly because attention is spread too widely across the design without settling anywhere" elif weighted_read_deficit >= weighted_focus_deficit and total_issues > 0: return "mainly due to text readability - some text is harder to read than ideal" elif focus_score < 50: return "mainly because attention is spread out, without one clear focal point" elif focus_score > 90: return "attention is very tightly focused on one spot - worth checking other key elements (logo, CTA) aren't being missed" else: return "a mix of small readability and focus factors - see details below" def compute_hierarchy(text_sizes): if len(text_sizes) < 2: return None largest = max(text_sizes) smallest = min(text_sizes) ratio = largest / max(smallest, 0.1) score = round(min(100, ratio * 20), 1) return score, ratio def hierarchy_description(ratio): if ratio < 1.5: return "text sizes are very similar - there's no single element that clearly leads the eye" elif ratio < 2.5: return "there's some size variation, but the hierarchy could be stronger" else: return "clear size hierarchy - one element leads, the rest support it" def compute_balance(saliency_map): h, w = saliency_map.shape left = saliency_map[:, :w // 2].mean() right = saliency_map[:, w // 2:].mean() top = saliency_map[:h // 2, :].mean() bottom = saliency_map[h // 2:, :].mean() horiz_diff = abs(left - right) / max(left + right, 1e-6) vert_diff = abs(top - bottom) / max(top + bottom, 1e-6) imbalance = (horiz_diff + vert_diff) / 2 score = round(max(0, 100 - imbalance * 200), 1) return score def balance_description(score): if score >= 75: return "well balanced - visual weight is evenly distributed" elif score >= 50: return "somewhat uneven - one side carries noticeably more visual weight" else: return "heavily lopsided - attention is pulled hard toward one side or corner" def detect_price_info(all_words): joined = " ".join(all_words) price_pattern = r'[\$£€¥]\s?\d[\d,]*(\.\d{1,2})?|\b\d[\d,]*(\.\d{1,2})?\s?(SGD|USD|GBP|EUR|dollars?|cents?)\b' return bool(re.search(price_pattern, joined, re.IGNORECASE)) def detect_location_info(all_words): joined = " ".join(all_words) location_pattern = ( r'\b(venue|address|location|street|st\.|road|rd\.|avenue|ave\.|' r'blvd|drive|dr\.|www\.|\.com|\.sg|\.net)\b' ) postal_pattern = r'\bS?\d{6}\b' return bool(re.search(location_pattern, joined, re.IGNORECASE)) or bool(re.search(postal_pattern, joined)) def coverage_description(spread_score): if spread_score < 15: return "concentrated on one clear focal point - that's usually a good sign, not a problem" elif spread_score < 40: return "landing mostly in a couple of areas, which is fairly typical" else: return "spread fairly widely across the design" def create_score_chart(focus_score, spread_score, readability_score, hierarchy_score=None, balance_score=None): labels = ["Clear Focal\nPoint", "Attention\nCoverage"] values = [focus_score, spread_score] if readability_score is not None: labels.append("Readability") values.append(readability_score) if hierarchy_score is not None: labels.append("Visual\nHierarchy") values.append(hierarchy_score) if balance_score is not None: labels.append("Balance") values.append(balance_score) colors = [] for v in values: if v >= 75: colors.append("#4CAF50") elif v >= 50: colors.append("#FFC107") else: colors.append("#F44336") fig, ax = plt.subplots(figsize=(5, 3), dpi=100) bars = ax.barh(labels, values, color=colors) ax.set_xlim(0, 100) ax.set_xlabel("Score out of 100") ax.invert_yaxis() for bar, v in zip(bars, values): ax.text(min(v + 2, 92), bar.get_y() + bar.get_height() / 2, f"{v:.0f}", va="center", fontsize=10) ax.set_title("Scores at a Glance") fig.tight_layout() buf = io.BytesIO() fig.savefig(buf, format="png") plt.close(fig) buf.seek(0) return Image.open(buf).convert("RGB") def generate_recommendations(saliency_map, scores, read, img_h, img_w): tips = [] bottom_band = saliency_map[int(img_h * 0.85):, :] bottom_avg = bottom_band.mean() if bottom_avg < 0.25: tips.append("Your bottom section (often where CTAs or contact info sit) is getting low attention. Consider bolder color contrast or larger text there.") if scores['focus_score'] < 40: tips.append("Attention is scattered with no clear focal point. Consider making one element (headline, product, or offer) visually dominant.") elif scores['focus_score'] > 90: tips.append("Attention is very narrowly focused on one spot - double check other important elements (logo, CTA) are not being ignored.") if read['contrast_issues'] > 0: if read['contrast_issues'] > 5: tips.append(f"A quick win: {read['contrast_issues']} text elements could read more clearly. The good news - the pattern (see white boxes marked \"Low contrast\" on the image) suggests one color choice affects most of them, so a single tweak will likely fix most at once.") else: tips.append(f"{read['contrast_issues']} text element(s) could be easier to read - see the white boxes marked \"Low contrast\" on the image above, then darken the text or lighten its background.") if read['small_text_issues'] > 0: if read['small_text_issues'] > 5: tips.append(f"Another quick win: {read['small_text_issues']} text elements are a bit small. Likely one font-size setting affects most of them, so this is usually a fast fix.") else: tips.append(f"{read['small_text_issues']} text element(s) are a bit small - see the white boxes marked \"Small text\" on the image above.") if not tips: tips.append("No major issues detected - this design is in solid shape.") return tips def identify_hotspots(saliency_map, img_h, img_w, top_n=4): threshold = np.percentile(saliency_map, 85) binary = (saliency_map >= threshold).astype(np.uint8) kernel = np.ones((25, 25), np.uint8) binary = cv2.morphologyEx(binary, cv2.MORPH_CLOSE, kernel) num_labels, labels, stats, centroids = cv2.connectedComponentsWithStats(binary, connectivity=8) zones = [] for i in range(1, num_labels): area = stats[i, cv2.CC_STAT_AREA] if area < (img_h * img_w * 0.005): continue cx, cy = centroids[i] h_pos = "top" if cy < img_h * 0.33 else ("bottom" if cy > img_h * 0.66 else "middle") w_pos = "left" if cx < img_w * 0.33 else ("right" if cx > img_w * 0.66 else "center") avg_intensity = float(saliency_map[labels == i].mean()) zones.append({"position": f"{h_pos}-{w_pos}", "area_pct": round(float(area / (img_h * img_w)) * 100, 1), "intensity": round(avg_intensity * 100, 1), "cx": int(cx), "cy": int(cy)}) zones.sort(key=lambda z: -z["intensity"]) top_zones = zones[:top_n] for idx, z in enumerate(top_zones): z["intensity_rank"] = idx + 1 top_zones.sort(key=lambda z: (z["cy"], z["cx"])) return top_zones def relative_luminance(rgb): def chan(c): c = c / 255.0 return c / 12.92 if c <= 0.03928 else ((c + 0.055) / 1.055) ** 2.4 r, g, b = rgb return 0.2126 * chan(r) + 0.7152 * chan(g) + 0.0722 * chan(b) def contrast_ratio(rgb1, rgb2): l1 = relative_luminance(rgb1) l2 = relative_luminance(rgb2) lighter, darker = max(l1, l2), min(l1, l2) return (lighter + 0.05) / (darker + 0.05) def required_contrast_ratio(size_pct): return 3.0 if size_pct >= 3.0 else 4.5 def contrast_severity_label(ratio, required_ratio): deficit = (required_ratio - ratio) / required_ratio if deficit > 0.6: return "could be much clearer" elif deficit > 0.35: return "could be clearer" elif deficit > 0.15: return "slightly less clear than ideal" else: return "close to the recommended level" def sample_text_and_bg_color(img_arr, x, y, w, h): pad = max(2, int(h * 0.3)) y0, y1 = max(0, y - pad), min(img_arr.shape[0], y + h + pad) x0, x1 = max(0, x - pad), min(img_arr.shape[1], x + w + pad) region = img_arr[y0:y1, x0:x1].reshape(-1, 3).astype(np.float32) if len(region) < 10: return None, None criteria = (cv2.TERM_CRITERIA_EPS + cv2.TERM_CRITERIA_MAX_ITER, 10, 1.0) try: _, _, centers = cv2.kmeans(region, 2, None, criteria, 3, cv2.KMEANS_PP_CENTERS) except cv2.error: return None, None color1 = tuple(centers[0].astype(int)) color2 = tuple(centers[1].astype(int)) return color1, color2 def analyze_readability(pil_img): img_arr = np.array(pil_img.convert("RGB")) img_h = img_arr.shape[0] gray = cv2.cvtColor(img_arr, cv2.COLOR_RGB2GRAY) clahe = cv2.createCLAHE(clipLimit=2.0, tileGridSize=(8, 8)) gray_enhanced = clahe.apply(gray) gray_denoised = cv2.medianBlur(gray_enhanced, 3) bw = cv2.adaptiveThreshold(gray_denoised, 255, cv2.ADAPTIVE_THRESH_GAUSSIAN_C, cv2.THRESH_BINARY, 31, 10) cleanup_kernel = np.ones((2, 2), np.uint8) bw = cv2.morphologyEx(bw, cv2.MORPH_OPEN, cleanup_kernel) ocr_data = pytesseract.image_to_data(bw, output_type=pytesseract.Output.DICT) all_words_loose = [t.strip() for t in ocr_data['text'] if t.strip()] words_checked = 0 contrast_issues = 0 small_text_issues = 0 issue_lines = [] issue_boxes = [] text_sizes = [] for i in range(len(ocr_data['text'])): word = ocr_data['text'][i].strip() conf = int(ocr_data['conf'][i]) if not word or conf < 60 or len(word) < 2: continue x, y, w, h = ocr_data['left'][i], ocr_data['top'][i], ocr_data['width'][i], ocr_data['height'][i] if w < 3 or h < 3: continue words_checked += 1 size_pct = (h / img_h) * 100 text_sizes.append(size_pct) text_color, bg_color = sample_text_and_bg_color(img_arr, x, y, w, h) if text_color is None: continue ratio = contrast_ratio(text_color, bg_color) required_ratio = required_contrast_ratio(size_pct) is_contrast_issue = ratio < required_ratio is_small_issue = size_pct < 1.2 if is_contrast_issue: contrast_issues += 1 if len(issue_lines) < 5: severity = contrast_severity_label(ratio, required_ratio) issue_lines.append(f"- \"{word}\" {severity} against its background") if is_small_issue: small_text_issues += 1 if len(issue_lines) < 5: issue_lines.append(f"- \"{word}\" is a bit small to read comfortably") if is_contrast_issue or is_small_issue: combined_label = " + ".join( l for l, flag in [("Low contrast", is_contrast_issue), ("Small text", is_small_issue)] if flag ) issue_boxes.append({"box": (x, y, w, h), "label": combined_label}) return {"words_checked": words_checked, "contrast_issues": contrast_issues, "small_text_issues": small_text_issues, "issue_lines": issue_lines, "issue_boxes": issue_boxes, "text_sizes": text_sizes, "all_words": all_words_loose} def merge_issue_boxes(issue_boxes, gap=15): by_label = defaultdict(list) for item in issue_boxes: by_label[item["label"]].append(item["box"]) merged = [] for label, boxes in by_label.items(): boxes = sorted(boxes, key=lambda b: (b[1], b[0])) used = [False] * len(boxes) for i in range(len(boxes)): if used[i]: continue x, y, w, h = boxes[i] mx0, my0, mx1, my1 = x, y, x + w, y + h used[i] = True changed = True while changed: changed = False for j in range(len(boxes)): if used[j]: continue bx, by, bw, bh = boxes[j] bx0, by0, bx1, by1 = bx, by, bx + bw, by + bh vertical_overlap = min(my1, by1) - max(my0, by0) if vertical_overlap > 0 and bx0 - mx1 <= gap and bx1 >= mx0 - gap: mx0, my0 = min(mx0, bx0), min(my0, by0) mx1, my1 = max(mx1, bx1), max(my1, by1) used[j] = True changed = True merged.append({"box": (mx0, my0, mx1 - mx0, my1 - my0), "label": label}) return merged def draw_issue_markers(overlay_bgr, issue_boxes, img_h, img_w): img = overlay_bgr.copy() scale = max(1.0, min(img_h, img_w) / 800.0) merged_issues = merge_issue_boxes(issue_boxes) placed_label_rects = [] pad = int(4 * scale) box_border = max(2, int(3 * scale)) thin_border = max(1, int(scale)) font_scale = 0.5 * scale text_thickness = max(1, int(round(scale))) for issue in merged_issues: x, y, w, h = issue["box"] cv2.rectangle(img, (x - pad, y - pad), (x + w + pad, y + h + pad), (255, 255, 255), box_border) cv2.rectangle(img, (x - pad, y - pad), (x + w + pad, y + h + pad), (0, 0, 0), thin_border) label = issue["label"] (tw, th), _ = cv2.getTextSize(label, cv2.FONT_HERSHEY_SIMPLEX, font_scale, text_thickness) label_x0 = x - pad label_x1 = label_x0 + tw + int(8 * scale) label_y1 = max(th + int(6 * scale), y - pad) label_y0 = label_y1 - th - int(6 * scale) collision = True attempts = 0 while collision and attempts < 10: collision = False for (px0, py0, px1, py1) in placed_label_rects: if not (label_x1 < px0 or label_x0 > px1 or label_y1 < py0 or label_y0 > py1): collision = True label_y1 -= (th + int(10 * scale)) label_y0 = label_y1 - th - int(6 * scale) break attempts += 1 placed_label_rects.append((label_x0, label_y0, label_x1, label_y1)) cv2.rectangle(img, (label_x0, label_y0), (label_x1, label_y1), (255, 255, 255), -1) cv2.rectangle(img, (label_x0, label_y0), (label_x1, label_y1), (0, 0, 0), thin_border) cv2.putText(img, label, (label_x0 + int(4 * scale), label_y1 - int(4 * scale)), cv2.FONT_HERSHEY_SIMPLEX, font_scale, (0, 0, 0), text_thickness, cv2.LINE_AA) return img def markdown_to_paragraphs(md_text, styles): story = [] for raw_line in md_text.split("\n"): line = raw_line.strip() if not line: story.append(Spacer(1, 6)) continue if line.startswith("## "): story.append(Paragraph(line[3:], styles['Heading1'])) elif line.startswith("### "): story.append(Paragraph(line[4:], styles['Heading2'])) elif line.startswith("---"): story.append(Spacer(1, 10)) elif line.startswith("- ") or line.startswith("* "): text = line[2:] text = re.sub(r'\*\*(.*?)\*\*', r'\1', text) text = re.sub(r'\*(.*?)\*', r'\1', text) story.append(Paragraph("• " + text, styles['Normal'])) elif re.match(r'^\d+\.\s', line): num, text = line.split('.', 1) text = re.sub(r'\*\*(.*?)\*\*', r'\1', text.strip()) story.append(Paragraph(f"{num}. {text}", styles['Normal'])) else: text = re.sub(r'\*\*(.*?)\*\*', r'\1', line) text = re.sub(r'\*(.*?)\*', r'\1', text) text = re.sub(r'\[([^\]]+)\]\(([^)]+)\)', r'\1', text) story.append(Paragraph(text, styles['Normal'])) return story def stamp_pdf_watermark(canvas_obj, doc): if not os.path.exists(LOGO_PATH): return try: from reportlab.lib.utils import ImageReader logo = Image.open(LOGO_PATH).convert("RGBA") bbox = logo.getbbox() if bbox: logo = logo.crop(bbox) logo_h = 0.8 * inch logo_w = logo_h * (logo.width / logo.height) margin = 15 canvas_obj.saveState() canvas_obj.setFillAlpha(0.95) canvas_obj.drawImage(ImageReader(logo), doc.pagesize[0] - logo_w - margin, margin, width=logo_w, height=logo_h, mask='auto', preserveAspectRatio=True) canvas_obj.restoreState() except Exception: pass def export_pdf(heatmap_img, chart_img, summary_md): if heatmap_img is None or not summary_md: return None if isinstance(heatmap_img, np.ndarray): heatmap_img = Image.fromarray(heatmap_img) if chart_img is not None and isinstance(chart_img, np.ndarray): chart_img = Image.fromarray(chart_img) styles = getSampleStyleSheet() tmp_dir = tempfile.gettempdir() pdf_path = os.path.join(tmp_dir, "design_analysis_report.pdf") doc = SimpleDocTemplate(pdf_path, pagesize=letter, topMargin=0.6 * inch, bottomMargin=0.6 * inch, leftMargin=0.7 * inch, rightMargin=0.7 * inch) story = [Paragraph("Design Analyzer Report", styles['Title']), Spacer(1, 12)] max_width = 6.1 * inch heatmap_path = os.path.join(tmp_dir, "heatmap_export_temp.png") heatmap_img.save(heatmap_path) ratio = heatmap_img.height / heatmap_img.width story.append(RLImage(heatmap_path, width=max_width, height=max_width * ratio)) story.append(Spacer(1, 14)) if chart_img is not None: chart_path = os.path.join(tmp_dir, "chart_export_temp.png") chart_img.save(chart_path) chart_ratio = chart_img.height / chart_img.width story.append(RLImage(chart_path, width=max_width, height=max_width * chart_ratio)) story.append(Spacer(1, 14)) story.extend(markdown_to_paragraphs(summary_md, styles)) doc.build(story, onFirstPage=stamp_pdf_watermark, onLaterPages=stamp_pdf_watermark) return pdf_path def draw_scan_path(overlay_bgr, zones, img_h, img_w): img = overlay_bgr.copy() scale = max(1.0, min(img_h, img_w) / 800.0) outer_thickness = int(8 * scale) inner_thickness = int(4 * scale) ordered = sorted(zones, key=lambda z: z["intensity_rank"]) for i in range(len(ordered) - 1): pt1 = (ordered[i]["cx"], ordered[i]["cy"]) pt2 = (ordered[i + 1]["cx"], ordered[i + 1]["cy"]) cv2.arrowedLine(img, pt1, pt2, (0, 0, 0), outer_thickness, tipLength=0.08, line_type=cv2.LINE_AA) cv2.arrowedLine(img, pt1, pt2, (0, 255, 255), inner_thickness, tipLength=0.08, line_type=cv2.LINE_AA) return img def draw_zone_labels(overlay_bgr, zones, img_h, img_w): img = overlay_bgr.copy() scale = max(1.0, min(img_h, img_w) / 800.0) radius = int(22 * scale) font_scale = 0.9 * scale thickness = max(2, int(3 * scale)) for i, z in enumerate(zones, 1): cx, cy = z["cx"], z["cy"] cv2.circle(img, (cx, cy), radius, (255, 255, 255), -1) cv2.circle(img, (cx, cy), radius, (0, 0, 0), thickness) text = str(i) (tw, th), _ = cv2.getTextSize(text, cv2.FONT_HERSHEY_SIMPLEX, font_scale, thickness) cv2.putText(img, text, (cx - tw // 2, cy + th // 2), cv2.FONT_HERSHEY_SIMPLEX, font_scale, (0, 0, 0), thickness, cv2.LINE_AA) return img def flatten_transparency(pil_image): if pil_image.mode in ("RGBA", "LA") or (pil_image.mode == "P" and "transparency" in pil_image.info): rgba = pil_image.convert("RGBA") background = Image.new("RGB", rgba.size, (255, 255, 255)) background.paste(rgba, mask=rgba.split()[-1]) return background return pil_image.convert("RGB") def analyze(pil_image, overlay_strength): if pil_image is None: return None, None, "Upload an image first.", gr.update() pil_rgb = flatten_transparency(pil_image) img_bgr = cv2.cvtColor(np.array(pil_rgb), cv2.COLOR_RGB2BGR) h, w = img_bgr.shape[:2] saliency_map = compute_saliency_map(pil_rgb) overlay_bgr = render_heatmap_overlay(img_bgr, saliency_map, alpha=overlay_strength) scores = compute_attention_scores(saliency_map) zones = identify_hotspots(saliency_map, h, w) read = analyze_readability(pil_rgb) readability_score = compute_readability_score(read) total_score, grade = compute_overall_grade(scores['focus_score'], scores['spread_score'], readability_score) grade_reason = explain_grade(scores['focus_score'], scores['spread_score'], readability_score, read) tips = generate_recommendations(saliency_map, scores, read, h, w) hierarchy_result = compute_hierarchy(read.get('text_sizes', [])) balance_score = compute_balance(saliency_map) hierarchy_score = hierarchy_result[0] if hierarchy_result else None chart_image = create_score_chart(scores['focus_score'], scores['spread_score'], readability_score, hierarchy_score, balance_score) overlay_bgr = draw_scan_path(overlay_bgr, zones, h, w) overlay_bgr = draw_zone_labels(overlay_bgr, zones, h, w) overlay_bgr = draw_issue_markers(overlay_bgr, read.get("issue_boxes", []), h, w) overlay_rgb = cv2.cvtColor(overlay_bgr, cv2.COLOR_BGR2RGB) summary = f"## Grade: {grade} — {total_score}/100\n" summary += f"*Why: {grade_reason}*\n\n" summary += "**Where Attention Goes First:** *(numbers match the image above)*\n" if zones: for i, z in enumerate(zones, 1): summary += f"{i}. {z['position'].replace('-', ' ').title()} ({z['intensity']}/100 intensity, {z['area_pct']}% of design)\n" else: summary += "- Attention is fairly even across the design, no strong single hotspot.\n" summary += ( f"\n**Scores:**\n" f"- Clear Focal Point: {scores['focus_score']}/100 (how strongly attention lands on one main spot, vs scattered everywhere)\n" f"- Attention Coverage: {scores['spread_score']}/100 - {coverage_description(scores['spread_score'])}\n" f"- Readability: " ) if read['words_checked'] == 0: summary += "couldn't be reliably read on this design (common with heavily stylized or hand-lettered fonts) - not included in the score above\n" elif read['contrast_issues'] == 0 and read['small_text_issues'] == 0: summary += "clean, no changes needed\n" else: total_issues = read['contrast_issues'] + read['small_text_issues'] summary += f"{total_issues} easy improvement(s) spotted - see below\n" if read['issue_lines']: summary += "\n**A few examples:**\n" + "\n".join(read['issue_lines']) + "\n" summary += ( "\n*Note: this is automated and can occasionally flag text that's actually fine, " "especially on busy or gradient backgrounds - if something flagged looks perfectly " "readable to your eye, trust your eye.*\n" ) summary += "\n**How to Improve:** *(common and usually quick to fix)*\n" for tip in tips: summary += f"- {tip}\n" summary += "\n**Layout & Composition:** *(based on classic layout principles - hierarchy and balance)*\n" if hierarchy_result: summary += f"- Visual Hierarchy: {hierarchy_description(hierarchy_result[1])}\n" else: summary += "- Visual Hierarchy: not enough distinct text elements to judge\n" summary += f"- Balance: {balance_description(balance_score)}\n" has_price = detect_price_info(read.get('all_words', [])) has_location = detect_location_info(read.get('all_words', [])) summary += ( "\n**Content Checklist:** *(Mike Stevens' classic Who/What/Where/Why/How Much - " "not every design needs all five)*\n" f"- How Much (price): {'found' if has_price else 'not detected - if this design should show a price, double check it'}\n" f"- Where (location/contact): {'found' if has_location else 'not detected - if this design should point somewhere, double check it'}\n" "- Who / What / Why: these need a human read, not automation - ask yourself: is it " "clear who's offering this, exactly what they're offering, and why someone should care?\n" ) summary += ( "\n---\n" "**Methodology:** Attention prediction combines MSI-Net, a peer-reviewed saliency model " "(Kroner et al., *Neural Networks*, 2020, " "[DOI: 10.1016/j.neunet.2020.05.004](https://doi.org/10.1016/j.neunet.2020.05.004)), " "with a size-proportional boost for legible text - since eye-tracking research confirms " "large headline text reliably draws attention, which pure bottom-up saliency models can " "underweight relative to small high-contrast graphics. This is a data-informed prediction, " "not a substitute for live user testing." ) summary += ( "\n\n---\n" "**This tool flags what's off. A designer knows what's right.** " "Haan is a brand identity and visual designer with 12+ years turning " "insights like these into designs that actually convert, stay true to " "your brand, and look intentional (not just \"fixed\").\n\n" "[Visit haanilango.com](https://www.haanilango.com) · Tel: +65 9027 2070" ) result_image = add_watermark(Image.fromarray(overlay_rgb)) chart_image = add_watermark(chart_image, scale=0.26) new_count = increment_count() badge_html = format_count_badge(new_count) if new_count is not None else gr.update() return result_image, chart_image, summary, badge_html with gr.Blocks(title="Design Analyzer") as demo: count_display = gr.HTML(format_count_badge(0)) with gr.Row(): with gr.Column(): image_input = gr.Image(type="pil", label="Upload design") strength_slider = gr.Slider(0.1, 0.8, value=0.45, step=0.05, label="Heatmap overlay strength") analyze_btn = gr.Button("Analyze", variant="primary") with gr.Column(): image_output = gr.Image(label="Heatmap result", interactive=False) chart_output = gr.Image(label="Scores at a glance", interactive=False) with gr.Row(): text_output = gr.Markdown() with gr.Row(): pdf_btn = gr.Button("Download PDF Report") pdf_output = gr.File(label="PDF Report") analyze_btn.click(fn=analyze, inputs=[image_input, strength_slider], outputs=[image_output, chart_output, text_output, count_display]) pdf_btn.click(fn=export_pdf, inputs=[image_output, chart_output, text_output], outputs=pdf_output) demo.load(fn=lambda: format_count_badge(get_current_count()), outputs=count_display) gr.Markdown("---\n© 2026 Haan Ilango. All rights reserved. This tool's methodology and design are original work.") demo.launch()