palette_quantize — GFX2D post op

• 数据种类:rgb → rgb

• 调用: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.

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者・年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• gfx2d_scene — py -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 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

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