用给定 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 错误。