Package qupath.lib.images.servers

Interface TileRequestManager

public interface TileRequestManager

Helper class to manage tile requests from an ImageServer.

The purpose of this is to make it possible to identify the 'optimal' regions to request for any particular pixels in the image, based on the resolution levels actually present.

By contrast RegionRequest objects can be used to easily request any pixels at any desired resolution, but this flexibility means that one can easily requests pixels in an inefficient way - or even inadvertently request pixels multiple times (e.g. through rounding errors when requesting pixels at an arbitrary resolution).

Author:

Pete Bankhead

Method Summary

Modifier and Type	Method	Description
Collection<TileRequest>	getAllTileRequests()	Get TileRequest objects for all tiles that this server supports.
TileRequest	getTileRequest(int level, int x, int y, int z, int t)	Get the single TileRequest containing a specified pixel, or null if no such request exists.
Collection<TileRequest>	getTileRequests(RegionRequest request)	Get a collection of TileRequest objects necessary to fulfil a specific RegionRequest.
Collection<TileRequest>	getTileRequestsForLevel(int level)	Get TileRequest objects for all tiles that this server supports at the specified resolution level.

Method Details

getAllTileRequests

Collection<TileRequest> getAllTileRequests()

Get TileRequest objects for all tiles that this server supports.

This should return an exhaustive collection of non-overlapping tiles, such that making requests for each of these would result in every supported pixel (at every resolution) being returned precisely once.

Returns:

getTileRequestsForLevel

Collection<TileRequest> getTileRequestsForLevel(int level)

Get TileRequest objects for all tiles that this server supports at the specified resolution level.

Parameters:

level -

Returns:

getTileRequests

Collection<TileRequest> getTileRequests(RegionRequest request)

Get a collection of TileRequest objects necessary to fulfil a specific RegionRequest.

Parameters:

request -

Returns:

getTileRequest

TileRequest getTileRequest(int level,
 int x,
 int y,
 int z,
 int t)

Get the single TileRequest containing a specified pixel, or null if no such request exists.

Parameters:

level -

x -

y -

z -

t -

Returns: