Skip to content

Yuan1z0825/nature-skills / skills/nature-image2ppt

nature-image2ppt

Flagged

Reconstruct slide images, screenshots, scanned PDFs, or image-only PPTX files as object-level editable PowerPoint. Use for 图片转可编辑PPT、截图还原PPT and diagram reconstruction; not authoring a new deck from research notes.

FileKindSize
.gitignoreother573 B
LICENSEother1.1 KB
README.mdmarkdown4.0 KB
README_EN.mdmarkdown4.3 KB
SKILL.mdskill md9.8 KB
agents/openai.yamlconfig272 B
cli/image2ppt/__init__.pyscript22 B
cli/image2ppt/cli.pyscript698 B
cli/image2ppt/runtime/__init__.pyscript69 B
cli/image2ppt/runtime/_input_normalization.pyscript15.9 KB
cli/image2ppt/runtime/_page_artifacts.pyscript4.5 KB
cli/image2ppt/runtime/build_pptx_from_manifest.pyscript54.0 KB
cli/image2ppt/runtime/configure_image_backend.pyscript5.8 KB
cli/image2ppt/runtime/deck_run_state.pyscript5.6 KB
cli/image2ppt/runtime/deck_text_hints.pyscript6.8 KB
cli/image2ppt/runtime/finalize_deck_run.pyscript3.1 KB
cli/image2ppt/runtime/formula_renderer.pyscript9.6 KB
cli/image2ppt/runtime/image_gen.pyscript37.1 KB
cli/image2ppt/runtime/main.pyscript39.7 KB
cli/image2ppt/runtime/make_page_contact_sheet.pyscript1.1 KB
cli/image2ppt/runtime/paddle_text_hints.pyscript10.7 KB
cli/image2ppt/runtime/page_job_status.pyscript2.1 KB
cli/image2ppt/runtime/page_text_metrics.pyscript11.6 KB
cli/image2ppt/runtime/prepare_deck_run.pyscript7.3 KB
cli/image2ppt/runtime/process_asset_sheet.pyscript6.0 KB
cli/image2ppt/runtime/record_imagegen_result.pyscript5.9 KB
cli/image2ppt/runtime/record_page_dispatch.pyscript2.8 KB
cli/image2ppt/runtime/record_page_result.pyscript4.6 KB
cli/image2ppt/runtime/remove_chroma_key.pyscript13.5 KB
cli/image2ppt/runtime/reset_page_job.pyscript2.6 KB
cli/image2ppt/runtime/runtime_env.pyscript18.8 KB
cli/image2ppt/runtime/split_alpha_components.pyscript9.2 KB
cli/image2ppt/runtime/text_hints.pyscript14.0 KB
cli/image2ppt/runtime/validate_pptx.pyscript38.7 KB
cli/pyproject.tomlmanifest570 B
config.example.yamlconfig1.0 KB
manifest.yamlconfig480 B
prompts/page-worker-base.mdmarkdown7.4 KB
prompts/page-worker.mdmarkdown5.1 KB
references/assets-provenance-contract.mdmarkdown2.9 KB
references/cli-helper.mdmarkdown17.8 KB
references/manifest-arrow-extension.mdmarkdown2.5 KB
references/manifest-schema.mdmarkdown19.9 KB
references/object-routing.mdmarkdown3.4 KB
references/ocr-text-hints-contract.mdmarkdown3.0 KB
references/page-decision-tree.mdmarkdown21.7 KB
references/qa-contract.mdmarkdown5.4 KB
references/region-decomposition.mdmarkdown6.5 KB
references/runtime-dependencies.mdmarkdown2.5 KB
references/workflow.mdmarkdown6.7 KB
requirements.txtmanifest176 B
schemas/page-manifest-v2.schema.jsonconfig2.9 KB
scripts/build_page_worker_prompt.pyscript4.1 KB
scripts/inspect_arrow_atomicity.pyscript7.3 KB
scripts/inspect_region_decomposition.pyscript18.1 KB
scripts/postprocess_manifest_arrows.pyscript18.4 KB
scripts/render_image2ppt_qa.pyscript11.1 KB
scripts/run_final_image2ppt_qa.pyscript9.0 KB
scripts/run_image2ppt_qa.pyscript9.5 KB
scripts/runtime_paths.pyscript4.0 KB
scripts/visual_review_evidence.pyscript5.4 KB
tests/support.pyscript6.4 KB
tests/test_console_portability.pyscript1021 B
tests/test_deck_slide_size.pyscript1.1 KB
tests/test_dispatch_concurrency.pyscript2.9 KB
tests/test_formula_renderer.pyscript4.3 KB
tests/test_independence.pyscript2.2 KB
tests/test_input_normalization_alpha.pyscript2.3 KB
tests/test_input_normalization_opc_targets.pyscript1.9 KB
tests/test_isolated_lifecycle.pyscript9.5 KB
tests/test_manifest_arrows.pyscript8.6 KB
tests/test_migration_parity.pyscript3.2 KB
tests/test_multi_agent_backend.pyscript80.8 KB
tests/test_ocr_http.pyscript16.7 KB
tests/test_paddle_result_url_safety.pyscript3.2 KB
tests/test_page_hints.pyscript10.4 KB
tests/test_path_confinement.pyscript7.5 KB
tests/test_pdf_backend.pyscript4.3 KB
tests/test_project_metadata.pyscript4.7 KB
tests/test_quality_contracts.pyscript9.1 KB
tests/test_region_decomposition.pyscript6.2 KB
tests/test_render_guard.pyscript2.4 KB
tests/test_runtime_config.pyscript2.6 KB
tests/test_runtime_paths.pyscript2.2 KB
tests/test_script_inventory.pyscript2.1 KB
tests/test_slide_layout.pyscript9.3 KB
tests/test_state_e2e.pyscript7.8 KB
tests/test_structure_reconstruction.pyscript12.5 KB
tests/test_thin_profile.pyscript4.0 KB
tests/test_visual_review_evidence.pyscript2.3 KB
tests/test_visual_review_runtime.pyscript2.9 KB

tests/test_slide_layout.py

View on GitHub
import sys
import tempfile
import unittest
from pathlib import Path

from PIL import Image


ROOT = Path(__file__).resolve().parents[1]
RUNTIME_DIR = ROOT / "cli/image2ppt/runtime"
sys.path.insert(0, str(RUNTIME_DIR))

from build_pptx_from_manifest import (  # noqa: E402
    content_box_for_manifest,
    emu,
    normalize_manifest,
    px_to_inches,
    render_preview,
    slide_size_type,
    text_box_xml,
)
from prepare_deck_run import fit_content_box, slide_for_source  # noqa: E402


def scalable_test_font():
    candidates = (
        "C:/Windows/Fonts/arial.ttf",
        "C:/Windows/Fonts/calibri.ttf",
        "C:/Windows/Fonts/msyh.ttc",
        "/System/Library/Fonts/Supplemental/Arial.ttf",
        "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
        "/usr/share/fonts/truetype/liberation2/LiberationSans-Regular.ttf",
    )
    return next((path for path in candidates if Path(path).exists()), None)


def preview_ink_center(manifest):
    with tempfile.TemporaryDirectory() as tmp:
        preview_path = Path(tmp) / "preview.png"
        render_preview(manifest, Path(tmp) / "manifest.json", preview_path)
        image = Image.open(preview_path).convert("RGB")

    dark_pixels = [
        (x, y)
        for y in range(image.height)
        for x in range(image.width)
        if max(image.getpixel((x, y))) < 128
    ]
    if not dark_pixels:
        return None
    xs = [point[0] for point in dark_pixels]
    ys = [point[1] for point in dark_pixels]
    return (min(xs) + max(xs)) / 2, (min(ys) + max(ys)) / 2


class SlideLayoutTest(unittest.TestCase):
    def test_non_wide_source_uses_source_pixel_size(self):
        slide = slide_for_source(1536, 1024)

        self.assertEqual("source", slide["size_mode"])
        self.assertAlmostEqual(16, slide["width"])
        self.assertAlmostEqual(10.6666667, slide["height"])

        box = fit_content_box(1536, 1024, slide)
        self.assertAlmostEqual(0, box["left"])
        self.assertAlmostEqual(0, box["top"])
        self.assertAlmostEqual(slide["width"], box["width"])
        self.assertAlmostEqual(slide["height"], box["height"])

    def test_near_wide_source_snaps_to_standard_wide_without_stretching(self):
        slide = slide_for_source(1918, 1080)

        self.assertEqual("wide", slide["size_mode"])
        self.assertAlmostEqual(13.333, slide["width"])
        self.assertAlmostEqual(7.5, slide["height"])

        box = fit_content_box(1918, 1080, slide)
        self.assertAlmostEqual(7.5, box["height"])
        self.assertGreater(box["left"], 0)
        self.assertLess(box["width"], slide["width"])

    def test_pixel_coordinates_map_to_content_box(self):
        manifest = {
            "source": {"width_px": 1536, "height_px": 1024},
            "slide": {"width": 13.333, "height": 7.5},
        }

        box = content_box_for_manifest(manifest)
        self.assertAlmostEqual(1.0415, box["left"], places=3)
        self.assertAlmostEqual(0, box["top"])
        self.assertAlmostEqual(11.25, box["width"])
        self.assertAlmostEqual(7.5, box["height"])

        position = px_to_inches(manifest, 0, 0, 1536, 1024)
        self.assertAlmostEqual(box["left"], position["left"])
        self.assertAlmostEqual(box["top"], position["top"])
        self.assertAlmostEqual(box["width"], position["width"])
        self.assertAlmostEqual(box["height"], position["height"])

    def test_presentation_size_metadata_uses_valid_ooxml_values(self):
        self.assertEqual("custom", slide_size_type(emu(16), emu(10.6666667)))
        self.assertEqual("screen16x9", slide_size_type(emu(13.333), emu(7.5)))

    def test_text_font_size_is_clamped_to_source_box(self):
        manifest = {
            "source": {"width_px": 1600, "height_px": 900},
            "slide": {"width": 13.333, "height": 7.5},
            "content_box": {"left": 0, "top": 0, "width": 13.333, "height": 7.5},
            "text_boxes": [
                {
                    "text": "Dense label",
                    "box_px": [100, 100, 260, 24],
                    "font_size": 24,
                }
            ],
        }

        normalized = normalize_manifest(manifest)
        text_box = normalized["text_boxes"][0]

        self.assertLess(text_box["font_size"], 24)
        self.assertEqual(24, text_box["_requested_font_size"])

    def test_text_font_size_fit_can_be_disabled(self):
        manifest = {
            "source": {"width_px": 1600, "height_px": 900},
            "slide": {"width": 13.333, "height": 7.5},
            "content_box": {"left": 0, "top": 0, "width": 13.333, "height": 7.5},
            "text_boxes": [
                {
                    "text": "Locked label",
                    "box_px": [100, 100, 260, 24],
                    "font_size": 24,
                    "fit_text": False,
                }
            ],
        }

        normalized = normalize_manifest(manifest)

        self.assertEqual(24, normalized["text_boxes"][0]["font_size"])

    def test_wrapped_text_fit_does_not_force_single_line_width(self):
        manifest = {
            "source": {"width_px": 1600, "height_px": 900},
            "slide": {"width": 13.333, "height": 7.5},
            "content_box": {"left": 0, "top": 0, "width": 13.333, "height": 7.5},
            "text_boxes": [
                {
                    "text": "Long body copy should wrap across multiple natural lines",
                    "box_px": [100, 100, 420, 120],
                    "font_size": 18,
                    "wrap": "square",
                }
            ],
        }

        normalized = normalize_manifest(manifest)

        self.assertGreater(normalized["text_boxes"][0]["font_size"], 10)
        self.assertLessEqual(normalized["text_boxes"][0]["font_size"], 18)

    def test_text_box_alignment_uses_drawingml_enum_values(self):
        xml = text_box_xml(
            2,
            {
                "text": "1",
                "left": 0,
                "top": 0,
                "width": 1,
                "height": 1,
                "align": "center",
                "valign": "middle",
            },
        )

        self.assertIn('algn="ctr"', xml)
        self.assertIn('anchor="ctr"', xml)
        self.assertNotIn('algn="center"', xml)
        self.assertNotIn('anchor="middle"', xml)

    def test_preview_centers_text_inside_its_box(self):
        manifest = {
            "source": {"width_px": 200, "height_px": 200},
            "slide": {"width": 2, "height": 2, "background": "#ffffff"},
            "content_box": {"left": 0, "top": 0, "width": 2, "height": 2},
            "preview_scale": 100,
            "text_boxes": [
                {
                    "text": "1",
                    "box_px": [50, 50, 100, 100],
                    "font_size": 48,
                    "fit_text": False,
                    "color": "#000000",
                    "align": "center",
                    "valign": "middle",
                }
            ],
        }

        ink_center = preview_ink_center(manifest)
        self.assertIsNotNone(ink_center)
        ink_center_x, ink_center_y = ink_center

        self.assertAlmostEqual(100, ink_center_x, delta=5)
        self.assertAlmostEqual(100, ink_center_y, delta=5)

    def test_preview_centers_mixed_size_runs_inside_their_box(self):
        preview_font = scalable_test_font()
        self.assertIsNotNone(preview_font)
        manifest = {
            "source": {"width_px": 200, "height_px": 200},
            "slide": {"width": 2, "height": 2, "background": "#ffffff"},
            "content_box": {"left": 0, "top": 0, "width": 2, "height": 2},
            "preview_scale": 100,
            "text_boxes": [
                {
                    "runs": [
                        {"text": "1", "font_size": 72},
                        {"text": "A", "font_size": 12},
                    ],
                    "box_px": [50, 50, 100, 100],
                    "font_size": 18,
                    "fit_text": False,
                    "preview_font": preview_font,
                    "color": "#000000",
                    "align": "center",
                    "valign": "middle",
                }
            ],
        }

        ink_center = preview_ink_center(manifest)
        self.assertIsNotNone(ink_center)
        ink_center_x, ink_center_y = ink_center

        self.assertAlmostEqual(100, ink_center_x, delta=8)
        self.assertAlmostEqual(100, ink_center_y, delta=8)

    def test_preview_rotates_centered_text_around_the_box_center(self):
        manifest = {
            "source": {"width_px": 200, "height_px": 200},
            "slide": {"width": 2, "height": 2, "background": "#ffffff"},
            "content_box": {"left": 0, "top": 0, "width": 2, "height": 2},
            "preview_scale": 100,
            "text_boxes": [
                {
                    "text": "1",
                    "box_px": [50, 50, 100, 100],
                    "font_size": 48,
                    "fit_text": False,
                    "color": "#000000",
                    "align": "center",
                    "valign": "middle",
                    "rotation": 45,
                }
            ],
        }

        ink_center = preview_ink_center(manifest)
        self.assertIsNotNone(ink_center)
        ink_center_x, ink_center_y = ink_center

        self.assertAlmostEqual(100, ink_center_x, delta=8)
        self.assertAlmostEqual(100, ink_center_y, delta=8)


if __name__ == "__main__":
    unittest.main()
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall