Класс 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` младшими битами аргумента в порядке слева направо, в поток по текущему битовому смещению в текущей позиции байта.
`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)`	Записывает два байта информации о длине в выходной поток в сетевом порядке байтов, а затем — представление каждого символа в строке `s` в формате изменённого UTF-8.

Методы, объявленные в классе 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 (unsigned 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. Старшие восемь битов каждого символа в строке игнорируются.

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

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

writeChars

public void writeChars(String s) throws IOException

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

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

Указано в:: writeChars в интерфейсе DataOutput
Указано в:: writeChars в интерфейсе ImageOutputStream
Параметры:: s - a String содержащий значение, которое нужно записать.
Выбрасывает:: 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 - a String содержащий значение, которое нужно записать.
Выбрасывает:: UTFDataFormatException - если модифицированное UTF-8 представление s требует более 65536 байтов.; IOException - если произошла ошибка ввода-вывода.

writeShorts

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

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

Записывает последовательность коротких целых чисел в поток по текущей позиции. Если 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 - массив char для записи.; off - начальный смещение в данных.; len - количество char для записи.
Выбрасывает:: IOException - если произошла ошибка ввода-вывода.

writeInts

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

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

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

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

writeLongs

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

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

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

Указано в:: writeLongs в интерфейсе ImageOutputStream
Параметры:: l - массив long для записи.; off - начальный смещение в данных.; len - количество long для записи.
Выбрасывает:: 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 младшими значащими битами аргумента bits в порядке слева направо, в поток в текущей битовой позиции текущей позиции байта. Старшие 64 - numBits биты аргумента игнорируются. Битовый сдвиг увеличивается на numBits и уменьшается по модулю 8. Обратите внимание, что битовый сдвиг 0 всегда указывает на наиболее значимый бит байта, а байты битов записываются последовательно по мере их возникновения. Таким образом, битовые записи всегда выполняются в сетевом порядке байтов. Фактическое значение порядка байтов потока игнорируется.

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

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

flushBits

protected final void flushBits() throws IOException

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

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

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/imageio/stream/ImageOutputStreamImpl.html