[Core2026] ETC - Mask

마스크와 Scene을 각각 렌더한 뒤 마스크 알파로 합성합니다.

// Canvas target: transparent 16 × 12 ABGR8888 pixels.
// photoPixels: decoded opaque 16 × 12 ABGR8888 pixels.
auto avatar = Scene::gen();
auto photo = Picture::gen();
photo->load(photoPixels, 16, 12, ColorSpace::ABGR8888, true);
auto badge = Shape::gen();
badge->appendCircle(12, 8.5, 2, 2);
badge->fill(35, 160, 100);
avatar->add(photo);
avatar->add(badge);

auto fadeMask = Shape::gen();
fadeMask->appendCircle(8, 5.5, 5, 5);
fadeMask->fill(45, 160, 210, 160);
avatar->mask(fadeMask, MaskMethod::Alpha);
canvas->add(avatar);
canvas->update();
canvas->draw(true);
canvas->sync();

• Paint::mask API
• Mask 구조와 참조 데이터
• 대상 갱신과 마스크 렌더링
• Scene 합성
• CPU Surface 전환·복원

마스크 알파로 Scene 픽셀을 감쇠한 뒤 대상 픽셀과 합성합니다.

q = MULTIPLY(203, 160) = (203 × 160 + 255) >> 8 = 127

// Group opacity is 255 in this example.
auto tmp = ALPHA_BLEND(*src, alpha(cmp));
*dst = tmp + ALPHA_BLEND(*dst, IA(tmp));

• 그룹 합성과 상태 복원
• 직접 이미지 마스킹
• 단색 RLE 마스킹
• 패킹된 ALPHA_BLEND 연산

콘텐츠에 마스크를 적용하는 방식과 마스크끼리 결합하는 방식을 비교합니다.

content->mask(B, method);  // Alpha, InvAlpha, Luma, InvLuma

A->mask(B, method);       // Add, Subtract, Intersect, Difference, Lighten, Darken
content->mask(A, MaskMethod::Alpha);

• MaskMethod API 값
• 마스크 저장 형식 선택
• 마스크 연산과 래스터 분기