Интерфейс ImageInputStream

Все суперинтерфейсы:: AutoCloseable, Closeable, DataInput

Все известные подинтерфейсы:: ImageOutputStream

Все известные реализующие классы:: FileCacheImageInputStream, FileCacheImageOutputStream, FileImageInputStream, FileImageOutputStream, ImageInputStreamImpl, ImageOutputStreamImpl, MemoryCacheImageInputStream, MemoryCacheImageOutputStream

public interface ImageInputStream
extends DataInput, Closeable

Интерфейс потока ввода с возможностью позиционирования для использования ImageReader. Различные источники ввода, такие как InputStream и File, а также будущие быстрые источники ввода могут быть «обернуты» подходящей реализацией этого интерфейса для использования API ввода-вывода изображений.

См. также:: ImageInputStreamImpl, FileImageInputStream, FileCacheImageInputStream, MemoryCacheImageInputStream

Методы

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает поток.
`void`	`flush()`	Отбрасывает начальную позицию потока до текущей позиции потока.
`void`	`flushBefore(long pos)`	Отбрасывает начальную часть потока до указанной позиции.
`int`	`getBitOffset()`	Возвращает текущий битовый смещение, целое число от 0 до 7 включительно.
`ByteOrder`	`getByteOrder()`	Возвращает порядок байтов, с которым значения данных будут считываться из этого потока, как экземпляр перечисления `java.nio.ByteOrder`.
`long`	`getFlushedPosition()`	Возвращает наираньшую позицию в потоке, до которой может быть выполнено перемещение.
`long`	`getStreamPosition()`	Возвращает текущую байтовую позицию потока.
`boolean`	`isCached()`	Возвращает `true`, если этот `ImageInputStream` кеширует данные для возможности перемещения назад.
`boolean`	`isCachedFile()`	Возвращает `true`, если этот `ImageInputStream` кеширует данные для возможности перемещения назад, и кеш хранится во временном файле.
`boolean`	`isCachedMemory()`	Возвращает `true`, если этот `ImageInputStream` кеширует данные для возможности перемещения назад, и кеш хранится в оперативной памяти.
`long`	`length()`	Возвращает общую длину потока, если она известна.
`void`	`mark()`	Помечает позицию в потоке, к которой будет возвращено последующее обращение к `reset`.
`int`	`read()`	Считывает один байт из потока и возвращает его как целое число от 0 до 255.
`int`	`read(byte[] b)`	Считывает до `b.length` байтов из потока и сохраняет их в `b` начиная с индекса 0.
`int`	`read(byte[] b, int off, int len)`	Считывает до `len` байтов из потока и сохраняет их в `b` начиная с индекса `off`.
`int`	`readBit()`	Считывает один бит из потока и возвращает его как `int`, со значением `0` или `1`.
`long`	`readBits(int numBits)`	Считывает битовую строку из потока и возвращает её как `long`, при этом первый считанный бит становится старшим битом результата.
`boolean`	`readBoolean()`	Считывает байт из потока и возвращает значение `boolean` `true`, если оно ненулевое, `false` если нулевое.
`byte`	`readByte()`	Считывает байт из потока и возвращает его как значение `byte`.
`void`	`readBytes(IIOByteBuffer buf, int len)`	Считывает до `len` байтов из потока и изменяет предоставленный `IIOByteBuffer` для указания массива байтов, смещения и длины, где могут быть найдены данные.
`char`	`readChar()`	Эквивалентно `readUnsignedShort`, за исключением того, что результат возвращается с использованием типа данных `char`.
`double`	`readDouble()`	Считывает 8 байтов из потока, и (понятийно) конкатенирует их в соответствии с текущим порядком байтов и возвращает результат как `double`.
`float`	`readFloat()`	Считывает 4 байта из потока, и (понятийно) конкатенирует их в соответствии с текущим порядком байтов и возвращает результат как `float`.
`void`	`readFully(byte[] b)`	Считывает `b.length` байтов из потока и сохраняет их в `b` начиная с индекса `0`.
`void`	`readFully(byte[] b, int off, int len)`	Считывает `len` байтов из потока и сохраняет их в `b` начиная с индекса `off`.
`void`	`readFully(char[] c, int off, int len)`	Считывает `len` символов (целые 16-битные беззнаковые числа) из потока в соответствии с текущим порядком байтов и сохраняет их в `c` начиная с индекса `off`.
`void`	`readFully(double[] d, int off, int len)`	Считывает `len` чисел с плавающей точкой двойной точности (64-битные числа с плавающей точкой IEEE) из потока в соответствии с текущим порядком байтов и сохраняет их в `d` начиная с индекса `off`.
`void`	`readFully(float[] f, int off, int len)`	Считывает `len` чисел с плавающей точкой одинарной точности (32-битные числа с плавающей точкой IEEE) из потока в соответствии с текущим порядком байтов и сохраняет их в `f` начиная с индекса `off`.
`void`	`readFully(int[] i, int off, int len)`	Считывает `len` целых чисел (целые 32-битные со знаком) из потока в соответствии с текущим порядком байтов и сохраняет их в `i` начиная с индекса `off`.
`void`	`readFully(long[] l, int off, int len)`	Считывает `len` длинных целых чисел (целые 64-битные со знаком) из потока в соответствии с текущим порядком байтов и сохраняет их в `l` начиная с индекса `off`.
`void`	`readFully(short[] s, int off, int len)`	Считывает `len` коротких целых чисел (целые 16-битные со знаком) из потока в соответствии с текущим порядком байтов и сохраняет их в `s` начиная с индекса `off`.
`int`	`readInt()`	Считывает 4 байта из потока, (понятийно) конкатенирует их в соответствии с текущим порядком байтов и возвращает результат как `int`.
`String`	`readLine()`	Считывает следующую строку текста из входного потока.
`long`	`readLong()`	Считывает 8 байтов из потока и (понятийно) конкатенирует их в соответствии с текущим порядком байтов, и возвращает результат как `long`.
`short`	`readShort()`	Считывает два байта из потока, и (понятийно) конкатенирует их в соответствии с текущим порядком байтов, и возвращает результат как значение `short`.
`int`	`readUnsignedByte()`	Считывает байт из потока и (понятийно) преобразует его в целое число, маскирует его `0xff` для удаления каких-либо битов расширения знака и возвращает его как значение `byte`.
`long`	`readUnsignedInt()`	Считывает 4 байта из потока, и (понятийно) конкатенирует их в соответствии с текущим порядком байтов, преобразует результат в длинное целое число, маскирует его `0xffffffffL` для удаления каких-либо битов расширения знака и возвращает результат как беззнаковое значение `long`.
`int`	`readUnsignedShort()`	Считывает два байта из потока, и (понятийно) конкатенирует их в соответствии с текущим порядком байтов, преобразует полученное значение в `int`, маскирует его `0xffff` для удаления каких-либо битов расширения знака и возвращает результат как беззнаковое значение `int`.
`String`	`readUTF()`	Считывает строку, закодированную в формате изменённого UTF-8.
`void`	`reset()`	Возвращает указатель потока к его предыдущей позиции, включая битовое смещение, на момент последнего несоответствующего вызова `mark`.
`void`	`seek(long pos)`	Устанавливает текущую позицию потока в нужное местоположение.
`void`	`setBitOffset(int bitOffset)`	Устанавливает битовое смещение на целое число от 0 до 7 включительно.
`void`	`setByteOrder(ByteOrder byteOrder)`	Устанавливает желаемый порядок байтов для будущих считываний значений данных из этого потока.
`int`	`skipBytes(int n)`	Перемещает позицию потока вперёд на заданное количество байтов.
`long`	`skipBytes(long n)`	Перемещает позицию потока вперёд на заданное количество байтов.

Методы

setByteOrder

void setByteOrder(ByteOrder byteOrder)

Устанавливает желаемый порядок байтов для будущих чтений значений данных из этого потока. Например, последовательность байтов '0x01 0x02 0x03 0x04', если ее читать как 4-байтовое целое число, будет иметь значение '0x01020304' в сетевом порядке байтов и значение '0x04030201' в обратном порядке байтов.

Перечисление java.nio.ByteOrder используется для указания порядка байтов. Значение ByteOrder.BIG_ENDIAN задаёт так называемый порядок байтов «big-endian» или сетевой порядок байтов, в котором старший байт идёт первым. Процессоры Motorola и Sparc хранят данные в этом формате, а процессоры Intel хранят данные в обратном ByteOrder.LITTLE_ENDIAN порядке.

Порядок байтов не влияет на результаты, возвращаемые методом readBits (или значение, записанное методом ImageOutputStream.writeBits).

Параметры:: byteOrder — одно из значений ByteOrder.BIG_ENDIAN или java.nio.ByteOrder.LITTLE_ENDIAN, указывающее, будет ли использоваться сетевой порядок байтов или его обратный порядок для будущих чтений.
См. также:: ByteOrder, getByteOrder(), readBits(int)

getByteOrder

ByteOrder getByteOrder()

Возвращает порядок байтов, с которым значения данных будут читаться из этого потока, как экземпляр перечисления java.nio.ByteOrder.

Возвращает:: Одно из значений ByteOrder.BIG_ENDIAN или ByteOrder.LITTLE_ENDIAN, указывающее, какой порядок байтов используется.
См. также:: ByteOrder, setByteOrder(java.nio.ByteOrder)

read

int read()
  throws IOException

Считывает один байт из потока и возвращает его как целое число от 0 до 255. Если достигнут конец потока, возвращается -1.