poisson_blend — COLORTRANSPORT blend op

資料種類:image2d × image2d × maskimage2d

呼叫:import colortransport; colortransport.poisson_blend(src, dst, mask, offset=(0, 0))(或 opscolortransport.get("poisson_blend"))

用法

搬運梯度場的無縫合成(Pérez, Gangnet & Blake, SIGGRAPH 2003)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

`mask の内部で **src の勾配**を保ちつつ、**境界で dst` の値**に

一致する像を解く。よって出力は次の 2 つを構成上満たし、

それが正しさの検算になる:

• 内部のラプラシアンが `src` のラプラシアンと一致(解の残差ぶんまで)

• マスクの外は `dst` と厳密に一致(1 画素も触らない)

貼った物の色は変わる。 それが目的の処理だが、「貼った物体の色を測る」

用途にそのまま流すと測っているのは貼り先の色になる。返り値は

`(blended, info) で、info["changed_pixels"]` と

`info["max_shift"]` が実際にどれだけ動いたかを言う。

Parameters

----------

src : array_like

貼る絵。`(H, W) または (H, W, C)`。

dst : array_like

貼り先。`src` 以上の大きさ。

mask : array_like

`src と同じ (H, W)` の真偽値。縁に接していてはいけない

(境界条件が取れないため明示的に拒否する)。

offset : (int, int)

`dst の中で src の左上を置く (row, col)`。

Returns

-------

(ndarray, dict)

背景知識指南(該運算子背後的物理與規範)

colorimetry — 測色と分光の知識 — 色は「分光 × 光源 × 観測者」でしか決まらない

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者・年份)與用途見上面的族使用指南

可執行的範例(實際呼叫該運算子並已驗證的樣例)

color_transportpy -3.11 examples/color_transport.py

型別可銜接的下一個運算子(可接受 image2d 作為輸入)

histogram_match

同類別(blend)


*Provenance: colortransport.py — COLORTRANSPORT 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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