将单幅图像、可能相关的元数据和缩略图添加到输出中。如果输出是 imageoutputstream
,则可能刷新当前寻找位置之前的输出的现有内容,并且这些内容不必是可读的或可写的,除非插件必须能够在调用 endwritesequence
时修补头信息(例如 tiff)。
如果 canwritesequence
返回 false
,则此方法将抛出 unsupportedoperationexception
。
必须使用 setoutput
方法提前设置输出。
preparewritesequence
必须提前调用,否则将抛出 illegalstateexception
。
如果 canwriterasters
返回 true
,则 iioimage
可以包含一个 raster
源。否则,它必须包含一个 renderedimage
源。
所提供的缩略图将被重新调整大小(如果需要),并且超过所支持数量的所有缩略图都将被忽略。如果该格式需要没有提供的其他缩略图,则 writer 将在内部生成这些缩略图。
可以有选择地提供 imagewriteparam
来控制写入过程。如果 param
为 null
,则将使用默认 write 参数。
如果所提供的 imagewriteparam
包含不受此 writer 支持的可选设置值(例如 逐步编码或任何特定于格式的设置),则将忽略这些设置。
如果输出为 null
,则默认实现抛出 illegalstateexception
,否则抛出 unsupportedoperationexception
。
- 参数:
image
- 包含要写入的图像、缩略图和元数据的 iioimage
对象。param
- 一个 imagewriteparam
;或者为 null
,表示使用默认 imagewriteparam
。
- 抛出:
illegalstateexception
- 如果没有设置输出,或者没有调用 preparewritesequence
。
unsupportedoperationexception
- 如果 canwritesequence
返回 false
。
illegalargumentexception
- 如果 image
为 null
。
unsupportedoperationexception
- 如果 image
包含一个 raster
,并且 canwriterasters
返回 false
。
ioexception
- 如果写入过程中发生错误。