[cairo-commit] cairo-java/src/java/org/freedesktop/cairo
Antialias.java, 1.4, 1.5 CairoObject.java, 1.5,
1.6 Context.java, 1.15, 1.16 Extend.java, 1.6, 1.7 Filter.java,
1.6, 1.7 FontExtents.java, 1.7, 1.8 FontFace.java, 1.7,
1.8 Glyph.java, 1.9, 1.10 Gradient.java, 1.5,
1.6 HintMetrics.java, 1.4, 1.5 HintStyle.java, 1.4,
1.5 ImageSurface.java, 1.14, 1.15 Matrix.java, 1.14,
1.15 Operator.java, 1.7, 1.8 PDFSurface.java, 1.8,
1.9 Pattern.java, 1.12, 1.13 Rectangle.java, 1.4,
1.5 ScaledFont.java, 1.7, 1.8 SubpixelOrder.java, 1.4,
1.5 Surface.java, 1.20, 1.21 SurfacePattern.java, 1.4,
1.5 TextExtents.java, 1.8, 1.9
Andrew Frederick Cowie
commit at pdx.freedesktop.org
Sat Jan 6 19:38:59 PST 2007
Committed by: afcowie
Update of /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo
In directory kemper:/tmp/cvs-serv30276/src/java/org/freedesktop/cairo
Modified Files:
Antialias.java CairoObject.java Context.java Extend.java
Filter.java FontExtents.java FontFace.java Glyph.java
Gradient.java HintMetrics.java HintStyle.java
ImageSurface.java Matrix.java Operator.java PDFSurface.java
Pattern.java Rectangle.java ScaledFont.java SubpixelOrder.java
Surface.java SurfacePattern.java TextExtents.java
Log Message:
Mark deprecated classes
Index: Antialias.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Antialias.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- Antialias.java 12 Feb 2006 09:05:44 -0000 1.4
+++ Antialias.java 7 Jan 2007 03:38:55 -0000 1.5
@@ -13,6 +13,15 @@
/**
* Specifies the type of antialiasing to do when rendering text.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Antialias</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Antialias extends Enum {
@@ -20,6 +29,10 @@
/**
* Use the default antialiasing for the font subsystem and target device
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Antialias DEFAULT = new Antialias(_DEFAULT);
@@ -27,6 +40,10 @@
/**
* Do no antialiasing of fonts; use bilevel text.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Antialias NONE = new Antialias(_NONE);
@@ -35,6 +52,10 @@
/**
* Perform single-color antialiasing (using shades of gray for black text on
* a white background, for example).
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Antialias GRAY = new Antialias(_GRAY);
@@ -43,6 +64,10 @@
/**
* Perform antialiasing by taking advantage of the order of subpixel
* elements on devices such as LCD panels
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Antialias SUBPIXEL = new Antialias(_SUBPIXEL);
Index: CairoObject.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/CairoObject.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- CairoObject.java 12 Feb 2006 09:05:44 -0000 1.5
+++ CairoObject.java 7 Jan 2007 03:38:55 -0000 1.6
@@ -13,6 +13,15 @@
import org.gnu.glib.Handle;
/**
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.CairoObject</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
class CairoObject extends Struct {
Index: Context.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Context.java,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- Context.java 23 Mar 2006 18:55:07 -0000 1.15
+++ Context.java 7 Jan 2007 03:38:55 -0000 1.16
@@ -20,6 +20,10 @@
*
* @param target
* target surface for the context.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Context(Surface target) {
super(cairo_create(target.getHandle()));
@@ -31,6 +35,10 @@
/**
* Disposes all the native resources used by the object.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
protected void finalize() throws Throwable {
cairo_destroy(getHandle());
@@ -43,6 +51,10 @@
* restored. Multiple calls <tt>save()</tt> and <tt>restore()</tt> can
* be nested; each call to <tt>restore()</tt> restores the state from the
* matching paired <tt>save()</tt>.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void save() {
cairo_save(getHandle());
@@ -51,6 +63,10 @@
/**
* Restores the state saved by a preceding call to {@link #save()} and
* removes that state from the stack of saved states.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void restore() {
cairo_restore(getHandle());
@@ -60,6 +76,10 @@
* Sets the compositing operator to be used for all drawing operations.
*
* @param op
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setOperator(Operator op) {
cairo_set_operator(getHandle(), op.getValue());
@@ -71,6 +91,10 @@
* is set.
*
* @param pattern
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setSource(Pattern pattern) {
cairo_set_source(getHandle(), pattern.getHandle());
@@ -84,6 +108,10 @@
* @param red
* @param green
* @param blue
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setSourceRGB(double red, double green, double blue) {
cairo_set_source_rgb(getHandle(), red, green, blue);
@@ -102,6 +130,10 @@
* @param green
* @param blue
* @param alpha
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setSourceRGBA(double red, double green, double blue,
double alpha) {
@@ -113,6 +145,10 @@
* @param surface
* @param x
* @param y
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setSource(Surface surface, double x, double y) {
cairo_set_source_surface(getHandle(), surface.getHandle(), x, y);
@@ -128,6 +164,10 @@
* significantly).
*
* @param tolerance
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setTolerance(double tolerance) {
cairo_set_tolerance(getHandle(), tolerance);
@@ -140,6 +180,10 @@
* and <tt>clip</tt>.
*
* @param fillrule
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setFillRule(FillRule fillrule) {
cairo_set_fill_rule(getHandle(), fillrule.getValue());
@@ -154,6 +198,10 @@
* <tt>strokeToPath(), but does not have any effect during path
* construction.
* @param width
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setLineWidth(double width) {
cairo_set_line_width(getHandle(), width);
@@ -165,6 +213,10 @@
* are drawn.
*
* @param linecap
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setLineCap(LineCap linecap) {
cairo_set_line_cap(getHandle(), linecap.getValue());
@@ -176,6 +228,10 @@
* are drawn.
*
* @param linejoin
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setLineJoin(LineJoin linejoin) {
cairo_set_line_join(getHandle(), linejoin.getValue());
@@ -186,6 +242,10 @@
*
* @param dashes
* @param offset
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setDash(double[] dashes, double offset) {
cairo_set_dash(getHandle(), dashes, offset);
@@ -195,6 +255,10 @@
* Sets the miter limit.
*
* @param limit
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setMiterLimit(double limit) {
cairo_set_miter_limit(getHandle(), limit);
@@ -209,6 +273,10 @@
*
* @param tx
* @param ty
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void translate(double tx, double ty) {
cairo_translate(getHandle(), tx, ty);
@@ -221,6 +289,10 @@
*
* @param sx
* @param sy
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void scale(double sx, double sy) {
cairo_scale(getHandle(), sx, sy);
@@ -234,6 +306,10 @@
* axis.
*
* @param angle
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void rotate(double angle) {
cairo_rotate(getHandle(), angle);
@@ -246,6 +322,10 @@
*
* @param matrix
* the transformation matrix to append
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void transform(Matrix matrix) {
cairo_transform(getHandle(), matrix.getHandle());
@@ -257,6 +337,10 @@
*
* @param matrix
* the transformation matrix
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setMatrix(Matrix matrix) {
cairo_set_matrix(getHandle(), matrix.getHandle());
@@ -266,6 +350,10 @@
* Resets the current transformation matrix (CTM) by setting it equal to the
* identity matrix. That is, the user-space and device-space axes will be
* aligned and one user-space unit will transform to one device-space unit.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void identityMatrix() {
cairo_identity_matrix(getHandle());
@@ -274,6 +362,10 @@
/**
* Transform a coordinate from user space to device space by multiplying the
* given point by the current transformation matrix (CTM).
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point userToDevice(Point point) {
double[] px = new double[] { point.getX() };
@@ -286,6 +378,10 @@
* Transform a distance vector from user space to device space. This
* function is similar to userToDevice() except that the translation
* components of the CTM will be ignored when transforming the Point.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point userToDeviceDistance(Point distance) {
double[] dx = new double[] { distance.getX() };
@@ -297,6 +393,10 @@
/**
* Transform a coordinate from device space to user space by multiplying the
* given point by the inverse of the current transformation matrix (CTM).
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point deviceToUser(Point point) {
double[] px = new double[] { point.getX() };
@@ -310,6 +410,10 @@
* function is similar to deviceToUser() except that the translation
* components of the inverse CTM will be ignored when transforming the
* Point.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point deviceToUserDistance(Point distance) {
double[] dx = new double[] { distance.getX() };
@@ -321,6 +425,10 @@
/**
* Starts a new path. You can add path segments to this path using the path
* extension methods (xxxxTo()).
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void newPath() {
cairo_new_path(getHandle());
@@ -331,6 +439,10 @@
*
* @param p
* the point co-ordinate of the point to move to
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void moveTo(Point p) {
cairo_move_to(getHandle(), p.getX(), p.getY());
@@ -346,6 +458,10 @@
*
* @param p
* the point coordinate for the end point for the line segment
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void lineTo(Point p) {
cairo_line_to(getHandle(), p.getX(), p.getY());
@@ -365,6 +481,10 @@
* x co-ordinate of the second control point
* @param p3
* x co-ordinate of the end point
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void curveTo(Point p1, Point p2, Point p3) {
cairo_curve_to(getHandle(), p1.getX(), p1.getY(), p2.getX(), p2.getY(),
@@ -395,6 +515,10 @@
* @param radius
* @param angle1
* @param angle2
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void arc(Point point, double radius, double angle1, double angle2) {
cairo_arc(getHandle(), point.getX(), point.getY(), radius, angle1,
@@ -416,6 +540,10 @@
* @param radius
* @param angle1
* @param angle2
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void arcNegative(Point point, double radius, double angle1,
double angle2) {
@@ -434,6 +562,10 @@
*
* @param p
* relative distance between current point and the new point
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void relMoveTo(Point p) {
cairo_rel_move_to(getHandle(), p.getX(), p.getY());
@@ -450,6 +582,10 @@
*
* @param p
* The relative coordinate for the end point for the line segment
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void relLineTo(Point p) {
cairo_rel_line_to(getHandle(), p.getX(), p.getY());
@@ -470,6 +606,10 @@
* relative co-ordinate of the second control point
* @param p3
* relative co-ordinate of the end point
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void relCurveTo(Point p1, Point p2, Point p3) {
cairo_rel_curve_to(getHandle(), p1.getX(), p1.getY(), p2.getX(), p2
@@ -489,6 +629,10 @@
* x and y coordinates of the upper-left point
* @param lowerRight
* x and y coordinates of the lower-right point
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void rectangle(Point upperLeft, Point lowerRight) {
Rectangle r = new Rectangle(upperLeft, lowerRight);
@@ -500,6 +644,10 @@
*
* @param rect
* Rectangle defining the coordinate of the shape to draw
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void rectangle(Rectangle rect) {
cairo_rectangle(getHandle(), rect.getX(), rect.getY(), rect.getWidth(),
@@ -509,6 +657,10 @@
/**
* Closes the current path by connecting current point to the starting point
* with a line segment.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void closePath() {
cairo_close_path(getHandle());
@@ -517,6 +669,10 @@
/**
* A drawing operator that paints the current source everywhere within the
* current clip region.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void paint() {
cairo_paint(getHandle());
@@ -529,6 +685,10 @@
* using the alpha value.
*
* @param alpha
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void paintWithAlpha(double alpha) {
cairo_paint_with_alpha(getHandle(), alpha);
@@ -540,6 +700,10 @@
* transparent areas are not painted.)
*
* @param pattern
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void mask(Pattern pattern) {
cairo_mask(getHandle(), pattern.getHandle());
@@ -553,6 +717,10 @@
* @param surface
* @param sx
* @param sy
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void mask(Surface surface, double sx, double sy) {
cairo_mask_surface(getHandle(), surface.getHandle(), sx, sy);
@@ -562,6 +730,10 @@
* A drawing operator that strokes the current path according to the current
* line width, line join, line cap, and dash settings. After stroke, the
* current path will be cleared from the cairo context.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void stroke() {
cairo_stroke(getHandle());
@@ -571,6 +743,10 @@
* A drawing operator that strokes the current path according to the current
* line width, line join, line cap, and dash settings. Unlike stroke(),
* strokePreserve preserves the path within the cairo context.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void strokePreserve() {
cairo_stroke_preserve(getHandle());
@@ -580,6 +756,10 @@
* A drawing operator that fills the current path according to the current
* fill rule. After fill, the current path will be cleared from the cairo
* context.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void fill() {
cairo_fill(getHandle());
@@ -589,6 +769,10 @@
* A drawing operator that fills the current path according to the current
* fill rule. Unlike fill(), fillPreserve preserves the path within the
* cairo context.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void fillPreserve() {
cairo_fill_preserve(getHandle());
@@ -611,6 +795,10 @@
* x coordinate of the point to test
* @param y
* y coordinate of the point to test
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public boolean inStroke(double x, double y) {
return cairo_in_stroke(getHandle(), x, y);
@@ -629,6 +817,10 @@
* x coordinate of the point to test
* @param y
* y coordinate of the point to test
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public boolean inFill(double x, double y) {
return cairo_in_fill(getHandle(), x, y);
@@ -667,6 +859,10 @@
* will cause results unexpected by higher-level code which calls clip().
* Consider using save() and restore() around clip() as a more robust means
* of temporarily restricting the clip region.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void resetClip() {
cairo_reset_clip(getHandle());
@@ -688,6 +884,10 @@
* restriction of the clip region can be achieved by calling clip() within a
* save()/restore() pair. The only other means of increasing the size of the
* clip region is resetClip().
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void clip() {
cairo_clip(getHandle());
@@ -709,6 +909,10 @@
* restriction of the clip region can be achieved by calling clip() within a
* save()/restore() pair. The only other means of increasing the size of the
* clip region is resetClip().
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void clipPreserve() {
cairo_clip_preserve(getHandle());
@@ -728,6 +932,10 @@
* font slant
* @param weight
* font weight
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void selectFontFace(String family, FontSlant slant, FontWeight weight) {
cairo_select_font_face(getHandle(), family, slant.getValue(), weight
@@ -743,6 +951,10 @@
*
* @param scale
* the scaling factor.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setFontSize(double scale) {
cairo_set_font_size(getHandle(), scale);
@@ -757,6 +969,10 @@
*
* @param matrix
* transformation matrix.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setFontMatrix(Matrix matrix) {
cairo_set_font_matrix(getHandle(), matrix.getHandle());
@@ -766,6 +982,10 @@
* Gets the current font matrix. See setFontMatrix()
*
* @return the current font matrix
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Matrix getFontMatrix() {
return new Matrix(cairo_get_font_matrix(getHandle()));
@@ -776,6 +996,10 @@
*
* @param text
* String to draw on the screen.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void showText(String text) {
cairo_show_text(getHandle(), text);
@@ -792,6 +1016,10 @@
/**
* Gets the current font face.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public FontFace getFontFace() {
return new FontFace(cairo_get_font_face(getHandle()));
@@ -799,6 +1027,10 @@
/**
* Gets the font extents for the currently selected font.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public FontExtents fontExtents() {
Handle hndl = Struct.getNullHandle();
@@ -812,6 +1044,10 @@
* references to it.
*
* @param fontFace
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setFontFace(FontFace fontFace) {
cairo_set_font_face(getHandle(), fontFace.getHandle());
@@ -830,6 +1066,10 @@
* particular, trailing whitespace characters are likely to not affect the
* size of the rectangle, though they will affect the xAdvance and yAdvance
* values.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public TextExtents textExtents(String text) {
Handle hndl = Struct.getNullHandle();
@@ -846,6 +1086,10 @@
*
* Note that whitespace glyphs do not contribute to the size of the
* rectangle (extents.width and extents.height).
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public TextExtents glyphExtents(Glyph[] glyphs) {
Handle hndl = Struct.getNullHandle();
@@ -871,6 +1115,10 @@
* Returns the current surface operator
*
* @return The surface operator.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Operator getOperator() {
return Operator.intern(cairo_get_operator(getHandle()));
@@ -878,6 +1126,10 @@
/**
* Gets the current source pattern for this object.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Pattern getSource() {
Handle hndl = cairo_get_source(getHandle());
@@ -888,6 +1140,10 @@
* Returns the tesselation tolerance of the current state.
*
* @return tesselation tolerance
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getTolerance() {
return cairo_get_tolerance(getHandle());
@@ -900,6 +1156,10 @@
* there is no defined current point then Point will be set to (0,0)
*
* @return Current point for drawing
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point getCurrentPoint() {
double[] x = new double[1];
@@ -910,6 +1170,10 @@
/**
* Gets the current fill rule, as set by setFillRule().
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public FillRule getFillRule() {
return FillRule.intern(cairo_get_fill_rule(getHandle()));
@@ -919,6 +1183,10 @@
* Returns the stroke line width.
*
* @return The stroke line width
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getLineWidth() {
return cairo_get_line_width(getHandle());
@@ -928,6 +1196,10 @@
* Returns current linecap style.
*
* @return The line cap style
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public LineCap getLineCap() {
return LineCap.intern(cairo_get_line_cap(getHandle()));
@@ -937,6 +1209,10 @@
* Return current line join style.
*
* @return Line join style
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public LineJoin getLineJoin() {
return LineJoin.intern(cairo_get_line_join(getHandle()));
@@ -946,6 +1222,10 @@
* Returns the miter limit for miter style line joins
*
* @return The miter limit
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getMiterLimit() {
return cairo_get_miter_limit(getHandle());
@@ -955,6 +1235,10 @@
* Returns the current transformation matrix
*
* @return the current transformation matrix
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Matrix getMatrix() {
Handle handle = cairo_get_matrix(getHandle());
@@ -966,6 +1250,10 @@
* constructor.
*
* @return the target surface
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Surface getTarget() {
return new Surface(cairo_get_target(getHandle()));
@@ -1005,6 +1293,10 @@
* X radius of the ellipse
* @param ry
* Y radius of the ellipse
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void ellipse(double cx, double cy, double rx, double ry) {
@@ -1024,6 +1316,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private Handle cairo_create(Handle surface);
Index: Extend.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Extend.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- Extend.java 12 Feb 2006 09:05:44 -0000 1.6
+++ Extend.java 7 Jan 2007 03:38:55 -0000 1.7
@@ -11,6 +11,15 @@
import org.gnu.glib.Enum;
/**
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Extend</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Extend extends Enum {
@@ -18,6 +27,10 @@
/**
* pixels outside of the source pattern are fully transparent
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Extend NONE = new Extend(_NONE);
@@ -25,6 +38,10 @@
/**
* the pattern is tiled by repeating
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Extend REPEAT = new Extend(_REPEAT);
@@ -32,6 +49,10 @@
/**
* the pattern is tiled by reflecting at the edges
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Extend REFLECT = new Extend(_REFLECT);
@@ -39,6 +60,10 @@
/**
* pixels outside of the pattern copy the closest pixel from the source
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public Extend PAD = new Extend(_PAD);
Index: Filter.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Filter.java,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- Filter.java 12 Feb 2006 09:05:44 -0000 1.6
+++ Filter.java 7 Jan 2007 03:38:55 -0000 1.7
@@ -11,6 +11,15 @@
import org.gnu.glib.Enum;
/**
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Filter</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Filter extends Enum {
static final private int _FAST = 0;
Index: FontExtents.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/FontExtents.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- FontExtents.java 12 Feb 2006 09:05:44 -0000 1.7
+++ FontExtents.java 7 Jan 2007 03:38:55 -0000 1.8
@@ -43,6 +43,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private void free(Handle obj);
Index: FontFace.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/FontFace.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- FontFace.java 12 Feb 2006 09:05:44 -0000 1.7
+++ FontFace.java 7 Jan 2007 03:38:55 -0000 1.8
@@ -14,6 +14,15 @@
* A FontFace specifies all aspects of a font other than the size or font matrix
* (a font matrix is used to distort a font by sheering it or scaling it
* unequally in the two directions).
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.FontFace</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class FontFace extends CairoObject {
@@ -28,6 +37,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private void cairo_font_face_destroy(Handle obj);
Index: Glyph.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Glyph.java,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Glyph.java 12 Feb 2006 09:05:44 -0000 1.9
+++ Glyph.java 7 Jan 2007 03:38:55 -0000 1.10
@@ -19,6 +19,15 @@
* doesn't expose any way of converting input text into glyphs, so in order to
* use the Cairo interfaces that take arrays of glyphs, you must directly access
* the appropriate underlying font system.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Glyph</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Glyph extends CairoObject {
@@ -69,6 +78,10 @@
/*
* native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private Handle alloc();
Index: Gradient.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Gradient.java,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- Gradient.java 12 Feb 2006 09:05:44 -0000 1.5
+++ Gradient.java 7 Jan 2007 03:38:55 -0000 1.6
@@ -27,6 +27,10 @@
* The value to use for green
* @param blue
* The value to use for blue
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void addColorStop(double offset, double red, double green,
double blue) {
@@ -46,6 +50,10 @@
* The value to use for blue
* @param alpha
* alpha for the color
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void addColorStop(double offset, double red, double green,
double blue, double alpha) {
Index: HintMetrics.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/HintMetrics.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- HintMetrics.java 12 Feb 2006 09:05:44 -0000 1.4
+++ HintMetrics.java 7 Jan 2007 03:38:55 -0000 1.5
@@ -16,6 +16,15 @@
* them so that they are integer values in device space. Doing this improves the
* consistency of letter and line spacing, however it also means that text will
* be laid out differently at different zoom factors.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.HintMetrics</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class HintMetrics extends Enum {
@@ -23,6 +32,10 @@
/**
* Hint metrics in the default manner for the font backend and target device
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintMetrics DEFAULT = new HintMetrics(_DEFAULT);
@@ -30,6 +43,10 @@
/**
* Do not hint font metrics
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintMetrics OFF = new HintMetrics(_OFF);
@@ -37,6 +54,10 @@
/**
* Hint font metrics
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintMetrics ON = new HintMetrics(_ON);
Index: HintStyle.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/HintStyle.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- HintStyle.java 12 Feb 2006 09:05:44 -0000 1.4
+++ HintStyle.java 7 Jan 2007 03:38:55 -0000 1.5
@@ -17,6 +17,15 @@
* the result. Since hinting outlines involves distorting them, it also reduces
* the faithfulness to the original outline shapes. Not all of the outline
* hinting styles are supported by all font backends.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.HintStyle</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class HintStyle extends Enum {
@@ -24,6 +33,10 @@
/**
* Use the default hint style for for font backend and target device
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintStyle DEFAULT = new HintStyle(_DEFAULT);
@@ -31,6 +44,10 @@
/**
* Do not hint outlines
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintStyle NONE = new HintStyle(_NONE);
@@ -39,6 +56,10 @@
/**
* Hint outlines slightly to improve contrast while retaining good fidelity
* to the original shapes.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintStyle SLIGHT = new HintStyle(_SLIGHT);
@@ -47,6 +68,10 @@
/**
* Hint outlines with medium strength giving a compromise between fidelity
* to the original shapes and contrast
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintStyle MEDIUM = new HintStyle(_MEDIUM);
@@ -54,6 +79,10 @@
/**
* Hint outlines to maximize contrast
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public HintStyle FULL = new HintStyle(_FULL);
Index: ImageSurface.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/ImageSurface.java,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- ImageSurface.java 23 Mar 2006 19:03:07 -0000 1.14
+++ ImageSurface.java 7 Jan 2007 03:38:55 -0000 1.15
@@ -12,6 +12,15 @@
import org.gnu.glib.Handle;
/**
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.ImageSurface</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class ImageSurface extends Surface {
@@ -43,6 +52,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private Handle cairo_image_surface_create(int format,
int width, int height);
Index: Matrix.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Matrix.java,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- Matrix.java 23 Mar 2006 18:32:01 -0000 1.14
+++ Matrix.java 7 Jan 2007 03:38:55 -0000 1.15
@@ -13,6 +13,15 @@
/**
* TODO: error handling
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Matrix</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Matrix extends CairoObject {
@@ -22,6 +31,10 @@
/**
* Creates a new matrix initialized with a noop transform.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Matrix() {
super(new_identity_matrix());
@@ -29,6 +42,10 @@
/**
* Disposes all the native resources used by the matrix.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
protected void finalize() throws Throwable {
free_matrix(getHandle());
@@ -41,6 +58,10 @@
* x_new = xx * x + xy * y + x0;
* y_new = yx * x + yy * y + y0;
* </code>
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void init(double xx, double yx, double xy, double yy, double x0,
double y0) {
@@ -49,6 +70,10 @@
/**
* Modifies the matrix to be an identity transformation.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void initIdentity() {
cairo_matrix_init_identity(getHandle());
@@ -62,6 +87,10 @@
* amount to translate in the X direction.
* @param ty
* amount to translate in the Y direction.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void initTranslate(double tx, double ty) {
cairo_matrix_init_translate(getHandle(), tx, ty);
@@ -75,6 +104,10 @@
* scale factor in the X direction.
* @param sy
* scale factor in the Y direction.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void initScale(double sx, double sy) {
cairo_matrix_init_scale(getHandle(), sx, sy);
@@ -91,6 +124,10 @@
* the positive X axis toward the positive Y axis. With the
* default axis orientation of cairo, positive angles rotate in a
* clockwise direction.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void initRotate(double radians) {
cairo_matrix_init_rotate(getHandle(), radians);
@@ -103,6 +140,10 @@
* X axis translation
* @param ty
* Y axis translation
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void translate(double tx, double ty) {
cairo_matrix_translate(getHandle(), tx, ty);
@@ -115,6 +156,10 @@
* X axis scaling factor
* @param sy
* Y axis scaling factor
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void scale(double sx, double sy) {
cairo_matrix_scale(getHandle(), sx, sy);
@@ -125,6 +170,10 @@
*
* @param radians
* The rotation angle in radians.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void rotate(double radians) {
cairo_matrix_rotate(getHandle(), radians);
@@ -132,6 +181,10 @@
/**
* Inverts this matrix.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void invert() {
cairo_matrix_invert(getHandle());
@@ -145,6 +198,10 @@
* @param b
* second matrix
* @return The product
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static public Matrix multiply(Matrix a, Matrix b) {
Handle hndl = cairo_matrix_multiply(a.getHandle(), b.getHandle());
@@ -153,6 +210,10 @@
/**
* Transforms the given distance and returns transformed co-ordinates
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point transformDistance(Point distance) {
double[] dx = new double[] { distance.getX() };
@@ -163,6 +224,10 @@
/**
* Transforms the given point and returns transformed co-ordinates
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Point transformPoint(Point point) {
double[] dx = new double[] { point.getX() };
@@ -221,6 +286,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private double getXX(Handle matrix);
Index: Operator.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Operator.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- Operator.java 12 Feb 2006 09:05:44 -0000 1.7
+++ Operator.java 7 Jan 2007 03:38:55 -0000 1.8
@@ -11,6 +11,15 @@
import org.gnu.glib.Enum;
/**
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Operator</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Operator extends Enum {
static final private int _CLEAR = 0;
Index: PDFSurface.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/PDFSurface.java,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- PDFSurface.java 12 Feb 2006 09:05:44 -0000 1.8
+++ PDFSurface.java 7 Jan 2007 03:38:55 -0000 1.9
@@ -14,6 +14,15 @@
import org.gnu.glib.Handle;
/**
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.PDFSurface</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class PDFSurface extends Surface {
@@ -54,6 +63,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private Handle cairo_pdf_surface_create(
String filename, double width_inches, double height_inches);
Index: Pattern.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Pattern.java,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- Pattern.java 23 Mar 2006 18:32:01 -0000 1.12
+++ Pattern.java 7 Jan 2007 03:38:55 -0000 1.13
@@ -13,6 +13,15 @@
/**
* TODO: error handling
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Pattern</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Pattern extends CairoObject {
@@ -24,6 +33,10 @@
* @param red
* @param green
* @param blue
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Pattern(double red, double green, double blue) {
super(cairo_pattern_create_rgb(red, green, blue));
@@ -38,6 +51,10 @@
* @param green
* @param blue
* @param alpha
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Pattern(double red, double green, double blue, double alpha) {
super(cairo_pattern_create_rgba(red, green, blue, alpha));
@@ -57,6 +74,10 @@
*
* @param matrix
* The transformation matrix.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setMatrix(Matrix matrix) {
cairo_pattern_set_matrix(getHandle(), matrix.getHandle());
@@ -67,6 +88,10 @@
* method returns a new matrix object and you must dispose it.
*
* @return The transformation matrix for the pattern.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Matrix getMatrix() {
Handle hndl = cairo_pattern_get_matrix(getHandle());
@@ -75,6 +100,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private void cairo_pattern_destroy(Handle pat);
Index: Rectangle.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Rectangle.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- Rectangle.java 23 Mar 2006 18:55:07 -0000 1.4
+++ Rectangle.java 7 Jan 2007 03:38:55 -0000 1.5
@@ -30,6 +30,10 @@
* x coordinate of the lower-right point of the rectangle
* @param y2
* y coordinate of the lower-right point of the rectangle
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Rectangle(double x1, double y1, double x2, double y2) {
if (x1 <= x2) {
@@ -58,6 +62,10 @@
* x coordinate of the upper-left point of the rectangle
* @param lowerRight
* y coordinate of the lower-right point of the rectangle
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Rectangle(Point upperLeft, Point lowerRight) {
this(upperLeft.getX(), upperLeft.getY(),
@@ -67,6 +75,10 @@
/**
* Constructs a new Rectangle object with position and size
* set to 0.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Rectangle() {
this.x = this.y = this.width = this.height = 0;
@@ -126,6 +138,10 @@
* {@link #getX}.
*
* @see #getX
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getX1() {
return x;
@@ -136,6 +152,10 @@
* {@link #setX}.
*
* @see #setX
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setX1(double x1) {
this.x = x1;
@@ -146,6 +166,10 @@
* {@link #getWidth}.
*
* @see #getWidth
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getX2() {
return x + width;
@@ -156,6 +180,10 @@
* {@link #setWidth}.
*
* @see #setWidth
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setX2(double x2) {
if (x2 >= this.x) {
@@ -171,6 +199,10 @@
* {@link #getY}.
*
* @see #getY
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getY1() {
return y;
@@ -181,6 +213,10 @@
* {@link #setY}.
*
* @see #setY
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setY1(double y1) {
this.y = y1;
@@ -191,6 +227,10 @@
* {@link #getHeight}.
*
* @see #getHeight
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public double getY2() {
return y + height;
@@ -201,6 +241,10 @@
* {@link #setHeight}.
*
* @see #setHeight
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setY2(double y2) {
if (y2 >= this.y) {
Index: ScaledFont.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/ScaledFont.java,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- ScaledFont.java 12 Feb 2006 09:05:44 -0000 1.7
+++ ScaledFont.java 7 Jan 2007 03:38:55 -0000 1.8
@@ -25,6 +25,10 @@
* @param ctm
* user to device transformation matrix with which the font will
* be used.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public ScaledFont(FontFace fontFace, Matrix matrix, Matrix ctm,
FontOptions options) {
@@ -54,6 +58,10 @@
* @param glyhps
* an array of glyph IDs with X and Y offsets
* @return a TextExtent which contains the extents
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public TextExtents getGlyphExtents(Glyph[] glyhps) {
if (null == glyhps)
Index: SubpixelOrder.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/SubpixelOrder.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- SubpixelOrder.java 12 Feb 2006 09:05:44 -0000 1.4
+++ SubpixelOrder.java 7 Jan 2007 03:38:55 -0000 1.5
@@ -14,6 +14,15 @@
/**
* The subpixel order specifies the order of color elements within each pixel on
* the display device when rendering with an antialiasing mode of SUBPIXEL.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.SubpixelOrder</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class SubpixelOrder extends Enum {
@@ -21,6 +30,10 @@
/**
* Use the default subpixel order for for the target device
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public SubpixelOrder DEFAULT = new SubpixelOrder(_DEFAULT);
@@ -28,6 +41,10 @@
/**
* Subpixel elements are arranged horizontally with red at the left
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public SubpixelOrder RGB = new SubpixelOrder(_RGB);
@@ -35,6 +52,10 @@
/**
* Subpixel elements are arranged horizontally with blue at the left
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public SubpixelOrder BGR = new SubpixelOrder(_BGR);
@@ -42,6 +63,10 @@
/**
* Subpixel elements are arranged vertically with red at the top
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public SubpixelOrder VRGB = new SubpixelOrder(_VRGB);
@@ -49,6 +74,10 @@
/**
* Subpixel elements are arranged vertically with blue at the top
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
static final public SubpixelOrder VBGR = new SubpixelOrder(_VBGR);
Index: Surface.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/Surface.java,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- Surface.java 28 Feb 2006 17:51:37 -0000 1.20
+++ Surface.java 7 Jan 2007 03:38:55 -0000 1.21
@@ -15,6 +15,15 @@
/**
* The Surface class represents an Cairo drawing surface. A Cairo object is used
* to draw on the drawing surface.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.Surface</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class Surface extends CairoObject {
@@ -66,6 +75,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private Handle cairo_surface_create_similar(
Handle other, int format, int width, int height);
Index: SurfacePattern.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/SurfacePattern.java,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- SurfacePattern.java 12 Feb 2006 09:05:44 -0000 1.4
+++ SurfacePattern.java 7 Jan 2007 03:38:55 -0000 1.5
@@ -19,6 +19,10 @@
*
* @param extend
* The Extend to use.
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setExtend(Extend extend) {
cairo_pattern_set_extend(getHandle(), extend.getValue());
@@ -28,6 +32,10 @@
* Returns the current extend option for the pattern.
*
* @return The current extend option
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Extend getExtend() {
return Extend.intern(cairo_pattern_get_extend(getHandle()));
@@ -37,6 +45,10 @@
* Sets the filter option for the pattern.
*
* @param filter
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public void setFilter(Filter filter) {
cairo_pattern_set_filter(getHandle(), filter.getValue());
@@ -46,6 +58,10 @@
* Returns the current filter option for the pattern.
*
* @return The current filter option (One of the Cairo.FILTER_xxx options).
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
public Filter getFilter() {
return Filter.intern(cairo_pattern_get_filter(getHandle()));
Index: TextExtents.java
===================================================================
RCS file: /cvs/cairo/cairo-java/src/java/org/freedesktop/cairo/TextExtents.java,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- TextExtents.java 12 Feb 2006 09:05:44 -0000 1.8
+++ TextExtents.java 7 Jan 2007 03:38:55 -0000 1.9
@@ -15,6 +15,15 @@
* The TextExtents stores the extents of a single glyph or a string of glyphs in
* user-space coordinates. Because text extents are in user-space coordinates,
* they don't scale along with the current transformation matrix.
+ *
+ * @deprecated This class is part of the java-gnome 2.x family of libraries,
+ * which, due to their inefficiency and complexity, are no longer
+ * being maintained and have been abandoned by the java-gnome
+ * project. This class may exist in java-gnome 4.0; look out for
+ * <code>org.freedesktop.cairo.TextExtents</code>.
+ * As this package was never correctly implemented in java-gnome 2.x,
+ * any new code written will likely have a considerably different
+ * public API.
*/
public class TextExtents extends CairoObject {
@@ -56,6 +65,10 @@
/*
* Native calls
+ * @deprecated Superceeded by java-gnome 4.0; this method or constant
+ * will no doubt exist conceptually, but it may have a different
+ * name or signature in order that the presented API is an
+ * algorithmic mapping of the underlying native libraries.
*/
native static final private double get_x_bearing(Handle obj);
More information about the cairo-commit
mailing list