Read a tile from an image

The single, format-independent tile accessor. Returns a numeric array with dimensions [y, x, band] — always three-dimensional, even for a single band.

Usage

at_tile(
  img,
  level = 0L,
  xrange = NULL,
  yrange = NULL,
  bands = NULL,
  call = rlang::caller_env()
)

Arguments

img

An annot_image.

level

Integer pyramid level. Default 0.

xrange, yrange

Optional integer c(min, max) pixel ranges (1-based, inclusive) at level. NULL (default) means the full extent.

bands

Optional integer band indices. NULL (default) means all bands.

call

The calling environment, for error reporting.

Value

A numeric array with dimensions [y, x, band].

See also

Other images: annotatR-classes, at_bands(), at_dims(), at_example_image(), at_is_pyramidal(), at_is_spectral(), at_meta(), at_n_bands(), at_n_levels(), at_pixel_size(), at_read_image(), at_wavelengths()

Other backends: at_backend_detect(), at_backend_get(), at_backend_list(), at_backend_register(), at_read_image()

Examples

img <- at_example_image("tissue")
dim(at_tile(img, xrange = c(1, 16), yrange = c(1, 16)))
#> [1] 16 16  3