返回包含图像流中原始像素数据的新 raster
对象,不应用任何颜色转换。应用程序必须确定如何通过其他方法解释像素数据。所提供的 imagereadparam
对象中的任何 destination 或 image-type 参数都被忽略,但其他所有参数的使用与 read
方法完全相同,唯一的不同在于所有的目标偏移量被用作逻辑偏移量而不是物理偏移量。所返回的 raster
的大小将始终是裁剪为实际图像的源区域大小。忽略流自身中的逻辑偏移量。
此方法允许使用通常应用颜色转换的格式(比如 jpeg)以及通常没有关联颜色空间的格式(比如遥感数据或医学成像数据)来提供对原始像素数据的访问。
所有已注册的 readupdatelistener
都被忽略,因为没有 bufferedimage
,但会调用其他所有侦听器,就像将它们用于 read
方法那样。
如果 canreadraster()
返回 false
,则此方法抛出 unsupportedoperationexception
。
如果所提供的 imagereadparam
包含不受此 reader 支持的可选设置值(例如 源呈现大小或任何特定于格式的设置),则将忽略这些设置。
默认的实现抛出 unsupportedoperationexception
。
- 参数:
imageindex
- 要读取的图像的索引。param
- 用来控制读取过程的 imagereadparam
,或者为 null
。
- 返回:
raster
形式的所需图像部分。
- 抛出:
unsupportedoperationexception
- 如果此插件不支持读取原始 raster
。
illegalstateexception
- 如果输入源尚未设置。
indexoutofboundsexception
- 如果所提供的索引超出范围。
ioexception
- 如果在读取过程中发生错误。- 另请参见:
canreadraster()
,
read(int)
,
raster