ColorConvertOp (Платформа Java SE 7)

java.lang. Объект
- java.awt.image. ColorConvertOp

Все Реализованные Интерфейсы:

BufferedImageOp, RasterOp
```
public class ColorConvertOp
extends Object
implements BufferedImageOp, RasterOp
```
Этот класс выполняет попиксельное цветное преобразование данных в исходном изображении. Получающиеся значения цвета масштабируются с точностью до целевого изображения. Цветное преобразование может быть определено через массив объектов ColorSpace или массив объектов ICC_Profile.
Если источником является BufferedImage с предварительно умноженной альфой, компоненты цвета делятся на альфа-компонент перед цветным преобразованием. Если местом назначения является BufferedImage с предварительно умноженной альфой, компоненты цвета умножаются на альфа-компонент после преобразования. Растры обрабатываются как не имеющий альфа-канала, то есть все полосы являются цветными полосами.
Если объект RenderingHints определяется в конструкторе, подсказка рендеринга цвета и размывающаяся подсказка могут использоваться, чтобы управлять цветным преобразованием.
Отметьте, что Источник и Место назначения могут быть тем же самым объектом.

См. Также:
RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

Сводка конструктора

Конструкторы
Конструктор и Описание
`ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)` Создает новый ColorConvertOp из двух объектов ColorSpace.
`ColorConvertOp(ColorSpace cspace, RenderingHints hints)` Создает новый ColorConvertOp из объекта ColorSpace.
`ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)` Создает новый ColorConvertOp из массива ICC_Profiles.
`ColorConvertOp(RenderingHints hints)` Создает новый ColorConvertOp, который преобразует от исходного цветового пространства до целевого цветового пространства.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`BufferedImage`	`createCompatibleDestImage(BufferedImage src, ColorModel destCM)` Создает обнуленное целевое изображение с корректным размером и числом полос, учитывая этот источник.
`WritableRaster`	`createCompatibleDestRaster(Raster src)` Создает обнуленный целевой Растр с корректным размером и числом полос, учитывая этот источник.
`BufferedImage`	`filter(BufferedImage src, BufferedImage dest)` ColorConverts источник BufferedImage.
`WritableRaster`	`filter(Raster src, WritableRaster dest)` ColorConverts данные изображения в исходном Растре.
`Rectangle2D`	`getBounds2D(BufferedImage src)` Возвращает ограничивающий прямоугольник места назначения, учитывая этот источник.
`Rectangle2D`	`getBounds2D(Raster src)` Возвращает ограничивающий прямоугольник места назначения, учитывая этот источник.
`ICC_Profile[]`	`getICC_Profiles()` Возвращает массив ICC_Profiles, используемого, чтобы создать этот ColorConvertOp.
`Point2D`	`getPoint2D(Point2D srcPt, Point2D dstPt)` Возвращает расположение пункта назначения, данного точку в источнике.
`RenderingHints`	`getRenderingHints()` Возвращает подсказки рендеринга, используемые этим op.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - ColorConvertOp
```
public ColorConvertOp(RenderingHints hints)
```
    Создает новый ColorConvertOp, который преобразует от исходного цветового пространства до целевого цветового пространства. Параметром RenderingHints может быть нуль. Этот Op может использоваться только с BufferedImages, и преобразует непосредственно из ColorSpace исходного изображения тому из места назначения. Целевой параметр метода фильтра не может быть определен как нуль.
    
    Параметры:
    hints - RenderingHints объект, используемый, чтобы управлять цветным преобразованием, или null
  - ColorConvertOp
```
public ColorConvertOp(ColorSpace cspace,
              RenderingHints hints)
```
    Создает новый ColorConvertOp из объекта ColorSpace. Параметром RenderingHints может быть нуль. Этот Op может использоваться только с BufferedImages, и прежде всего полезен когда filter метод вызывается с целевым параметром нуля. В этом случае ColorSpace определяет целевое цветовое пространство для места назначения, создаваемого методом фильтра. Иначе, ColorSpace определяет промежуточное пространство, в которое источник преобразовывается прежде, чем быть преобразованным в целевое пространство.
    
    Параметры:
    cspace - определяет место назначения ColorSpace или промежуточное звено ColorSpace
    hints - RenderingHints объект, используемый, чтобы управлять цветным преобразованием, или null
    
    Броски:
    
    NullPointerException - если cspace является нулем
  - ColorConvertOp
```
public ColorConvertOp(ColorSpace srcCspace,
              ColorSpace dstCspace,
              RenderingHints hints)
```
    Создает новый ColorConvertOp из двух объектов ColorSpace. Параметром RenderingHints может быть нуль. Этот Op прежде всего полезен для вызова метода фильтра на Растрах, когда два ColorSpaces определяют работу, которая будет выполняться на Растрах. В этом случае число полос в исходном Растре должно соответствовать число компонентов в srcCspace, и число полос в целевом Растре должно соответствовать число компонентов в dstCspace. Для BufferedImages два ColorSpaces определяют промежуточные пробелы, через которые источник преобразовывается прежде, чем быть преобразованным в целевое пространство.
    
    Параметры:
    srcCspace - источник ColorSpace
    dstCspace - место назначения ColorSpace
    hints - RenderingHints объект, используемый, чтобы управлять цветным преобразованием, или null
    
    Броски:
    
    NullPointerException - если или srcCspace или dstCspace являются нулем
  - ColorConvertOp
```
public ColorConvertOp(ICC_Profile[] profiles,
              RenderingHints hints)
```
    Создает новый ColorConvertOp из массива ICC_Profiles. Параметром RenderingHints может быть нуль. Последовательность профилей может включать профили, которые представляют цветовые пространства, профили, которые представляют эффекты и т.д. Если целая последовательность не представляет четко определенное цветное преобразование, исключение выдается.
    Для BufferedImages, если ColorSpace источника BufferedImage не соответствует требования первого профиля в массиве, первое преобразование к соответствующему ColorSpace. Если требования последнего профиля в массиве не удовлетворяются ColorSpace места назначения Баффередимэджа, последнее преобразование к ColorSpace места назначения.
    Для Растров число полос в исходном Растре должно соответствовать требования первого профиля в массиве, и число полос в целевом Растре должно соответствовать требования последнего профиля в массиве. У массива должно быть по крайней мере два элемента, или вызов метода фильтра для Растров бросит IllegalArgumentException.
    
    Параметры:
    profiles - массив ICC_Profile объекты
    hints - RenderingHints объект, используемый, чтобы управлять цветным преобразованием, или null
    
    Броски:
    
    IllegalArgumentException - когда последовательность профиля не определяет четко определенное цветное преобразование
    
    NullPointerException - если профили являются нулем
- Деталь метода
  - getICC_Profiles
```
public final ICC_Profile[] getICC_Profiles()
```
    Возвращает массив ICC_Profiles, используемого, чтобы создать этот ColorConvertOp. Нуль возвратов, если ColorConvertOp не был создан из такого массива.
    
    Возвраты:
    массив ICC_Profile объекты этого ColorConvertOp, или null если это ColorConvertOp не был создан с массивом ICC_Profile объекты.
  - фильтр
```
public final BufferedImage filter(BufferedImage src,
                   BufferedImage dest)
```
    ColorConverts источник BufferedImage. Если целевое изображение будет нулем, то BufferedImage будет создаваться с соответствующим ColorModel.
    
    Определенный:
    
    filter в интерфейсе BufferedImageOp
    
    Параметры:
    src - источник BufferedImage быть преобразованным
    dest - место назначения BufferedImage, или null
    
    Возвраты:
    dest цвет, преобразованный из src или новое, преобразованный BufferedImage если dest null
    
    Броски:
    
    IllegalArgumentException - если dest является нулем, и этот op был создан, используя конструктора, который берет только параметр RenderingHints, так как работа плохо определяется.
  - фильтр
```
public final WritableRaster filter(Raster src,
                    WritableRaster dest)
```
    ColorConverts данные изображения в исходном Растре. Если целевой Растр будет нулем, то новый Растр будет создаваться. Число полос в источнике и целевых Растров должно удовлетворить требования, объясненные выше. Конструктор, используемый, чтобы создать этот ColorConvertOp, должно быть, предоставил достаточную информацию, чтобы определить и источник и целевые цветовые пространства. См. выше. Иначе, исключение выдается.
    
    Определенный:
    
    filter в интерфейсе RasterOp
    
    Параметры:
    src - источник Raster быть преобразованным
    dest - место назначения WritableRaster, или null
    
    Возвраты:
    dest цвет, преобразованный из src или новое, преобразованный WritableRaster если dest null
    
    Броски:
    
    IllegalArgumentException - если число источника или целевых полос является неправильным, источник или целевые цветовые пространства неопределены, или этот op был создан с одним из конструкторов, который применяется только к операциям на BufferedImages.
  - getBounds2D
```
public final Rectangle2D getBounds2D(BufferedImage src)
```
    Возвращает ограничивающий прямоугольник места назначения, учитывая этот источник. Отметьте, что это будет тем же самым как ограничивающий прямоугольник источника.
    
    Определенный:
    
    getBounds2D в интерфейсе BufferedImageOp
    
    Параметры:
    src - источник BufferedImage
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник места назначения учитывая указанное src
  - getBounds2D
```
public final Rectangle2D getBounds2D(Raster src)
```
    Возвращает ограничивающий прямоугольник места назначения, учитывая этот источник. Отметьте, что это будет тем же самым как ограничивающий прямоугольник источника.
    
    Определенный:
    
    getBounds2D в интерфейсе RasterOp
    
    Параметры:
    src - источник Raster
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник места назначения учитывая указанное src
  - createCompatibleDestImage
```
public BufferedImage createCompatibleDestImage(BufferedImage src,
                                      ColorModel destCM)
```
    Создает обнуленное целевое изображение с корректным размером и числом полос, учитывая этот источник.
    
    Определенный:
    
    createCompatibleDestImage в интерфейсе BufferedImageOp
    
    Параметры:
    src - Исходное изображение для работы фильтра.
    destCM - ColorModel места назначения. Если ноль, будет использоваться соответствующий ColorModel.
    
    Возвраты:
    a BufferedImage с корректным размером и числом полос от указанного src.
    
    Броски:
    
    IllegalArgumentException - если destCM null и это ColorConvertOp создавался ни с кем ICC_Profile или ColorSpace определенный для места назначения
  - createCompatibleDestRaster
```
public WritableRaster createCompatibleDestRaster(Raster src)
```
    Создает обнуленный целевой Растр с корректным размером и числом полос, учитывая этот источник.
    
    Определенный:
    
    createCompatibleDestRaster в интерфейсе RasterOp
    
    Параметры:
    src - указанное Raster
    
    Возвраты:
    a WritableRaster с корректным размером и числом полос от указанного src
    
    Броски:
    
    IllegalArgumentException - если это ColorConvertOp создавался без достаточной информации, чтобы определить dst и src цветовые пространства
  - getPoint2D
```
public final Point2D getPoint2D(Point2D srcPt,
                 Point2D dstPt)
```
    Возвращает расположение пункта назначения, данного точку в источнике. Если dstPt ненуль, он будет использоваться, чтобы содержать возвращаемое значение. Отметьте, что для этого класса, пункт назначения будет тем же самым как исходной точкой.
    
    Определенный:
    
    getPoint2D в интерфейсе BufferedImageOp
    
    Определенный:
    
    getPoint2D в интерфейсе RasterOp
    
    Параметры:
    srcPt - указанный источник Point2D
    dstPt - место назначения Point2D
    
    Возвраты:
    dstPt после установки его расположения, чтобы быть тем же самым как srcPt
  - getRenderingHints
```
public final RenderingHints getRenderingHints()
```
    Возвращает подсказки рендеринга, используемые этим op.
    
    Определенный:
    
    getRenderingHints в интерфейсе BufferedImageOp
    
    Определенный:
    
    getRenderingHints в интерфейсе RasterOp
    
    Возвраты:
    RenderingHints объект этого ColorConvertOp

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ColorConvertOp

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

ColorConvertOp

ColorConvertOp

ColorConvertOp

ColorConvertOp

Деталь метода

getICC_Profiles

фильтр

фильтр

getBounds2D

getBounds2D

createCompatibleDestImage

createCompatibleDestRaster

getPoint2D

getRenderingHints