将单幅图像、可能相关的元数据和缩略图添加到输出中。如果输出是 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 - 如果写入过程中发生错误。