sprite_blit — GFX2D sprite op

• Data kinds: rgba × rgba → rgba

• Call: import fullseye as fs; fs.ledger.sprite_blit(dst, sprite, x=0, y=0, anchor='top_left', flip_x=False, flip_y=False, opacity=1.0) (implementation को सीधे call करना हो तो import gfx2d; gfx2d.sprite_blit(dst, sprite, x=0, y=0, anchor='top_left', flip_x=False, flip_y=False, opacity=1.0), registry से लेना हो तो opsgfx2d.get("sprite_blit"))

उपयोग

sprite को dst की copy पर integer (x, y) पर composite करता है।

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

x is the column and y the row of the sprite's anchor point; anchor is one of "top_left", "top_right", "bottom_left", "bottom_right", "center".

Out-of-bounds behaviour is to clip silently, and that is a decision, not an oversight. Half a sprite hanging off the edge of the screen is the normal case in this family, and raising there would make the common path the exceptional one. A sprite entirely outside returns dst unchanged. The contrast with viewport — which raises for the same situation — is

deliberate: a camera asking for pixels that do not exist is a bug in the caller's arithmetic, a sprite walking off screen is not.

x/y must be integers. Sub-pixel placement changes the picture (it resamples), so it is sprite_transform's job and not a silent rounding here.

संदर्भ (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_transform · sprite_sheet_slice · nine_slice

इसी category के (sprite)

sprite_synthesize · sprite_transform · sprite_sheet_slice · nine_slice


*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.