Spec-Zone .ru
спецификации, руководства, описания, API
|
|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class IIOParam extends Object
ImageReadParam и ImageWriteParam. Этот класс обеспечивает механизмы, чтобы определить исходную область и целевую область. Читая, источник является потоком, и изображение в памяти является местом назначения. При записи они инвертируются. В случае записи целевые области могут использоваться только с писателем, который поддерживает пиксельную замену.
Подвыборка десятикратного уменьшения может быть определена и для читателей и для писателей, используя подвижную сетку подвыборки.
Подмножества источника и целевых полос могут быть выбраны.
| Модификатор и Тип | Поле и Описание |
|---|---|
protected IIOParamController |
контроллер
IIOParamController это будет использоваться, чтобы обеспечить настройки для этого IIOParam возразите когда activateController метод вызывают. |
protected IIOParamController |
defaultController
Значение по умолчанию
IIOParamController это будет использоваться, чтобы обеспечить настройки для этого IIOParam возразите когда activateController метод вызывают. |
protected Point |
destinationOffset
Смещение в месте назначения, куда верхний левый декодируемый пиксель должен быть помещен.
|
protected ImageTypeSpecifier |
destinationType
ImageTypeSpecifier чтобы использоваться, чтобы генерировать целевое изображение, читая, или установить вывод красят тип при записи. |
protected int[] |
sourceBands
Массив
ints указание, какие исходные полосы будут использоваться, или null. |
protected Rectangle |
sourceRegion
Исходная область, на
null если ни один не устанавливается. |
protected int |
sourceXSubsampling
Подвыборка десятикратного уменьшения, которая будет применена в горизонтальном направлении.
|
protected int |
sourceYSubsampling
Подвыборка десятикратного уменьшения, которая будет применена в вертикальном направлении.
|
protected int |
subsamplingXOffset
Горизонтальное смещение, которое будет применено к сетке подвыборки перед подвыборкой.
|
protected int |
subsamplingYOffset
Вертикальное смещение, которое будет применено к сетке подвыборки перед подвыборкой.
|
| Модификатор | Конструктор и Описание |
|---|---|
protected |
IIOParam()
Защищенного конструктора могут вызвать только подклассы.
|
| Модификатор и Тип | Метод и Описание |
|---|---|
boolean |
activateController()
Активирует установленный
IIOParamController для этого IIOParam возразите и возвращает получающееся значение. |
IIOParamController |
getController()
Возвраты вообще
IIOParamController в настоящий момент устанавливается. |
IIOParamController |
getDefaultController()
Возвращает значение по умолчанию
IIOParamController, если есть один, независимо от в настоящий момент установленного контроллера. |
Точка |
getDestinationOffset()
Возвращает смещение в целевом изображении, в которое должны быть помещены пиксели.
|
ImageTypeSpecifier |
getDestinationType()
Возвращает тип изображения, которое будет возвращено чтением, если Вы были установлены звонком
setDestination(ImageTypeSpecifier), как ImageTypeSpecifier. |
int[] |
getSourceBands()
Возвращает набор исходных полос, которые будут использоваться.
|
Прямоугольник |
getSourceRegion()
Возвращает исходную область, которая будет использоваться.
|
int |
getSourceXSubsampling()
Возвращает число исходных столбцов, чтобы совершенствоваться для каждого пикселя.
|
int |
getSourceYSubsampling()
Возвращает число строк, чтобы совершенствоваться для каждого пикселя.
|
int |
getSubsamplingXOffset()
Возвращает горизонтальное смещение сетки подвыборки.
|
int |
getSubsamplingYOffset()
Возвращает вертикальное смещение сетки подвыборки.
|
boolean |
hasController()
Возвраты
true если есть контроллер, установленный для этого IIOParam объект. |
void |
setController(IIOParamController controller)
Наборы
IIOParamController использоваться, чтобы обеспечить настройки для этого IIOParam возразите когда activateController метод вызывают, переопределяя любой контроллер по умолчанию. |
void |
setDestinationOffset(Point destinationOffset)
Определяет смещение в целевом изображении, в которое будущее декодируемые пиксели должны быть помещены, читая, или где область будет записана при записи.
|
void |
setDestinationType(ImageTypeSpecifier destinationType)
Устанавливает требуемый тип изображения для целевого изображения, используя
ImageTypeSpecifier. |
void |
setSourceBands(int[] sourceBands)
Устанавливает индексы исходных полос, которые будут использоваться.
|
void |
setSourceRegion(Rectangle sourceRegion)
Устанавливает исходную область интереса.
|
void |
setSourceSubsampling(int sourceXSubsampling, int sourceYSubsampling, int subsamplingXOffset, int subsamplingYOffset)
Определяет подвыборку десятикратного уменьшения, чтобы применяться на вводе-выводе.
|
protected Rectangle sourceRegion
null если ни один не устанавливается.protected int sourceXSubsampling
1. Значение не должно быть отрицательным или 0.protected int sourceYSubsampling
1. Значение не должно быть отрицательным или 0.protected int subsamplingXOffset
protected int subsamplingYOffset
protected int[] sourceBands
ints указание, какие исходные полосы будут использоваться, или null. Если null, набор исходных полос, которые будут использоваться, как описывается в комментарии для setSourceBands метод. Никакому значению нельзя позволить быть отрицательным.protected ImageTypeSpecifier destinationType
ImageTypeSpecifier чтобы использоваться, чтобы генерировать целевое изображение, читая, или установить вывод красят тип при записи. Если не был setm, значение будет null. По умолчанию значение null.protected Point destinationOffset
protected IIOParamController defaultController
IIOParamController это будет использоваться, чтобы обеспечить настройки для этого IIOParam возразите когда activateController метод вызывают. Это значение по умолчанию должно быть установлено подклассами, которые хотят обеспечивать их собственный контроллер по умолчанию, обычно GUI, для того, чтобы установить параметры.protected IIOParamController controller
IIOParamController это будет использоваться, чтобы обеспечить настройки для этого IIOParam возразите когда activateController метод вызывают. Это значение переопределяет любой контроллер по умолчанию, даже когда нуль.protected IIOParam()
public void setSourceRegion(Rectangle sourceRegion)
setSourceSubsampling. Если подвыборка была установлена так, что, это число является нулем, IllegalStateException будет брошен. Исходная область интереса, определенного этим методом, будет отсечена как необходимый соответствовать в пределах исходных границ, так же как целевых смещений, ширины, и высоты во время фактического ввода-вывода.
Значение null для sourceRegion удалит любую спецификацию области, заставляя все изображение использоваться.
sourceRegion - a Rectangle определение исходной области интереса, или null.IllegalArgumentException - если sourceRegion не -null и также sourceRegion.x или sourceRegion.y отрицательно.IllegalArgumentException - если sourceRegion не -null и также sourceRegion.width или sourceRegion.height отрицательно или 0.IllegalStateException - если подвыборка будет так, что этой областью, то будет иметь подвыбранную ширину или высоту нуля.getSourceRegion(), setSourceSubsampling(int, int, int, int), setDestinationOffset(java.awt.Point), getDestinationOffset()public Rectangle getSourceRegion()
setSourceRegion, и будет null если нет никакого набора области.Rectangle, или null.setSourceRegion(java.awt.Rectangle)public void setSourceSubsampling(int sourceXSubsampling,
int sourceYSubsampling,
int subsamplingXOffset,
int subsamplingYOffset)
sourceXSubsampling и sourceYSubsampling параметры определяют период подвыборки (то есть, число строк и столбцов, чтобы совершенствоваться после каждого исходного пикселя). Определенно, период 1 будет использовать каждую строку или столбец; период 2 будет использовать любую строку или столбец. subsamplingXOffset и subsamplingYOffset параметры определяют смещение от области (или изображение) источник для первого подвыбранного пикселя. Корректировка источника поддемонстрационной сетки полезна для ухода от швов, когда подвыборка очень большое исходное изображение в целевые области, которые будут собраны в полное подвыбранное изображение. Большинство пользователей будет хотеть просто оставить эти параметры в 0. Число пикселей и растровых строк, которые будут использоваться, вычисляется следующим образом.
Числом подвыбранных пикселей в растровой строке дают
truncate[(width - subsamplingXOffset + sourceXSubsampling - 1) / sourceXSubsampling].
Если область является так, что этой шириной, нуль, IllegalStateException бросается.
Число растровых строк, которые будут использоваться, может быть вычислено так же.
Возможность установить сетку подвыборки, чтобы запуститься где-нибудь кроме исходного источника области полезна, если область используется, чтобы создать подвыбранные мозаики большого изображения, где ширина мозаики и высота не являются сетью магазинов периодов подвыборки. Если сетка подвыборки не остается непротиворечивой от мозаики до мозаики, будут артефакты на границах мозаики. Корректируя смещение сетки подвыборки для каждой мозаики, чтобы компенсировать, этих артефактов можно избежать. Компромисс - то, что, чтобы избежать этих артефактов, мозаики не являются всеми одинаковыми размер. Смещением сетки, чтобы использовать в этом случае дают:
смещение сетки = [период - (смещение области период по модулю)] период по модулю)
Если также sourceXSubsampling или sourceYSubsampling 0 или отрицательно, IllegalArgumentException будет брошен.
Если также subsamplingXOffset или subsamplingYOffset отрицательно или больше чем или равен соответствующему периоду, IllegalArgumentException будет брошен.
Есть нет unsetSourceSubsampling метод; просто вызовите setSourceSubsampling(1, 1, 0, 0) восстановить значения по умолчанию.
sourceXSubsampling - число столбцов, чтобы совершенствоваться между пикселями.sourceYSubsampling - число строк, чтобы совершенствоваться между пикселями.subsamplingXOffset - горизонтальное смещение первой подвыборки в пределах области, или в пределах изображения, если никакая область не устанавливается.subsamplingYOffset - горизонтальное смещение первой подвыборки в пределах области, или в пределах изображения, если никакая область не устанавливается.IllegalArgumentException - если или период отрицателен или 0, или если или смещение сетки отрицательно или больше чем соответствующий период.IllegalStateException - если бы исходная область является так, что подвыбранным выводом, не содержал бы пикселей.public int getSourceXSubsampling()
Если setSourceSubsampling не был вызван, 1 возвращается (который является корректным значением).
setSourceSubsampling(int, int, int, int), getSourceYSubsampling()public int getSourceYSubsampling()
Если setSourceSubsampling не был вызван, 1 возвращается (который является корректным значением).
setSourceSubsampling(int, int, int, int), getSourceXSubsampling()public int getSubsamplingXOffset()
Если setSourceSubsampling не был вызван, 0 возвращается (который является корректным значением).
setSourceSubsampling(int, int, int, int), getSubsamplingYOffset()public int getSubsamplingYOffset()
Если setSourceSubsampling не был вызван, 0 возвращается (который является корректным значением).
setSourceSubsampling(int, int, int, int), getSubsamplingXOffset()public void setSourceBands(int[] sourceBands)
A null значение указывает, что все исходные полосы будут использоваться.
Во время чтения, IllegalArgumentException будет брошен читателем или писателем, если значение, больше чем самый большой доступный исходный индекс полосы, было определено или если число исходных полос и целевых полос, которые будут использоваться, отличается. ImageReader.checkReadParamBandSettings метод может использоваться, чтобы автоматизировать этот тест.
Семантически, копия делается из массива; изменения к содержанию массива, последующему за этим вызовом, не имеют никакого эффекта на это IIOParam.
sourceBands - массив целочисленных индексов полосы, которые будут использоваться.IllegalArgumentException - если sourceBands содержит отрицательное или двойное значение.getSourceBands(), ImageReadParam.setDestinationBands(int[]), ImageReader.checkReadParamBandSettings(javax.imageio.ImageReadParam, int, int)public int[] getSourceBands()
setSourceBands, или null если не было никаких звонков setSourceBands. Семантически, массив возвратился, копия; изменения, чтобы выстроить содержание, последующее за этим вызовом, не имеют никакого эффекта на это IIOParam.
null.setSourceBands(int[])public void setDestinationType(ImageTypeSpecifier destinationType)
ImageTypeSpecifier. Читая, если расположение места назначения было установлено, используя этот метод, каждый звонок ImageReader
read метод возвратит новое BufferedImage использование формата определяется предоставленным спецификатором типа. Как побочный эффект, любое место назначения BufferedImage установленный ImageReadParam.setDestination(BufferedImage) больше не будет установлен как место назначения. Другими словами этот метод может считаться вызовом setDestination((BufferedImage)null).
При записи, целевой тип, возможно используемый, чтобы определить цветной тип изображения. SampleModel информация будет проигнорирована, и может быть null. Например, 4 соединенное изображение могло представить или CMYK или данные RGBA. Если целевой тип устанавливается, ColorModel переопределит любого ColorModel на изображении непосредственно. Это крайне важно когда setSourceBands используется начиная с изображения ColorModel обратится ко всему изображению, а не к подмножеству записанных полос.
destinationType - ImageTypeSpecifier использоваться, чтобы определить целевое расположение и цветной тип.getDestinationType()public ImageTypeSpecifier getDestinationType()
setDestination(ImageTypeSpecifier), как ImageTypeSpecifier. Если ни один не был установлен, null возвращается.ImageTypeSpecifier описание целевого типа, или null.setDestinationType(javax.imageio.ImageTypeSpecifier)public void setDestinationOffset(Point destinationOffset)
Читая, область, которая будет записана в пределах места назначения BufferedImage запустится при этом смещении и иметь ширину и высоту, определенную исходной областью интереса, параметров подвыборки, и целевых границ.
На нормальные записи не влияет этот метод, только пишет выполняемое использование ImageWriter.replacePixels. Для таких записей определенное смещение в пределах изображения потока вывода, пиксели которого изменяются.
Есть нет unsetDestinationOffset метод; просто вызовите setDestinationOffset(new Point(0, 0)) восстановить значения по умолчанию.
destinationOffset - смещение в месте назначения, как a Point.IllegalArgumentException - если destinationOffset null.getDestinationOffset(), ImageWriter.replacePixels(java.awt.image.RenderedImage, javax.imageio.ImageWriteParam)public Point getDestinationOffset()
Если setDestinationOffsets не был вызван, a Point с нулем X и Y значения возвращаются (который является корректным значением).
Point.setDestinationOffset(java.awt.Point)public void setController(IIOParamController controller)
IIOParamController использоваться, чтобы обеспечить настройки для этого IIOParam возразите когда activateController метод вызывают, переопределяя любой контроллер по умолчанию. Если параметр null, никакой контроллер не будет использоваться, включая никакое значение по умолчанию. Чтобы восстановить значение по умолчанию, использовать setController(getDefaultController()).controller - Соответствующее IIOParamController, или null.IIOParamController, getController(), getDefaultController(), hasController(), activateController()public IIOParamController getController()
IIOParamController в настоящий момент устанавливается. Это могло быть значением по умолчанию, если есть один, null, или параметр нового звонка setController.IIOParamController, или null.IIOParamController, setController(javax.imageio.IIOParamController), getDefaultController(), hasController(), activateController()public IIOParamController getDefaultController()
IIOParamController, если есть один, независимо от в настоящий момент установленного контроллера. Если нет никакого контроллера по умолчанию, возвратов null.IIOParamController, или null.IIOParamController, setController(IIOParamController), getController(), hasController(), activateController()public boolean hasController()
true если есть контроллер, установленный для этого IIOParam объект. Это возвратится true если getController не возвратился бы null.true если контроллер устанавливается.IIOParamController, setController(IIOParamController), getController(), getDefaultController(), activateController()public boolean activateController()
IIOParamController для этого IIOParam возразите и возвращает получающееся значение. Когда этот метод возвращается true, все значения для этого IIOParam объект будет готов к следующей операции чтения или операции записи. Если false возвращается, никакие настройки в этом объекте не будут нарушены (то есть, пользователь, отмененный работа). Обычно, контроллер будет GUI, обеспечивающим пользовательский интерфейс для подкласса IIOParam для определенного плагина. Контроллеры не должны быть GUI, как бы то ни было.
true если контроллер обычно завершался.IllegalStateException - если нет никакого контроллера, в настоящий момент установленного.IIOParamController, setController(IIOParamController), getController(), getDefaultController(), hasController()
Для дальнейшей ссылки API и документации разработчика, см. . Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.