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

java.lang. Объект
- java.awt. MultipleGradientPaint
- - java.awt. LinearGradientPaint

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

Краска, Прозрачность
```
public final class LinearGradientPaint
extends MultipleGradientPaint
```
LinearGradientPaint класс обеспечивает способ заполнить a Shape с линейным цветным образцом градиента. Пользователь может определить два или больше цвета градиента, и эта краска обеспечит интерполяцию между каждым цветом. Пользователь также определяет, запускаются и конечные точки, которые определяют, где в пространстве пользователя цветной градиент должен начаться и закончиться.
Пользователь должен предоставить массиву плаваний, определяющих, как распределить цвета вдоль градиента. Эти значения должны колебаться от 0.0 до 1.0 и действие как ключевые кадры вдоль градиента (они отмечают, где градиент должен быть точно определенным цветом).
Когда пользователь не устанавливает первое значение ключевого кадра, равное 0, и/или последний ключевой кадр оценивают равный 1, ключевые кадры будут создаваться в этих позициях, и первые и последние цвета будут тиражированы там. Так, если пользователь определяет следующие массивы, чтобы создать градиент:
```
     {Color.BLUE, Color.RED}, {.3f, .7f}
 
```
это будет преобразовано в градиент со следующими ключевыми кадрами:
```
     {Color.BLUE, Color.BLUE, Color.RED, Color.RED}, {0f, .3f, .7f, 1f}
 
```
Пользователь может также выбрать что действие LinearGradientPaint объект берет, когда он заполняет пространство вне запуска и конечных точек, устанавливая CycleMethod к также REFLECTION или REPEAT. Расстояния между любыми двумя цветами в любой из отраженных или повторных копий градиента являются тем же самым как расстоянием между теми теми же самыми двумя цветами между запуском и конечными точками. Отметьте, что некоторые незначительные изменения в расстояниях могут произойти из-за выборки при гранулярности пикселя. Если никакой метод цикла не определяется, NO_CYCLE будет выбран по умолчанию, что означает, что цвета конечной точки будут использоваться, чтобы заполнить остающуюся область.
colorSpace параметр позволяет пользователю определять, в котором colorspace интерполяция должна быть выполнена, значение по умолчанию sRGB или линеаризовавший RGB.
Следующий код демонстрирует типичное использование LinearGradientPaint:
```
     Point2D start = new Point2D.Float(0, 0);
     Point2D end = new Point2D.Float(50, 50);
     float[] dist = {0.0f, 0.2f, 1.0f};
     Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
     LinearGradientPaint p =
         new LinearGradientPaint(start, end, dist, colors);
 
```
Этот код создаст a LinearGradientPaint который интерполирует между красным и белым для первых 20 % градиента и между белым и синим для остающихся 80 %.
Это изображение демонстрирует пример кода выше для каждого из трех методов цикла:
С тех пор:

1.6

См. Также:
Paint, Graphics2D.setPaint(java.awt.Paint)

Вложенная Сводка Класса
- Вложенные классы/интерфейсы java.awt унаследованный от класса. MultipleGradientPaint
  MultipleGradientPaint.ColorSpaceType, MultipleGradientPaint.CycleMethod

Полевая Сводка
- Поля, наследованные от интерфейса java.awt. Прозрачность
  BITMASK, OPAQUE, TRANSLUCENT

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

Конструкторы
Конструктор и Описание
`LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors)` Конструкции a `LinearGradientPaint` со значением по умолчанию `NO_CYCLE` повторение метода и `SRGB` цветовое пространство.
`LinearGradientPaint(float startX, float startY, float endX, float endY, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `LinearGradientPaint` со значением по умолчанию `SRGB` цветовое пространство.
`LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors)` Конструкции a `LinearGradientPaint` со значением по умолчанию `NO_CYCLE` повторение метода и `SRGB` цветовое пространство.
`LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `LinearGradientPaint` со значением по умолчанию `SRGB` цветовое пространство.
`LinearGradientPaint(Point2D start, Point2D end, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, AffineTransform gradientTransform)` Конструкции a `LinearGradientPaint`.

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

Методы
Модификатор и Тип	Метод и Описание
`PaintContext`	`createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints)` Создает и возвращает a `PaintContext` используемый, чтобы генерировать линейный цветной образец градиента.
`Point2D`	`getEndPoint()` Возвращает копию конечной точки оси градиента.
`Point2D`	`getStartPoint()` Возвращает копию стартовой точки оси градиента.

Методы java.awt унаследованный от класса. MultipleGradientPaint
getColors, getColorSpace, getCycleMethod, getFractions, getTransform, getTransparency

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

- Деталь конструктора
  - LinearGradientPaint
```
public LinearGradientPaint(float startX,
                   float startY,
                   float endX,
                   float endY,
                   float[] fractions,
                   Color[] colors)
```
    Конструкции a LinearGradientPaint со значением по умолчанию NO_CYCLE повторение метода и SRGB цветовое пространство.
    
    Параметры:
    startX - X координат стартовой точки оси градиента в пространстве пользователя
    startY - координата Y стартовой точки оси градиента в пространстве пользователя
    endX - X координат конечной точки оси градиента в пространстве пользователя
    endY - координата Y конечной точки оси градиента в пространстве пользователя
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, соответствующих каждому дробному значению
    
    Броски:
    
    NullPointerException - если fractions массив является нулем, или colors массив является нулем,
    
    IllegalArgumentException - если запускаются, и конечные точки являются теми же самыми точками, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - LinearGradientPaint
```
public LinearGradientPaint(float startX,
                   float startY,
                   float endX,
                   float endY,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a LinearGradientPaint со значением по умолчанию SRGB цветовое пространство.
    
    Параметры:
    startX - X координат стартовой точки оси градиента в пространстве пользователя
    startY - координата Y стартовой точки оси градиента в пространстве пользователя
    endX - X координат конечной точки оси градиента в пространстве пользователя
    endY - координата Y конечной точки оси градиента в пространстве пользователя
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, соответствующих каждому дробному значению
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если запускаются, и конечные точки являются теми же самыми точками, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - LinearGradientPaint
```
public LinearGradientPaint(Point2D start,
                   Point2D end,
                   float[] fractions,
                   Color[] colors)
```
    Конструкции a LinearGradientPaint со значением по умолчанию NO_CYCLE повторение метода и SRGB цветовое пространство.
    
    Параметры:
    start - ось градиента запускается Point2D в пространстве пользователя
    end - конец оси градиента Point2D в пространстве пользователя
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, соответствующих каждому дробному значению
    
    Броски:
    
    NullPointerException - если одна из точек является нулем, или fractions массив является нулем, или colors массив является нулем
    
    IllegalArgumentException - если запускаются, и конечные точки являются теми же самыми точками, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - LinearGradientPaint
```
public LinearGradientPaint(Point2D start,
                   Point2D end,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a LinearGradientPaint со значением по умолчанию SRGB цветовое пространство.
    
    Параметры:
    start - ось градиента запускается Point2D в пространстве пользователя
    end - конец оси градиента Point2D в пространстве пользователя
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, соответствующих каждому дробному значению
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если одна из точек является нулем, или fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если запускаются, и конечные точки являются теми же самыми точками, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - LinearGradientPaint
```
@ConstructorProperties(value={"startPoint","endPoint","fractions","colors","cycleMethod","colorSpace","transform"})
public LinearGradientPaint(Point2D start,
                                              Point2D end,
                                              float[] fractions,
                                              Color[] colors,
                                              MultipleGradientPaint.CycleMethod cycleMethod,
                                              MultipleGradientPaint.ColorSpaceType colorSpace,
                                              AffineTransform gradientTransform)
```
    Конструкции a LinearGradientPaint.
    
    Параметры:
    start - ось градиента запускается Point2D в пространстве пользователя
    end - конец оси градиента Point2D в пространстве пользователя
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, соответствующих каждому дробному значению
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    colorSpace - какое цветовое пространство использовать для интерполяции, также SRGB или LINEAR_RGB
    gradientTransform - преобразуйте, чтобы примениться к градиенту
    
    Броски:
    
    NullPointerException - если одна из точек является нулем, или fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль, или colorSpace нуль, или gradientTransform нуль
    
    IllegalArgumentException - если запускаются, и конечные точки являются теми же самыми точками, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
- Деталь метода
  - createContext
```
public PaintContext createContext(ColorModel cm,
                         Rectangle deviceBounds,
                         Rectangle2D userBounds,
                         AffineTransform transform,
                         RenderingHints hints)
```
    Создает и возвращает a PaintContext используемый, чтобы генерировать линейный цветной образец градиента. См. specification из метода в Paint интерфейс для информации о нулевой обработке параметра.
    
    Параметры:
    cm - привилегированное ColorModel который представляет самый удобный формат для вызывающей стороны, чтобы получить пиксельные данные, или null если нет никакого предпочтения.
    deviceBounds - ограничивающий прямоугольник пространства устройства представляемого графического примитива.
    userBounds - ограничивающий прямоугольник пространства пользователя представляемого графического примитива.
    transform - AffineTransform от пространства пользователя в пространство устройства.
    hints - набор подсказок, что объект контекста может использовать, чтобы выбрать между рендерингом альтернатив.
    
    Возвраты:
    PaintContext для того, чтобы генерировать цветные узоры.
    См. Также:
    Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints
  - getStartPoint
```
public Point2D getStartPoint()
```
    Возвращает копию стартовой точки оси градиента.
    
    Возвраты:
    a Point2D объект, который является копией точки, которая привязывает первый цвет этого LinearGradientPaint
  - getEndPoint
```
public Point2D getEndPoint()
```
    Возвращает копию конечной точки оси градиента.
    
    Возвраты:
    a Point2D объект, который является копией точки, которая привязывает последний цвет этого LinearGradientPaint

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

Класс LinearGradientPaint

Вложенная Сводка Класса

Вложенные классы/интерфейсы java.awt унаследованный от класса. MultipleGradientPaint

Полевая Сводка

Поля, наследованные от интерфейса java.awt. Прозрачность

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

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

Методы java.awt унаследованный от класса. MultipleGradientPaint

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

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

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

LinearGradientPaint

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

createContext

getStartPoint

getEndPoint