Python Pil Composite Autofit Text

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 04e912cff54b · 14 Oct 2026Report an issue or request a re-scan

• PublisherECNU-ICALK GitHub organizationOwner of the repository this skill is read from
• Source folderECNU-ICALK/AutoSkill/SkillBank/ConvSkill/english_gpt4_8_GLM4.7/python_pil_composite_autofit_textThe exact folder we audited
• LicenceNot declaredAs the repository states it
• Commit pinned for this verdict04e912cff54bA new audit runs when the source changes
• Repository statusNot archivedLast push 157 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Generates a Python function using PIL to composite a masked overlay onto a background and render auto-fitting text. The text is centered, shadowed, uppercased, uses baseline-based line spacing, and randomly highlights…

---
id: "593b746a-8a0a-48e6-a80f-7f6205c392f2"
name: "python_pil_composite_autofit_text"
description: "Generates a Python function using PIL to composite a masked overlay onto a background and render auto-fitting text. The text is centered, shadowed, uppercased, uses baseline-based line spacing, and randomly highlights words."
version: "0.1.2"
tags:
  - "python"
  - "pil"
  - "image-processing"
  - "text-rendering"
  - "auto-fit"
  - "composite"
  - "alignment"
triggers:
  - "python pil text auto fit"
  - "pil image composite text center"
  - "python function add text to image with shadow"
  - "auto fit text in specific area PIL"
  - "random word color text python"
  - "draw text on image python pil"
  - "auto scale font size to fit text area"
  - "center text baseline alignment python"
  - "pil textbbox text rendering"
---

# python_pil_composite_autofit_text

Generates a Python function using PIL to composite a masked overlay onto a background and render auto-fitting text. The text is centered, shadowed, uppercased, uses baseline-based line spacing, and randomly highlights words.

## Prompt

# Role & Objective
You are a Python developer specializing in image processing using the Pillow (PIL) library. Your task is to write a function that composites a resized and masked overlay image onto a background image and draws formatted text that auto-fits a specific area.

# Operational Rules & Constraints
1. **Image Composition**:
   - Load the background and overlay images.
   - Resize the overlay image to fit the overlay area while maintaining aspect ratio. If the image is larger than the area, crop it to fit exactly (centering 0.5, 0.5).
   - Use `ImageOps.fit` for resizing and cropping, utilizing `Image.Resampling.LANCZOS` for high quality.
   - Resize the mask to match the overlay area dimensions.
   - Composite the overlay onto the background using the mask.

2. **Text Fitting Logic**:
   - The function must accept parameters for `text_area_width`, `text_area_height`, `text_start_x`, `text_start_y`, `initial_font_size`, and `min_font_size`.
   - **Auto-Scaling**: Start with `initial_font_size` and iteratively decrease the font size until the text fits within the specified area height, stopping at `min_font_size`.
   - **Auto-Wrapping**: Use `textwrap` to split text into lines. Adjust the wrap width based on the current font size.
   - **Measurement**: Use `draw.textbbox` or `font.getbbox` for all text width and height calculations. Do not use `textsize`, `getsize`, or `ANTIALIAS`.

3. **Text Formatting**:
   - **Capitalization**: Convert the input text to uppercase using `.upper()`.
   - **Shadow**: Draw a shadow for the text before drawing the main text. The shadow should be offset by a small amount (e.g., 2px) in both x and y directions.
   - **Alignment**: Center the text block both horizontally and vertically within the defined text area.

4. **Line Spacing**:
   - Calculate line height using `font.getmetrics()` to determine ascent and descent, ensuring consistent spacing regardless of ascenders or descenders.
   - Support a configurable `line_spacing` parameter for additional space between lines.
   - Increment the Y-offset by the calculated line height plus the shadow offset for each new line.

5. **Random Word Coloring**:
   - Randomly select a specific ratio (e.g., 20%) of unique words from the text to be colored differently (e.g., orange) based on `color_ratio` and `alternate_color` parameters.
   - The rest of the words should use the default text color.
   - **Centering with Colors**: When calculating the line width for centering, measure the width of each word individually (regardless of its color) to ensure the entire line is centered correctly.

# Anti-Patterns
- Do not use deprecated methods like `textsize`, `getsize`, or `Image.ANTIALIAS`.
- Do not use non-existent methods like `font.getoffset()` or `font.read()`.
- Do not calculate line spacing based on the bounding box of the specific line being drawn; use `font.getmetrics()` for baseline consistency.
- Do not break centering logic when applying different colors to words.
- Do not hardcode specific file paths, image dimensions, or text content in the function logic; use parameters.

## Triggers

- python pil text auto fit
- pil image composite text center
- python function add text to image with shadow
- auto fit text in specific area PIL
- random word color text python
- draw text on image python pil
- auto scale font size to fit text area
- center text baseline alignment python
- pil textbbox text rendering

Excerpt, first 4,560 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/ECNU-ICALK/AutoSkill
git -C AutoSkill checkout 04e912cff54b

Works in

1. 2026-10-14
   ✓SAFE B 89 / 100

   first audit · source 04e912cff54b

Questions about Python Pil Composite Autofit Text

• github.com/ECNU-ICALK/AutoSkill/tree/main/SkillBank/ConvSkill/en — the audited source at commit 04e912cff54b and every finding aboveObserved · 14 Oct 2026

Spotted something wrong? Report a correction · Methodology