MaterialCraft's `crates/image` gained per-axis wrap modes and the texture
read of its function graphs. This adds them to craft-texture so the app
can switch to the crate.
- `get_axes`, `sample_axes` and `sample_nearest_axes` take
`tiling: [bool; 2]`, the wrap mode of `u` and of `v` on their own. With
equal entries they give the same results as `get`, `sample` and
`sample_nearest`, which now call them.
- `sample_stored` rounds the bilinear weights to multiples of 1/256 and
blends by linear interpolation in `f32`. With the image's
integer-sampling flag on, it clamps each channel to 0..=1 and rounds it
to a multiple of 1/65535. A channel whose interpolation is not finite
is taken from the `f64` weighted sum, so finite texels give a finite
sample.
- `with_integer_sampling` and `integer_sampling` set and read the flag.
New images start with it off, clones keep it, and `PartialEq` compares
it.
Image equality no longer short-cuts on a shared buffer. An image holding
NaN compared equal to its clone but unequal to the same image built
again; it is now unequal to both, as f32 comparison gives.
The four weighted texels are summed in f64 and a finite sum is clamped
to the f32 range. Rounded weights can add up to slightly more than 1,
which made a constant image of f32::MAX sample to infinity at some
coordinates. Infinite texels still give an infinite or NaN sample.
The crate docs and README now limit the OutOfMemory guarantee of the
try_ forms to the pixel buffer, and name the Arc and the try_resize
resampler as allocations that are not fallible.
With raised Limits, a gray image over 512 MiB could be converted to
color on wasm32, where the color plane needs more than isize::MAX bytes
and vec! panics with capacity overflow.
- Limits::check returns TooLarge when the byte count is over isize::MAX,
so the try_ forms report the size instead of OutOfMemory.
- map, to_color and to_kind clamp each side to 1..=MAX_SIDE when the
result would be over isize::MAX bytes, and map the top-left part.
- The size checks are pure functions that take the bound as a value, and
three tests check them against the 32-bit bound without allocating.
Adds crates/texture (craft-texture), the first step of RFC-0032
(storytold/craft-contrib#50). The code comes from MaterialCraft
crates/image/src/lib.rs at 31330629, with its six tests unchanged. No app
uses the crate yet.
Changes from the source:
- Image fields are private; from_data checks the size and the buffer
length, so a zero side can no longer reach a panic and a short buffer
is rejected instead of read with defaults.
- Limits caps the side, pixels and bytes; the try_ constructors and
try_map, try_to_kind, try_resize and try_to_rgba8_display reserve
memory first and return an error.
- Repeat sampling reduces the coordinate to its fractional part, so the
period holds at large coordinates.
- Bilinear sampling sums the four weighted texels and skips zero weights;
box shrinking sums in f64.
- generate_uv clamps the size before computing pixel centers.
- linear_to_srgb(NaN) returns NaN.
- rayon is behind the parallel feature.