layer_stack — GFX2D composite op

• 資料種類:table → rgba

• 呼叫:import gfx2d; gfx2d.layer_stack(layers)(或 opsgfx2d.get("layer_stack"))

用法

按 z 序合成一列 `rgba` 圖層,自下而上。

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

Each layer is a dict:

`{"image": rgba, "mode": str = "normal", "opacity": float = 1.0}`

and the W3C rule for a blend mode against a *partially transparent* backdrop

is used — the blend function is weighted by the backdrop's own alpha,

`Cs' = (1 - a_b) Cs + a_b B(Cb, Cs)` — so a layer over empty space keeps

its own colour whatever the mode. The result is straight-alpha `rgba`.

All layers must share one shape; see :func:alpha_composite on why.

Raises ValueError: empty list, more than :data:MAX_LAYERS, a non-dict

entry, an unknown key, mismatched shapes.

參考(範例資料・文獻)

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

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

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

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

• gfx2d_scene — py -3.11 examples/gfx2d_scene.py

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

premultiply · alpha_composite · sprite_blit · sprite_transform · sprite_sheet_slice · nine_slice

同類別(composite)

premultiply · unpremultiply · alpha_composite · alpha_composite_premul · blend_mode

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

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