返回共享此 raster 全部或部分 databuffer 的新 raster。新 raster 拥有对当前 raster 的引用,可以通过其 getparent() 方法进行访问。
parentx、parenty、width 和 height 参数在此 raster 的坐标空间中形成一个 rectangle,指示要共享的像素区域。如果此 rectangle 未包含在当前 raster 的边界内,则抛出错误。
新 raster 可能被平移到与当前 raster 所用坐标系不同的平面坐标系中。childminx 和 childminy 参数给出返回的 raster 左上角像素的新 (x, y) 坐标;新 raster 中的坐标 (childminx, childminy) 将映射到当前 raster 中与坐标 (parentx, parenty) 相同的像素。
可以定义新 raster 只包含当前 raster 的 band 子集,通过 bandlist 参数,可以对该子集重新排序。如果 bandlist 为 null,则将按当前顺序包含 raster 的所有 band。
要创建一个包含当前 raster 子区域,但是共享其坐标系和 band 的新 raster,应该调用此方法,并使 childminx 等于 parentx,childminy 等于 parenty,bandlist 等于 null。
- 参数:
parentx
- 此 raster 坐标空间中左上角的 x 坐标parenty
- 此 raster 坐标空间中左上角的 y 坐标width
- 从 (parentx, parenty) 开始的区域宽度height
- 从 (parentx, parenty) 开始的区域高度。childminx
- 返回的 raster 左上角的 x 坐标childminy
- 返回的 raster 左上角的 y 坐标bandlist
- band 索引数组;如果要使用所有 band,则该参数为 null
- 返回:
- 一个新的
raster
。
- 抛出:
rasterformatexception
- 如果指定的子区域处于 raster 的边界外。
rasterformatexception
- 如果 width
或 height
小于等于 0,或者计算 parentx + width
、parenty + height
、childminx + width
或 childminy + height
导致整数溢出