This is an automated email from the ASF dual-hosted git repository. desruisseaux pushed a commit to branch geoapi-4.0 in repository https://gitbox.apache.org/repos/asf/sis.git
commit 754a8aa6510332cc629c527aa613dd2b0d4c7dba Author: Martin Desruisseaux <[email protected]> AuthorDate: Mon Mar 28 11:16:19 2022 +0200 Reword the `getResolution()` specification as the resolution at which tiles should be used, not necessarily the actual resolution of data (which may be difficult to evaluate). --- .../org/apache/sis/storage/tiling/TileMatrix.java | 22 +++++++--------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/storage/sis-storage/src/main/java/org/apache/sis/storage/tiling/TileMatrix.java b/storage/sis-storage/src/main/java/org/apache/sis/storage/tiling/TileMatrix.java index 1bfd5de..3d064ab 100644 --- a/storage/sis-storage/src/main/java/org/apache/sis/storage/tiling/TileMatrix.java +++ b/storage/sis-storage/src/main/java/org/apache/sis/storage/tiling/TileMatrix.java @@ -56,24 +56,16 @@ public interface TileMatrix { */ /** - * Returns approximate resolutions (in units of CRS axes) of tiles in this tile matrix. - * The array length shall be the number of CRS dimensions, and value at index <var>i</var> - * is the resolution along CRS dimension <var>i</var> in units of the CRS axis <var>i</var>. - * - * <h4>Grid coverage resolution</h4> + * Returns the resolution (in units of CRS axes) at which tiles in this matrix should be used. * If the tiled data is a {@link org.apache.sis.coverage.grid.GridCoverage}, - * then the resolution is the size of pixels (or cells in the multi-dimensional case). - * If the coverage {@linkplain GridGeometry#getGridToCRS grid to CRS} transform is affine, - * then that pixel size is constant everywhere. - * Otherwise (non-affine transform) the pixel size varies depending on the location - * and the returned value is the pixel size at some representative point, - * typically the coverage center. + * then the resolution is typically the size of pixels in units of CRS axes. + * That resolution may be evaluated at some representative point such as coverage center + * if the pixel size is not constant everywhere. * - * <h4>Vector data resolution</h4> - * If the tiled data is a set of features, then the resolution is a "typical" distance - * (for example the average distance) between points in geometries. + * <p>The array length shall be the number of CRS dimensions, and value at index <var>i</var> + * is the resolution along CRS dimension <var>i</var> in units of the CRS axis <var>i</var>.</p> * - * @return approximate resolutions of tiles. + * @return resolution (in units of CRS axes) at which tiles in this matrix should be used. * * @see GridGeometry#getResolution(boolean) */
