정적 화이트보드 그림을 손그림 애니메이션으로 변환하는 오픈소스 'whiteboard-animator'

정적 스케치를 분석해 획 분해와 채색 순서를 인간 필기 습관대로 재현하고 내레이션 오디오에 맞춰 드로잉 영상을 생성하는 오픈소스 파이썬 엔진 whiteboard-animator를 소개합니다.

tau · 2026년 9월 11일

#whiteboard-animator #오픈소스 #손그림애니메이션 #파이썬 #영상제작 #교육도구

정적 화이트보드 그림을 손그림 애니메이션으로 변환하는 오픈소스 'whiteboard-animator'

정적인 화이트보드 스타일 일러스트레이션이나 스케치 이미지를 입력받아, 사람이 마커펜을 들고 실제로 칠판에 그리는 듯한 손그림 드로잉 비디오로 변환해 주는 오픈소스 파이썬 엔진 'whiteboard-animator'가 공개되었습니다. 교육용 영상, 테크 설명 콘텐츠, 제품 프레젠테이션 제작 시 정적 다이어그램을 동적인 화이트보드 애니메이션으로 손쉽게 전환할 수 있도록 돕는 도구입니다.

정적 화이트보드 스케치를 손그림 애니메이션으로 변환하는 whiteboard-animator 예시 도식화

이미지 출처: Masih Sultani / whiteboard-animator (GitHub)

기존 화이트보드 애니메이션 제작 소프트웨어는 대부분 상용 폐쇄형 플랫폼이거나 수작업 키프레임 설정이 필요해 파이프라인 자동화에 한계가 있었습니다. 이번에 공개된 whiteboard-animator는 정적 이미지를 직접 분석하여 획의 분해부터 텍스트 타이핑, 색상 채색의 순서까지 사람의 실제 필기 습관을 반영한 물리적 드로잉 시퀀스를 프레임 단위로 재구성하는 오픈소스 자동화 솔루션입니다.

정적 이미지 분석과 인간 필기 습관 기반 렌더링

whiteboard-animator의 핵심 기능은 입력된 화이트보드 스타일 이미지의 시각 요소를 분해하고 이를 인간의 자연스러운 필기 흐름으로 재구성하는 렌더링 파이프라인입니다.

  • 획 분해 및 시각 요소 감지: 입력된 이미지 내부의 잉크 자국, 텍스트 라벨, 외곽선 윤곽, 평면 색상 블록을 단계별로 식별합니다. 단순한 마스크 페이드 효과가 아니라, 실제 펜촉이 지나가며 획을 긋는 과정을 프레임 단위로 생성합니다.
  • 인간 필기 습관 모델링: 사람이 실제로 그림을 그릴 때 취하는 자연스러운 순서 규칙을 알고리즘으로 모델링했습니다. 외부 테두리 컨테이너를 먼저 그린 뒤 내부 요소를 배치하고, 도형 윤곽선이 완성된 후 그 안에 라벨 텍스트를 작성하며, V자나 체크 기호 등은 상단 꼭짓점에서 시작하는 필순을 충실히 따릅니다.
  • 색상 채색 시퀀스: 외곽선 드로잉이 완료된 영역부터 순차적으로 마커펜을 채워 넣는 방식을 구현하여 시각적 몰입감을 높였습니다.

오디오 내레이션 동기화와 멀티 클립 파이프라인

단순한 무성 영상 생성을 넘어, 음성 내레이션과의 결합을 고려한 오디오 동기화 기능이 내장되어 있습니다.

  • 오디오 길이 기반 속도 자동 정렬: 내레이션 오디오 파일이 함께 제공되면, 음성의 재생 시간에 맞추어 드로잉 애니메이션의 진행 속도가 자동으로 정렬됩니다. 설명하는 음성 길이에 맞춰 펜의 드로잉 속도가 유기적으로 조절됩니다.
  • 드로잉 완료 후 음성 대기: 드로잉이 먼저 끝나더라도 오디오 설명이 이어지는 경우, 마지막 완성 프레임을 유지하며 음성이 끝날 때까지 대기 상태를 유지합니다.
  • 멀티 클립 시퀀스 결합: 여러 장의 다이어그램 이미지와 각 장에 대응하는 오디오 클립을 순차적으로 연결하여 전체 강의나 프레젠테이션 클립 하나로 완성해 내는 시퀀스 렌더링을 지원합니다.

설치 경로와 최적화 스타일 및 적용 시 유의점

whiteboard-animator는 파이썬 기반의 오픈소스 프로젝트로, 설치와 기존 영상 자동화 워크플로우 연동이 간결합니다.

  • 배포 및 라이선스: MIT 라이선스 기반으로 공개되었으며, PyPI를 통해 whiteboard-animator (버전 0.1.0) 패키지가 공식 배포되어 있어 pip install whiteboard-animator 명령으로 설치 후 파이썬 스크립트나 자동화 파이프라인에 직접 통합할 수 있습니다.
  • 스타일 최적화 범위: 이 도구는 흰색 배경에 마커펜으로 그린 평면 채색 스타일(flat marker illustration) 이미지에 최적화되어 있습니다.
  • 적용 시 한계와 주의점: 실사 사진이나 섬세한 그라데이션, 복잡한 텍스처가 다수 포함된 이미지의 경우 획 분해와 필순 추적이 매끄럽지 않게 렌더링될 수 있으므로, 명확한 외곽선과 단색 채색으로 이루어진 도식화 및 스케치 리소스를 사용하는 것이 권장됩니다.

화이트보드 손그림 애니메이션 제작에 드는 수작업 시간을 절감하고 프로그래밍 방식으로 교육 콘텐츠를 생성하려는 개발자와 크리에이터에게 유용한 도구입니다.

출처