particle_render — GFX2D particle op

• Data kinds: table → rgba

• Call: import fullseye as fs; fs.ledger.particle_render(state, height, width, mode='add', fade=True) (implementation को सीधे call करना हो तो import gfx2d; gfx2d.particle_render(state, height, width, mode='add', fade=True), registry से लेना हो तो opsgfx2d.get("particle_render"))

उपयोग

particle state को rgba image में splat करता है।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Each particle is a radially symmetric (1 - (r/R)^2)^2 kernel of radius size, weighted by its alpha and, when fade is set, by the remaining fraction of its life (1 - age/life). Particles past their lifetime contribute nothing.

mode is "add" (premultiplied additive — what a spark does; the result is clipped at 1 and the clipped energy is *not* returned) or "over" (each particle composited in array order, which is what a soft smoke puff does).

Pure function of the state: no randomness enters here, so two calls on the same state produce identical bytes.

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• gfx2d_scene — py -3.11 examples/gfx2d_scene.py

वे अगले ops जिनसे type जुड़ता है (rgba को input के रूप में लेते हैं)

premultiply · alpha_composite · sprite_blit · sprite_transform · sprite_sheet_slice · nine_slice

इसी category के (particle)

particle_emit · particle_step


*Provenance: gfx2d.py — GFX2D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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