sampledImage
Adds an image sampled at the final physical pixel centers without rounding its geometry to logical pixels.
The immutable image is retained by reference and the rectangles use half-open edges. Nearest sampling maps each covered physical pixel center through the original destination into source. Clipping does not change that mapping. Every normalized source channel, including alpha, is multiplied by the corresponding tint channel. A sample whose multiplied alpha is less than alphaCutoff is discarded before blending. Tint multiplication is not rounded to eight-bit channels before blending. Access uses the owning paint callback's thread and lifetime, just like blitImage. The default implementation rejects this capability so existing paint scopes remain source and binary compatible.
Parameters
the immutable source image.
the nonempty source rectangle contained in the image, in source pixel coordinates.
the nonempty destination in this node's local coordinates.
the multiplicative straight ARGB color, defaulting to opaque white.
the finite inclusive minimum alpha in the range from zero to one.
Throws
when a rectangle is empty, the source is outside image, or the cutoff is invalid.
when the scope is no longer valid.
when the scope has not implemented sampled images.
Adds a sampled image with explicit source-axis directions while keeping both rectangles normalized.
Sampling, tint, clipping, ownership, thread, and callback-lifetime rules are the same as for ordinary sampledImage. Reversed axes exchange the source endpoints before interpolation, preserving nearest-neighbor ties without copying or reversing pixels. The default implementation delegates SampledImageOrientation.Normal to the existing overload and rejects other orientations.
Parameters
the immutable source image retained by reference.
the nonempty source rectangle contained in the image.
the nonempty normalized destination in this node's local coordinates.
source-axis directions, independent of rectangle validation.
the multiplicative straight ARGB color, defaulting to opaque white.
the finite inclusive minimum alpha in the range from zero to one.
Throws
when a rectangle is empty, the source is outside image, or the cutoff is invalid.
when the scope is no longer valid.
when the scope has not implemented the requested sampling orientation.