Transform an ROI between pyramid levels using real image dimensions

Unlike at_roi_rescale() (which assumes a power-of-two pyramid), this uses the actual level dimensions of an annot_image, so it is exact for pyramids with any downsampling ratio.

Usage

at_transform(roi, from_level, to_level, img, call = rlang::caller_env())

Arguments

roi

An annot_roi.

from_level, to_level

Integer source and target pyramid levels.

img

The annot_image whose pyramid defines the level dimensions.

call

The calling environment, for error reporting.

Value

An annot_roi with coordinates at to_level. Exactly invertible.

See also

at_roi_rescale()

Other geometry: at_check_containment(), at_check_geometry(), at_clamp(), at_fix_geometry(), at_flip_y(), at_roi_buffer(), at_roi_contains(), at_roi_distance(), at_roi_overlaps(), at_roi_rescale(), at_roi_ring(), at_roi_setops, at_roi_simplify(), at_rois_overlap(), at_snap()

Examples

img <- at_example_image("multiplex")
r <- at_roi_rect(0, 0, 100, 100, label = "a")
at_transform(r, from_level = 0, to_level = 2, img = img)
#> <annot_roi> a (POLYGON)
#> id: "roi_000000079"  |  level: 2  |  source: manual
#> bbox: [0, 0] - [25, 25]