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