콘텐츠로 이동

⚔️ Item Asset Forge

Pillow AI Image Gen Sprite Atlas Python Pipeline

📌 프로젝트 개요

Item Asset Forge는 2D/RPG/전술 시뮬레이션 게임에 필요한 아이템 그래픽을 프롬프트 기반으로 대량 생성하고, 후처리(크로마키 배경 투명화, 128/64/32px 정규화, 단일 스프라이트시트 패킹)를 원클릭으로 완료하는 파이썬 기반 에셋 파이프라인입니다.

flowchart LR
    Prompt["텍스트 프롬프트<br/>(예: '전술 단검')"] --> Gen["AI 이미지 생성<br/>(단색 마젠타 배경)"]
    Gen --> Chroma["크로마키 누끼 추출<br/>(32비트 투명 RGBA)"]
    Chroma --> Norm["해상도 정규화<br/>(128x128 / 64x64 / 32x32)"]
    Norm --> Atlas["스프라이트시트 패킹<br/>(atlas.png + mapping.json)"]

💡 바이브코딩 프롬프트 레시피

Chroma Background Isolation Prompt
Tactical combat dagger, matte black titanium blade, serrated edge, carbon fiber grip, 45-degree angle pointing top-right. Rendered on solid pure chroma green (#00FF00) background, sharp edges, game inventory item icon style, no shadows on background, 8-bit rim light.

💻 크로마키 투명화 핵심 파이썬 스크립트

from PIL import Image

def remove_chroma_background(img_path: str, output_path: str, tolerance: int = 40):
    """지정된 크로마 키(순수 녹색/마젠타) 색상을 투명 채널(Alpha 0)로 전환합니다."""
    img = Image.open(img_path).convert("RGBA")
    datas = img.getdata()

    new_data = []
    # 타겟 크로마 그린: RGB(0, 255, 0)
    for item in datas:
        r, g, b, a = item
        if g > 180 and r < 80 and b < 80:
            new_data.append((255, 255, 255, 0))  # 100% 투명
        else:
            new_data.append(item)

    img.putdata(new_data)
    img.save(output_path, "PNG")
    print(f"Alpha transparency applied: {output_path}")

🔗 관련 링크