nphu0811/pmg-skills

pmg-image-decomposer

Decompose flat raster images, logos, and photographs into structured, reusable LayerTree hierarchies with native vector polygons, transparent raster layers, geometric slices, and automatic reassembly validation for PowerPoint animation.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/nphu0811/pmg-skills --skill pmg-image-decomposer

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

PMG Image Decomposer

pmg-image-decomposer converts flat images into structured, reusable collections of independent visual objects consumable by the canonical PMG engine. Integrated via pmg.image_decomposer.ImageDecomposer and pmg.layers.LayerTree.

Core Decomposition Modes

  1. Mode 1 — Semantic Decomposition:
  • Isolates meaningful brand/visual elements (e.g., Agribank green background, red diagonal bands, white separators, wheat stem and grains).
  • Classifies editability: native_vector (OpenXML <a:custGeom> freeform polygons) vs. raster_layer (transparent PNG).
  • Generates hierarchical grouping (wheat_group -> Grain_01..N).
  1. Mode 2 — Geometric Slicing:
  • Partitions images into geometric segments for shutter, mosaic, tile, and carousel reveals.
  • Patterns: vertical, horizontal, grid, tiles, puzzle, radial / circular_sectors, triangles, custom polygons.
  • Guarantees complete pixel coverage without dropped content.
  1. Mode 3 — Depth Decomposition:
  • Partitions scenes into foreground, midground, and background spatial planes.
  • Supports 2.5D camera parallax and tracking shots.
  • Explicitly flags inferred or inpainted occluded areas.

Reassembly Validation Gate

Every decomposition executes an automatic reassembly verification:

  • Renders reconstructed layers and measures pixel similarity (>= 0.94 tolerance) and contour alignment against the original asset.
  • Reports raster-only vs. vector components.
  • Layer trees with failed reassembly are rejected before PowerPoint compilation.

Native PowerPoint Compilation

Layer trees compile into native PowerPoint objects via pmg.native_objects.compile_layer_tree:

  • Groups become PowerPoint !! group shapes.
  • Native vectors become editable <a:custGeom> shapes with custom paths.
  • Transparent raster segments become positioned and cropped picture shapes.
  • Objects retain stable !! identities across slides for Morph transitions.

Python API Usage

python
from pmg.image_decomposer import ImageDecomposer
from pmg.native_objects import compile_layer_tree
from pmg.layers import LayerTree

decomposer = ImageDecomposer()

# 1. Semantic decomposition
tree = decomposer.decompose(
    source_path="path/to/logo.png",
    output_dir="layers/logo",
    mode="semantic",
    granular=True,
)
assert tree.reassembly["status"] == "PASS"

# 2. Geometric slicing
shutter_tree = decomposer.decompose(
    source_path="path/to/photo.jpg",
    output_dir="layers/shutter",
    mode="geometric",
    pattern="vertical",
    count=8,
)

# 3. Compile to native PowerPoint slide
# slide is a python-pptx Slide object
mapping = compile_layer_tree(slide, tree, bounds=(1.0, 1.5, 11.3, 5.0))
같은 저장소의 Skills

더 많은 Skills

모든 Skills