1 |
/* Copyright (C) 2000, 2002 Free Software Foundation |
/* Paint.java -- generate colors for Graphics2D operations |
2 |
|
Copyright (C) 2000, 2002 Free Software Foundation |
3 |
|
|
4 |
This file is part of GNU Classpath. |
This file is part of GNU Classpath. |
5 |
|
|
38 |
|
|
39 |
package java.awt; |
package java.awt; |
40 |
|
|
41 |
/** |
import java.awt.geom.AffineTransform; |
42 |
* @author Warren Levy <warrenl@cygnus.com> |
import java.awt.geom.Rectangle2D; |
43 |
* @date March 15, 2000. |
import java.awt.image.ColorModel; |
|
*/ |
|
44 |
|
|
45 |
/** |
/** |
46 |
* Written using on-line Java Platform 1.2 API Specification, as well |
* Defines how color patterns are generated for Graphics2D operations. This |
47 |
* as "The Java Class Libraries", 2nd edition (Addison-Wesley, 1998). |
* is used to perform the <code>draw</code> and <code>fill</code> methods |
48 |
* Status: Stubbed. |
* of the graphics object. Instances must be immutable, because the graphics |
49 |
|
* object does not clone them. |
50 |
|
* |
51 |
|
* @author Warren Levy <warrenl@cygnus.com> |
52 |
|
* @see PaintContext |
53 |
|
* @see Color |
54 |
|
* @see GradientPaint |
55 |
|
* @see TexturePaint |
56 |
|
* @see Graphics2D#setPaint(Paint) |
57 |
|
* @since 1.1 |
58 |
|
* @status updated to 1.4 |
59 |
*/ |
*/ |
|
|
|
60 |
public interface Paint extends Transparency |
public interface Paint extends Transparency |
61 |
{ |
{ |
62 |
// FIXME |
/** |
63 |
// public PaintContext createContext(ColorModel cm, |
* Create the context necessary for performing the color pattern generation. |
64 |
// Rectangle deviceBounds, |
* The color model is a hint, and may be null for Classpath implementations; |
65 |
// Rectangle2D userBounds, |
* however some legacy code may throw a NullPointerException when passed a |
66 |
// AffineTransform xform, |
* null. Leaving the color model null provides the most efficiency and leeway |
67 |
// RenderingHints hints); |
* in the generation of the color pattern. |
68 |
} |
* |
69 |
|
* @param cm the color model, used as a hint |
70 |
|
* @param deviceBounds the device space bounding box of the painted area |
71 |
|
* @param userBounds the user space bounding box of the painted area |
72 |
|
* @param xform the transformation from user space to device space |
73 |
|
* @param hints any hints for choosing between rendering alternatives |
74 |
|
* @return the context for performing the paint |
75 |
|
*/ |
76 |
|
PaintContext createContext(ColorModel cm, Rectangle deviceBounds, |
77 |
|
Rectangle2D userBounds, AffineTransform xform, |
78 |
|
RenderingHints hints); |
79 |
|
} // interface Paint |