palette_quantize — GFX2D post op

데이터 종류: rgbrgb

호출: import gfx2d; gfx2d.palette_quantize(rgb, colors=None, scheme='okabe_ito')(또는 opsgfx2d.get("palette_quantize"))

사용법

각 화소를 RGB 유클리드 거리로 가장 가까운 팔레트 색에 대응시킵니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

`colors is an (K, 3) array or a list of :mod:palette` role names;

the default is the whole Okabe–Ito set plus black and white, so the result

stays legible under a colour vision deficiency.

The search is exhaustive, so the assignment is optimal for this metric

and each pixel's error equals its distance to the nearest palette entry —

there is no approximation to bound. The suite checks optimality by brute

force and checks that an image whose colours already lie in the palette

comes back unchanged, bit for bit.

Euclidean distance in (possibly sRGB-encoded) RGB is not perceptual

distance. That is a documented choice, not an oversight: a perceptual metric

needs a colour-appearance model this module does not own, and quantising in

an unstated space would be worse than quantising in a stated one.

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

gfx2d_scenepy -3.11 examples/gfx2d_scene.py

타입이 이어지는 다음 연산자(rgb 를 입력으로 받는 것)

srgb_to_linear · linear_to_srgb · blend_mode · light_mask · normal_map_decode · bloom · vignette · chromatic_aberration

같은 카테고리(post)

bloom · vignette · chromatic_aberration · film_grain · color_lut · color_grade · dither


*Provenance: gfx2d.py — GFX2D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.