FFmpeg CLI의 복잡한 drawtext 필터 제약을 API 추상화로 해결

Context

FFmpeg CLI의 drawtext 필터는 복잡한 구문과 특수 문자 Escaping 문제로 인해 자동화 파이프라인 구축 시 높은 유지보수 비용을 발생시킴. OS별 폰트 경로 의존성과 수동 Line Wrapping 계산 등 인프라 및 로직 계층의 제약 사항이 명확한 구조임.

Technical Solution

• FFmpeg Micro API를 통한 @text-overlay 가상 옵션 도입으로 복잡한 Filter String 생성을 추상화한 구조 설계
• JSON 기반 파라미터 전달 방식을 통해 특수 문자 Escaping 이슈와 폰트 관리 부담을 서버 사이드에서 해결
• 사전 정의된 9가지 Position Preset과 자동 Word Wrapping 로직을 구현하여 좌표 계산 및 텍스트 분할 프로세스 제거
• API Request 내 Options 배열 구조를 활용하여 Scaling, Encoding 등 다중 Transformation을 단일 호출로 결합한 컴포지션 설계
• FFmpeg Expression 기반의 x, y 좌표 설정을 지원하여 정밀한 픽셀 제어와 추상화된 편의성을 동시에 제공하는 하이브리드 인터페이스 채택