java命名空间javax.imageio类imagewriter的类成员方法:
writeinsert定义及介绍
本文导语:
writeinsert
public void writeinsert(int imageindex,
iioimage image,
imagewriteparam param)
throws ioexception
将新的图像插入现有图像流。索引大于 imageindex 的现有图像被保留,其索引均被加 1。为 -1...
writeinsert
public void writeinsert(int imageindex,
iioimage image,
imagewriteparam param)
throws ioexception
- 将新的图像插入现有图像流。索引大于
imageindex
的现有图像被保留,其索引均被加 1。为 -1 的 imageindex
值可用于表示大于以前最大索引的索引;也就是说,它将导致图像按逻辑添加到序列的末尾。如果输出是一个 imageoutputstream
,则整个流都必须是可读并且可写的。
如果 caninsertimage(imageindex)
返回 false
,则将抛出 unsupportedoperationexception
。
可以有选择地提供 imagewriteparam
来控制写入过程。如果 param
为 null
,则将使用默认 write 参数。
如果所提供的 imagewriteparam
包含不受此 writer 支持的可选设置值(例如 逐步编码或任何特定于格式的设置),则将忽略这些设置。
如果输出为 null
,则默认实现抛出 illegalstateexception
,否则抛出 unsupportedoperationexception
。
- 参数:
imageindex
- 将在其所在位置处写入图像的索引。image
- 包含要写入的图像、缩略图和元数据的 iioimage
对象。param
- 一个 imagewriteparam
,或者为 null
,表示使用默认 imagewriteparam
。
- 抛出:
illegalstateexception
- 如果尚未设置输出。
unsupportedoperationexception
- 如果 caninsertimage(imageindex)
返回 false
。
illegalargumentexception
- 如果 image
为 null
。
indexoutofboundsexception
- 如果 imageindex
小于 -1 或大于最大可用索引。
unsupportedoperationexception
- 如果 image
包含一个 raster
,并且 canwriterasters
返回 false
。
ioexception
- 如果在写入过程中发生错误。