Класс ImageOutputStreamImpl

java.lang.Object

javax.imageio.stream.ImageInputStreamImpl

javax.imageio.stream.ImageOutputStreamImpl

Все реализуемые интерфейсы:: Closeable, DataInput, DataOutput, AutoCloseable, ImageInputStream, ImageOutputStream

Непосредственные известные подклассы:: FileCacheImageOutputStream, FileImageOutputStream, MemoryCacheImageOutputStream

public abstract class ImageOutputStreamImpl extends ImageInputStreamImpl implements ImageOutputStream

Абстрактный класс, реализующий интерфейс ImageOutputStream. Этот класс разработан для сокращения числа методов, которые должны быть реализованы подклассами.

Краткое описание полей

Поля, объявленные в классе javax.imageio.stream.ImageInputStreamImpl

bitOffset, byteOrder, flushedPos, streamPos

Краткое описание конструкторов

Конструктор	Описание
`ImageOutputStreamImpl()`	Создаёт `ImageOutputStreamImpl`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected final void`	`flushBits()`	Если смещение бита не равно нулю, обнуляет оставшиеся биты в текущем байте и перемещает позицию потока на один вперёд.
`void`	`write(byte[] b)`	Записывает последовательность байтов в поток по текущей позиции.
`void`	`writeBit(int bit)`	Записывает один бит, заданный младшим битом аргумента, в поток по текущему битовому смещению в текущей позиции байта.
`void`	`writeBits(long bits, int numBits)`	Записывает последовательность битов, заданных `numBits` младшими битами аргумента `bits` в порядке слева направо, в поток по текущему битовому смещению в текущей позиции байта.
`void`	`writeBoolean(boolean v)`	Записывает значение `boolean` в поток.
`void`	`writeByte(int v)`	Записывает 8 младших битов `v` в поток.
`void`	`writeBytes(String s)`	Записывает строку в выходной поток.
`void`	`writeChar(int v)`	Этот метод является синонимом для `writeShort`.
`void`	`writeChars(char[] c, int off, int len)`	Записывает последовательность символов в поток по текущей позиции.
`void`	`writeChars(String s)`	Записывает строку в выходной поток.
`void`	`writeDouble(double v)`	Записывает значение `double`, состоящее из четырёх байтов, в выходной поток.
`void`	`writeDoubles(double[] d, int off, int len)`	Записывает последовательность чисел с плавающей запятой двойной точности в поток по текущей позиции.
`void`	`writeFloat(float v)`	Записывает значение `float`, состоящее из четырёх байтов, в выходной поток.
`void`	`writeFloats(float[] f, int off, int len)`	Записывает последовательность чисел с плавающей запятой одинарной точности в поток по текущей позиции.
`void`	`writeInt(int v)`	Записывает 32 бита `v` в поток.
`void`	`writeInts(int[] i, int off, int len)`	Записывает последовательность целых чисел в поток по текущей позиции.
`void`	`writeLong(long v)`	Записывает 64 бита `v` в поток.
`void`	`writeLongs(long[] l, int off, int len)`	Записывает последовательность длинных целых чисел в поток по текущей позиции.
`void`	`writeShort(int v)`	Записывает 16 младших битов `v` в поток.
`void`	`writeShorts(short[] s, int off, int len)`	Записывает последовательность коротких целых чисел в поток по текущей позиции.
`void`	`writeUTF(String s)`	Записывает два байта информации о длине в выходной поток в сетевом порядке байтов, за которым следует представление модифицированной UTF-8 каждого символа в строке `s`.

Методы, объявленные в классе javax.imageio.stream.ImageInputStreamImpl

checkClosed, close, finalize, flush, flushBefore, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

Методы, объявленные в классе java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javax.imageio.stream.ImageInputStream

close, flush, getBitOffset, getByteOrder, getFlushedPosition, getStreamPosition, isCached, isCachedFile, isCachedMemory, length, mark, read, read, read, readBit, readBits, readBoolean, readByte, readBytes, readChar, readDouble, readFloat, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readFully, readInt, readLine, readLong, readShort, readUnsignedByte, readUnsignedInt, readUnsignedShort, readUTF, reset, seek, setBitOffset, setByteOrder, skipBytes, skipBytes

Методы, объявленные в интерфейсе javax.imageio.stream.ImageOutputStream

flushBefore, write, write

Подробное описание конструкторов

ImageOutputStreamImpl

public ImageOutputStreamImpl()

Создаёт ImageOutputStreamImpl.

Подробное описание методов

write

public void write(byte[] b) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает последовательность байтов в поток в текущей позиции. Если b.length равно 0, ничего не записывается. Сначала записывается байт b[0], затем байт b[1] и так далее.

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

Указано в:: write в интерфейсе DataOutput
Указано в:: write в интерфейсе ImageOutputStream
Параметры:: b - массив byte, которые нужно записать.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeBoolean

public void writeBoolean(boolean v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает значение boolean в поток. Если v равно true, записывается значение (byte)1; если v равно false, записывается значение (byte)0.

Указано в:: writeBoolean в интерфейсе DataOutput
Указано в:: writeBoolean в интерфейсе ImageOutputStream
Параметры:: v - записываемое значение boolean.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeByte

public void writeByte(int v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает 8 младших битов v в поток. 24 старших бита v игнорируются. (Это означает, что writeByte делает ровно то же самое, что и write для целочисленного аргумента.)

Указано в:: writeByte в интерфейсе DataOutput
Указано в:: writeByte в интерфейсе ImageOutputStream
Параметры:: v - int, содержащий значение байта для записи.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeShort

public void writeShort(int v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает 16 младших битов v в поток. 16 старших битов v игнорируются. Если поток использует сетевой порядок байтов, записанные байты, в порядке, будут:

 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)

В противном случае, записанные байты будут:

 (byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)

Указано в:: writeShort в интерфейсе DataOutput
Указано в:: writeShort в интерфейсе ImageOutputStream
Параметры:: v - int, содержащий значение short для записи.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeChar

public void writeChar(int v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Этот метод является синонимом для writeShort.

Указано в:

writeChar в интерфейсе DataOutput

Указано в:

writeChar в интерфейсе ImageOutputStream

Параметры:

v - int, содержащий значение char (бесзнаковый short) для записи.

Исключение:

IOException - если произошла ошибка ввода-вывода.

См. также:

writeInt

public void writeInt(int v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает 32 бита v в поток. Если поток использует сетевой порядок байтов, записанные байты, в порядке, будут:

 (byte)((v >> 24) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)

В противном случае, записанные байты будут:

 (byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 24) & 0xff)

Указано в:: writeInt в интерфейсе DataOutput
Указано в:: writeInt в интерфейсе ImageOutputStream
Параметры:: v - int, содержащий значение для записи.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeLong

public void writeLong(long v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает 64 бита v в поток. Если поток использует сетевой порядок байтов, записанные байты, в порядке, будут:

 (byte)((v >> 56) & 0xff)
 (byte)((v >> 48) & 0xff)
 (byte)((v >> 40) & 0xff)
 (byte)((v >> 32) & 0xff)
 (byte)((v >> 24) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)(v & 0xff)

В противном случае, записанные байты будут:

 (byte)(v & 0xff)
 (byte)((v >> 8) & 0xff)
 (byte)((v >> 16) & 0xff)
 (byte)((v >> 24) & 0xff)
 (byte)((v >> 32) & 0xff)
 (byte)((v >> 40) & 0xff)
 (byte)((v >> 48) & 0xff)
 (byte)((v >> 56) & 0xff)

Указано в:: writeLong в интерфейсе DataOutput
Указано в:: writeLong в интерфейсе ImageOutputStream
Параметры:: v - long, содержащий значение для записи.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeFloat

public void writeFloat(float v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает значение float, состоящее из четырёх байтов, в выходной поток. Это делается так, как будто сначала это значение float преобразуется в int точно так же, как метод Float.floatToIntBits, а затем значение int записывается точно так же, как метод writeInt.

Указано в:: writeFloat в интерфейсе DataOutput
Указано в:: writeFloat в интерфейсе ImageOutputStream
Параметры:: v - float, содержащий значение для записи.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeDouble

public void writeDouble(double v) throws IOException

Описание, скопированное из интерфейса: ImageOutputStream

Записывает значение double, состоящее из восьми байтов, в выходной поток. Это делается так, как будто сначала это значение double преобразуется в long точно так же, как метод Double.doubleToLongBits, а затем значение long записывается точно так же, как метод writeLong.

Указано в:: writeDouble в интерфейсе DataOutput
Указано в:: writeDouble в интерфейсе ImageOutputStream
Параметры:: v - double, содержащий значение для записи.
Исключение:: IOException - если произошла ошибка ввода-вывода.

writeBytes

public void writeBytes(String s) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает строку в поток вывода. Для каждого символа в строке s, взятом в порядке следования, один байт записывается в поток вывода. Если s равно null, выбрасывается исключение NullPointerException.

Если s.length равно нулю, то байты не записываются. В противном случае, сначала записывается символ s[0], затем s[1] и так далее; последним записывается символ s[s.length-1]. Для каждого символа записывается один байт, младший байт, точно так же, как и в методе writeByte. Старшие восемь битов каждого символа в строке игнорируются.

Указано в:: writeBytes в интерфейсе DataOutput
Указано в:: writeBytes в интерфейсе ImageOutputStream
Параметры:: s - строка, содержащая значение для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeChars

public void writeChars(String s) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает строку в поток вывода. Для каждого символа в строке s, взятом в порядке следования, два байта записываются в поток вывода, в соответствии с текущим порядком байтов. Если используется сетевой порядок байтов, сначала записывается старший байт; в противном случае порядок меняется. Если s равно null, выбрасывается исключение NullPointerException.

Указано в:: writeChars в интерфейсе DataOutput
Указано в:: writeChars в интерфейсе ImageOutputStream
Параметры:: s - строка, содержащая значение для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeUTF

public void writeUTF(String s) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает два байта информации о длине в поток вывода в сетевом порядке байтов, за которыми следует модифицированное представление UTF-8 каждого символа в строке s. Если s равно null, выбрасывается исключение NullPointerException. Каждый символ в строке s преобразуется в группу из одного, двух или трех байтов, в зависимости от значения символа.

Если символ c находится в диапазоне \u0001 по \u007f, он представляется одним байтом:

 (byte)c

Если символ c равен \u0000 или находится в диапазоне \u0080 по \u07ff, то он представляется двумя байтами, которые записываются в указанном порядке:


 (byte)(0xc0 | (0x1f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))

Если символ c находится в диапазоне \u0800 по uffff, то он представляется тремя байтами, которые записываются в указанном порядке:


 (byte)(0xe0 | (0x0f & (c >> 12)))
 (byte)(0x80 | (0x3f & (c >> 6)))
 (byte)(0x80 | (0x3f & c))

Сначала вычисляется общее количество байтов, необходимое для представления всех символов из s. Если это число больше 65535, выбрасывается исключение UTFDataFormatException. В противном случае эта длина записывается в поток вывода точно так же, как и в методе writeShort; после этого записывается представление каждого символа из строки s в один, два или три байта.

Текущий порядок байтов игнорируется.

Примечание: Этот метод не следует использовать при реализации форматов изображений, использующих стандартный UTF-8, поскольку модифицированный UTF-8, используемый здесь, несовместим со стандартным UTF-8.

Указано в:: writeUTF в интерфейсе DataOutput
Указано в:: writeUTF в интерфейсе ImageOutputStream
Параметры:: s - строка, содержащая значение для записи.
Исключения:: UTFDataFormatException - если модифицированное представление UTF-8 для s требует более 65536 байтов.; IOException - если произошла ошибка ввода-вывода.

writeShorts

public void writeShorts(short[] s, int off, int len) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность значений типа short в поток по текущей позиции. Если len равно 0, ничего не записывается. Значение s[off] записывается сначала, затем значение s[off + 1] и так далее. Порядок байтов потока используется для определения порядка записи отдельных байтов.

Указано в:: writeShorts в интерфейсе ImageOutputStream
Параметры:: s - массив значений типа short для записи.; off - начальный смещение в данных.; len - количество значений типа short для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeChars

public void writeChars(char[] c, int off, int len) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность символов в поток по текущей позиции. Если len равно 0, ничего не записывается. Символ c[off] записывается сначала, затем символ c[off + 1] и так далее. Порядок байтов потока используется для определения порядка записи отдельных байтов.

Указано в:: writeChars в интерфейсе ImageOutputStream
Параметры:: c - массив символов для записи.; off - начальный смещение в данных.; len - количество символов для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeInts

public void writeInts(int[] i, int off, int len) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность целых чисел в поток по текущей позиции. Если len равно 0, ничего не записывается. Число i[off] записывается сначала, затем число i[off + 1] и так далее. Порядок байтов потока используется для определения порядка записи отдельных байтов.

Указано в:: writeInts в интерфейсе ImageOutputStream
Параметры:: i - массив целых чисел для записи.; off - начальный смещение в данных.; len - количество целых чисел для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeLongs

public void writeLongs(long[] l, int off, int len) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность длинных целых чисел в поток по текущей позиции. Если len равно 0, ничего не записывается. Число l[off] записывается сначала, затем число l[off + 1] и так далее. Порядок байтов потока используется для определения порядка записи отдельных байтов.

Указано в:: writeLongs в интерфейсе ImageOutputStream
Параметры:: l - массив длинных целых чисел для записи.; off - начальный смещение в данных.; len - количество длинных целых чисел для записи.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeFloats

public void writeFloats(float[] f, int off, int len) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность чисел с плавающей запятой в поток в текущей позиции. Если len равно 0, ничего не записывается. Сначала записывается число с плавающей запятой f[off], затем число f[off + 1] и так далее. Порядок байтов потока используется для определения порядка записи отдельных байтов.

Если битовый сдвиг в потоке не равен нулю, остаток текущего байта заполняется нулями и записывается сначала. Битовый сдвиг будет равен 0 после записи.

Определено в:: writeFloats в интерфейсе ImageOutputStream
Параметры:: f - массив чисел с плавающей запятой, которые необходимо записать.; off - начальный смещение в данных.; len - количество чисел с плавающей запятой, которые нужно записать.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeDoubles

public void writeDoubles(double[] d, int off, int len) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность чисел с двойной точностью в поток в текущей позиции. Если len равно 0, ничего не записывается. Сначала записывается число с двойной точностью d[off], затем число d[off + 1] и так далее. Порядок байтов потока используется для определения порядка записи отдельных байтов.

Определено в:: writeDoubles в интерфейсе ImageOutputStream
Параметры:: d - массив чисел с двойной точностью, которые необходимо записать.; off - начальный смещение в данных.; len - количество чисел с двойной точностью, которые нужно записать.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeBit

public void writeBit(int bit) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает один бит, заданный младшим битом аргумента, в поток в текущей позиции битового сдвига внутри текущей байтовой позиции. Старшие 31 бит аргумента игнорируются. Заданный бит заменяет предыдущий бит в этой позиции. Битовый сдвиг увеличивается на единицу и уменьшается по модулю 8.

Если какие-либо биты конкретного байта никогда не были установлены в момент записи байта в место назначения, эти биты автоматически устанавливаются в 0.

Определено в:: writeBit в интерфейсе ImageOutputStream
Параметры:: bit - целое число, младший бит которого должен быть записан в поток.
Исключения:: IOException - если произошла ошибка ввода-вывода.

writeBits

public void writeBits(long bits, int numBits) throws IOException

Описание скопировано из интерфейса: ImageOutputStream

Записывает последовательность битов, заданную numBits младшими битами аргумента в порядке слева направо, в поток в текущей позиции битового сдвига внутри текущей байтовой позиции. Старшие 64 - numBits биты аргумента игнорируются. Битовый сдвиг увеличивается на numBits и уменьшается по модулю 8. Обратите внимание, что битовый сдвиг 0 всегда указывает на наиболее значимый бит байта, а байты битов записываются последовательно по мере их появления. Таким образом, запись битов всегда выполняется в сетевом порядке байтов. Фактическое значение порядка байтов потока игнорируется.

Данные битов могут накапливаться в памяти неопределённое время, пока не будет вызван flushBefore. В этот момент все данные битов до сброшенной позиции будут записаны.

Определено в:: writeBits в интерфейсе ImageOutputStream
Параметры:: bits - значение типа long, содержащее биты, которые нужно записать, начиная с бита в позиции numBits - 1 и заканчивая младшим битом.; numBits - целое число от 0 до 64 включительно.
Исключения:: IOException - если произошла ошибка ввода-вывода.

flushBits

protected final void flushBits() throws IOException

Если битовый сдвиг не равен нулю, принудительно устанавливает оставшиеся биты в текущем байте в 0 и увеличивает позицию потока на единицу. Этот метод должен вызываться подклассами в начале методов write(int) и write(byte[], int, int).

Исключения:: IOException - если произошла ошибка ввода-вывода.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/imageio/stream/ImageOutputStreamImpl.html