用给定 raster 部分替换已出现在输出中的图像部分。图像数据必须匹配,或者可转化为现有图像java开发命名规范总结
iis7站长之家。
可以有选择地提供 imagewriteparam 来控制写入过程。如果 param 为 null,则将使用默认 write 参数。
目标区域是在 param 参数中指定的,并且将被剪切成图像边界和提供给 preparereplacepixels 的区域。至少有一个源像素不能剪切,否则抛出一个异常。
如果所提供的 imagewriteparam 包含不受此 writer 支持的可选设置值(例如 逐步编码或任何特定于格式的设置),则将忽略这些设置。
此方法只能在调用 preparereplacepixels 之后调用,否则将抛出 illegalstateexception。
如果输出为 null,则默认实现抛出 illegalstateexception,否则抛出 unsupportedoperationexception。
- 参数:
raster - 一个包含源像素的 raster。param - 一个 imagewriteparam,或者为 null,表示使用默认 imagewriteparam。
- 抛出:
illegalstateexception - 如果尚未设置输出。
unsupportedoperationexception - 如果 canreplacepixels(imageindex) 返回 false。
illegalstateexception - 如果在以前调用 preparereplacepixels 时没有相应地调用 endreplacepixels。
unsupportedoperationexception - 如果 canwriterasters 返回 false。
illegalargumentexception - 如果以下任意一项为 true:
-
raster 为 null。
-
param 为 null。
- 相交区域并没有包含至少一个像素。
-
raster 的布局与现有图像布局不匹配,或者此 writer 无法将它转换成现有图像布局。
ioexception - 如果在写入期间发生 i/o 错误。