[Go 공식문서 한국어 정리] ⓪8. Go의 이미지 합성: image/draw 패키지

[Go 공식문서 한국어 정리] ⓪8. Go의 이미지 합성: image/draw 패키지

원문 제목: The Go image/draw package
작성자: Nigel Tao

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 1. 서론 — 이 문서가 다루는 내용
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Go의 image/draw 패키지는 이미지 합성(compositing)을 위한 핵심 도구입니다.
단 하나의 Draw 연산만으로도 다양한 이미지 조작 작업을 우아하고 효율적으로 수행할 수 있습니다.
Plan 9 그래픽 라이브러리와 X Render 확장의 스타일을 따르며, Porter-Duff의 "Compositing Digital Images" 논문을 기반으로 합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 2. 핵심 개념
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

① Draw 연산 — src를 dst 위에 그리기
image/draw은 단 한 가지 연산만 정의합니다: 소스 이미지(src)를 대상 이미지(dst) 위에 그리는 것입니다.
선택적으로 마스크(mask) 이미지를 적용할 수 있으며, 이를 통해 다양한 효과를 구현합니다.

② Porter-Duff 합성 모델
기본 공식은 dst = (src IN mask) OP dst입니다.
마스크가 완전히 불투명하면 Porter-Duff의 원래 공식인 dst = src OP dst로 단순화됩니다.
Go에서는 nil 마스크가 무한히 큰 불투명 마스크와 동일합니다.

③ Over vs Src — 두 가지 합성 연산자
Over는 소스를 대상 위에 자연스럽게 레이어링하며, 투명도(alpha)를 고려합니다.
Src는 소스를 그대로 복사하며 대상의 원래 내용을 무시합니다.
둘 다 완전히 불투명할 때 결과는 같지만, Src가 일반적으로 더 빠릅니다.

④ 기하학적 정렬 — 사각형과 좌표
합성에는 세 이미지 각각의 사각형 영역이 필요합니다.
Draw 함수는 dst, r(사각형), src, sp(소스 포인트), op(연산자) 다섯 인자를 받습니다.
DrawMask는 마스크와 마스크 포인트를 추가로 받아 총 일곱 인자를 사용합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 3. 주요 내용 상세
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

image/draw 패키지의 핵심은 단순함에 있습니다.
한 개의 Draw 함수로 이미지 복사, 스크롤링, 색상 채우기, 마스킹까지 모두 처리할 수 있습니다.

색상으로 사각형을 채울 때는 image.Uniform을 소스로 사용합니다.
image.Uniform은 하나의 색상을 실질적으로 무한히 큰 이미지로 해석하는 타입입니다.
예를 들어 image.NewRGBA로 생성한 이미지에 파란색을 채우려면 draw.Draw(m, m.Bounds(), &image.Uniform{blue}, image.ZP, draw.Src)를 호출하면 됩니다.

이미지를 투명으로 초기화하려면 image.Transparent를 사용합니다.
이는 alpha 값이 0인 image.Uniform입니다.

이미지 복사는 소스 사각형(sr)을 대상 좌표(dp)로 변환하여 수행합니다.
r := image.Rectangle{dp, dp.Add(sr.Size())}로 대상 사각형을 만들고 draw.Draw(dst, r, src, sr.Min, draw.Src)를 호출합니다.

스크롤링은 이미지 자신에게 복사하는 것입니다.
Go의 내장 copy 함수가 겹치는 슬라이스를 처리하듯, draw도 겹치는 소스와 대상을 안전하게 처리합니다.

마스크를 통한 그리기는 DrawMask 함수로 수행합니다.
원형 마스크를 직접 구현하려면 image.Image 인터페이스를 만족하는 타입을 정의하면 됩니다.
Bounds, ColorModel, At 메서드를 구현하고, 픽셀별로 alpha 값을 계산합니다.

폰트 글리프(glyph)를 그릴 때도 마스크를 활용합니다.
image.Uniform으로 색상 소스를 만들고, image.Alpha 마스크로 글리프 형태를 적용하여 draw.DrawMask를 호출합니다.

성능 최적화를 위해 DrawMask는 인터페이스 타입을 받지만 내부에서 타입 어설션을 수행합니다.
image.RGBA끼리의 복사나 image.Alpha 마스크 적용 같은 일반적인 경우에 특수화된 구현을 사용합니다.
타입 어설션이 실패하면 일반적인 At/Set 메서드를 사용하는 폴백 코드가 실행됩니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 4. 실전 활용 / 예시
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

웹 서비스에서 사용자 업로드 이미지를 썸네일로 변환할 때 image/draw를 활용할 수 있습니다.
GIF나 JPEG, PNG 등 다양한 포맷을 디코딩한 후 image.RGBA로 변환하는 데 필수적입니다.
게임 개발에서 스프라이트 시트에서 특정 영역만 잘라 화면에 그릴 때도 Draw 함수 하나로 해결됩니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 5. 정리
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

image/draw은 단 하나의 Draw 연산으로 이미지 합성의 거의 모든 것을 다룹니다.
Porter-Duff 모델을 기반으로 하며, 마스크와 기하학적 정렬을 통해 유연성을 제공합니다.
성능을 위해 내부적으로 특수화된 구현을 사용하면서도 인터페이스 기반 설계로 확장성을 유지합니다.

📎 출처 링크
https://go.dev/blog/image-draw

#Go #Golang #image #draw #공식문서