GradientTexturePaint

java.lang.Object
- com.bric.awt.GradientTexturePaint

All Implemented Interfaces:

Paint, Transparency
```
public class GradientTexturePaint
extends Object
implements Paint
```
A linear gradient based on a java.awt.TexturePaint.
This goes to extra lengths to reduce color banding more than Java's default gradient implementation, and is generally comparable in performance.

See Also:

Gradients: Avoiding Color Banding, Gradients: a Boring Discussion

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
`static class`	`GradientTexturePaint.Cycle`

Field Summary

Fields

Modifier and Type	Field and Description
`protected Color[]`	`colors`
`protected GradientTexturePaint.Cycle`	`cycle`
`protected float[]`	`fractions`
`protected boolean`	`hasAlpha`
`protected boolean`	`needsDiffusion`
`protected static boolean`	`seedingEnabled` This is an advanced option only used for testing/debugging.
`protected AffineTransform`	`transform`
`protected float`	`x1`
`protected float`	`x2`
`protected float`	`y1`
`protected float`	`y2`

Fields inherited from interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT

Constructor Summary

Constructors

Constructor and Description
`GradientTexturePaint(Color[] colors, float[] fractions, float x1, float y1, float x2, float y2, GradientTexturePaint.Cycle cycle)` Creates a new `GradientTexturePaint`.
`GradientTexturePaint(Color[] colors, float[] fractions, Point2D p1, Point2D p2, GradientTexturePaint.Cycle cycle)` Creates a new `GradientTexturePaint`.
`GradientTexturePaint(float x1, float y1, Color c1, float x2, float y2, Color c2)` Create a 2-color gradient using `Cycle.NONE`.

Method Summary

All Methods

Static Methods

Instance Methods

Concrete Methods
Modifier and Type	Method and Description
`protected static boolean`	`containsAlpha(Color[] colors)` Return true if any of these colors are not opaque.
`PaintContext`	`createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)`
`Color[]`	`getColors()` Return the colors in this gradient.
`float[]`	`getFractions()` Return the fractions in this gradient.
`int`	`getTransparency()` Return `Transparency.OPAQUE` if all the colors in this gradient are opaque, otherwise this returns `Transparency.TRANSLUCENT`.
`static boolean`	`needsDiffusion(Color[] colors, float[] fractions, float x1, float y1, float x2, float y2)` Return true if this combination of colors and fractions should apply error diffusion prevent color banding.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - seedingEnabled
```
protected static boolean seedingEnabled
```
    This is an advanced option only used for testing/debugging.
  - colors
```
protected Color[] colors
```
  - cycle
```
protected GradientTexturePaint.Cycle cycle
```
  - fractions
```
protected float[] fractions
```
  - hasAlpha
```
protected boolean hasAlpha
```
  - needsDiffusion
```
protected boolean needsDiffusion
```
  - transform
```
protected AffineTransform transform
```
  - x1
```
protected float x1
```
  - y1
```
protected float y1
```
  - x2
```
protected float x2
```
  - y2
```
protected float y2
```
- Constructor Detail
  - GradientTexturePaint
```
public GradientTexturePaint(float x1,
                            float y1,
                            Color c1,
                            float x2,
                            float y2,
                            Color c2)
```
    Create a 2-color gradient using Cycle.NONE.
    
    Parameters:
    
    x1 - the x-coordinate of first point
    
    y1 - the y-coordinate of first point
    
    c1 - the first color
    
    x2 - the x-coordinate of second point
    
    y2 - the y-coordinate of second point
    
    c2 - the second color
  - GradientTexturePaint
```
public GradientTexturePaint(Color[] colors,
                            float[] fractions,
                            float x1,
                            float y1,
                            float x2,
                            float y2,
                            GradientTexturePaint.Cycle cycle)
```
    Creates a new GradientTexturePaint.
    
    Parameters:
    
    colors - the colors to use in this gradient.
    
    fractions - the fractions to use in this gradient. These must be ascending fractions from [0,1]. Each fraction corresponds to a color.
    
    x1 - the x-value of the first coordinate.
    
    y1 - the y-value of the first coordinate.
    
    x2 - the x-value of the second coordinate.
    
    y2 - the y-value of the second coordinate.
    
    cycle - TILE is recommended for best performance.
  - GradientTexturePaint
```
public GradientTexturePaint(Color[] colors,
                            float[] fractions,
                            Point2D p1,
                            Point2D p2,
                            GradientTexturePaint.Cycle cycle)
```
    Creates a new GradientTexturePaint.
    
    Parameters:
    
    colors - the colors to use in this gradient.
    
    fractions - the fractions to use in this gradient. These must be ascending fractions from [0,1]. Each fraction corresponds to a color.
    
    p1 - the first point.
    
    p2 - the second point.
    
    cycle - TILE is recommended for best performance.
- Method Detail
  - containsAlpha
```
protected static boolean containsAlpha(Color[] colors)
```
    Return true if any of these colors are not opaque.
    
    Parameters:
    
    colors - the colors to check for alpha components
    
    Returns:
    
    true if any of the colors in the argument are not fully opaque.
  - needsDiffusion
```
public static boolean needsDiffusion(Color[] colors,
                                     float[] fractions,
                                     float x1,
                                     float y1,
                                     float x2,
                                     float y2)
```
    Return true if this combination of colors and fractions should apply error diffusion prevent color banding.
    
    Parameters:
    
    colors - the colors to use in this gradient.
    
    fractions - the fractions to use in this gradient. These must be ascending fractions from [0,1]. Each fraction corresponds to a color.
    
    x1 - the x-value of the first coordinate.
    
    y1 - the y-value of the first coordinate.
    
    x2 - the x-value of the second coordinate.
    
    y2 - the y-value of the second coordinate.
    
    Returns:
    
    true if the gradient the arguments described should apply error diffusion to prevent color banding.
    
    See Also:
    
    Gradients: Avoiding Color Banding
  - createContext
```
public PaintContext createContext(ColorModel cm,
                                  Rectangle deviceBounds,
                                  Rectangle2D userBounds,
                                  AffineTransform xform,
                                  RenderingHints hints)
```
  - getColors
```
public Color[] getColors()
```
    Return the colors in this gradient. Each color corresponds to a value in {link #getFractions()}.
    
    Returns:
    
    the colors in this gradient.
  - getFractions
```
public float[] getFractions()
```
    Return the fractions in this gradient. Each fraction corresponds to a value in {link #getColors()}.
    
    Returns:
    
    the fractions in this gradient.
  - getTransparency
```
public int getTransparency()
```
    Return Transparency.OPAQUE if all the colors in this gradient are opaque, otherwise this returns Transparency.TRANSLUCENT.
    
    Specified by:
    
    getTransparency in interface Transparency
    
    Returns:
    
    the transparency of this gradient.

Class GradientTexturePaint

Nested Class Summary

Nested Classes

Field Summary

Fields

Fields inherited from interface java.awt.Transparency

Constructor Summary

Constructors

Method Summary

Methods inherited from class java.lang.Object

Field Detail

seedingEnabled

colors

cycle

fractions

hasAlpha

needsDiffusion

transform

x1

y1

x2

y2

Constructor Detail

GradientTexturePaint

GradientTexturePaint

GradientTexturePaint

Method Detail

containsAlpha

needsDiffusion

createContext

getColors

getFractions

getTransparency