Class CairoGraphics2D

public static final int ALPHA_INTERPOLATION_DEFAULT

Native constants for interpolation methods. Note, this corresponds to an enum in native/jni/gtk-peer/cairographics2d.h

Field Value:

4

public static final int ALPHA_INTERPOLATION_QUALITY

Native constants for interpolation methods. Note, this corresponds to an enum in native/jni/gtk-peer/cairographics2d.h

Field Value:

3

public static final int ALPHA_INTERPOLATION_SPEED

Native constants for interpolation methods. Note, this corresponds to an enum in native/jni/gtk-peer/cairographics2d.h

Field Value:

2

public static final int INTERPOLATION_BICUBIC

Native constants for interpolation methods. Note, this corresponds to an enum in native/jni/gtk-peer/cairographics2d.h

Field Value:

5

public static final int INTERPOLATION_BILINEAR

Native constants for interpolation methods. Note, this corresponds to an enum in native/jni/gtk-peer/cairographics2d.h

Field Value:

1

public static final int INTERPOLATION_NEAREST

Native constants for interpolation methods. Note, this corresponds to an enum in native/jni/gtk-peer/cairographics2d.h

Field Value:

0

protected boolean shiftDrawCalls

Some operations (drawing rather than filling) require that their coords be shifted to land on 0.5-pixel boundaries, in order to land on "middle of pixel" coordinates and light up complete pixels.

public CairoGraphics2D()

Constructor does nothing.

public void addRenderingHints(Map<K,V> hints)

protected void cairoArc(long pointer,
                        double x,
                        double y,
                        double radius,
                        double angle1,
                        double angle2)

Appends an arc to the current path

protected void cairoClip(long pointer)

Clip current path

protected void cairoClosePath(long pointer)

Close current path

protected void cairoCurveTo(long pointer,
                            double x1,
                            double y1,
                            double x2,
                            double y2,
                            double x3,
                            double y3)

Cubic curve-to

protected void cairoDrawGlyphVector(long pointer,
                                    GdkFontPeer font,
                                    float x,
                                    float y,
                                    int n,
                                    int[] codes,
                                    float[] positions,
                                    long[] fontset)

protected void cairoFill(long pointer,
                         double alpha)

Fill current path

protected void cairoLineTo(long pointer,
                           double x,
                           double y)

lineTo

protected void cairoMoveTo(long pointer,
                           double x,
                           double y)

moveTo

protected void cairoNewPath(long pointer)

New current path

protected void cairoRectangle(long pointer,
                              double x,
                              double y,
                              double width,
                              double height)

Appends a rectangle to the current path

protected void cairoResetClip(long pointer)

Clear clip

protected void cairoRestore(long pointer)

protected void cairoSave(long pointer)

Save / restore a cairo path

protected void cairoScale(long pointer,
                          double x,
                          double y)

Scaling method

protected void cairoSetAntialias(long pointer,
                                 boolean aa)

Set antialias.

protected void cairoSetDash(long pointer,
                            double[] dashes,
                            int ndash,
                            double offset)

Set the dash style

protected void cairoSetFillRule(long pointer,
                                int cairoFillRule)

Sets the current winding rule in Cairo

protected void cairoSetFont(long pointer,
                            GdkFontPeer font)

Set the font in cairo.

protected void cairoSetLine(long pointer,
                            double width,
                            int cap,
                            int join,
                            double miterLimit)

Set the line style, cap, join and miter limit. Cap and join parameters are in the BasicStroke enumerations.

protected void cairoSetMatrix(long pointer,
                              double[] m)

Set the current transform matrix

protected void cairoSetOperator(long pointer,
                                int cairoOperator)

Set the compositing operator

protected void cairoSetRGBAColor(long pointer,
                                 double red,
                                 double green,
                                 double blue,
                                 double alpha)

Sets the current color in RGBA as a 0.0-1.0 double

protected void cairoStroke(long pointer)

Stroke current path

public void clearRect(int x,
                      int y,
                      int width,
                      int height)

Note that the rest of the drawing methods go via fill() or draw() for the drawing, although subclasses may with to overload these methods where context-specific optimizations are possible (e.g. bitmaps and fillRect(int, int, int, int)

Overrides:

clearRect in interface Graphics

public void clip(Shape s)

Overrides:

clip in interface Graphics2D

public void clipRect(int x,
                     int y,
                     int width,
                     int height)

Overrides:

clipRect in interface Graphics

public void copy(CairoGraphics2D g,
                 long cairo_t_pointer)

Same as above, but copies the state of another CairoGraphics2D.

public void copyArea(int ox,
                     int oy,
                     int owidth,
                     int oheight,
                     int odx,
                     int ody)

CopyArea - performs clipping to the native surface as a convenience (requires getRealBounds). Then calls copyAreaImpl.

Overrides:

copyArea in interface Graphics

protected abstract void copyAreaImpl(int x,
                                     int y,
                                     int width,
                                     int height,
                                     int dx,
                                     int dy)

public abstract Graphics create()

These are declared abstract as there may be context-specific issues.

Overrides:

create in interface Graphics

public void dispose()

Disposes the native cairographics2d structure, including the cairo_t and any gradient stuff, if allocated. Subclasses should of course overload and call this if they have additional native structures.

Overrides:

dispose in interface Graphics

public void disposeNative(long pointer)

Dispose of allocate native resouces.

public void draw(Shape s)

Overrides:

draw in interface Graphics2D

public void draw3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

Overrides:

draw3DRect in interface Graphics2D

public void drawArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

Overrides:

drawArc in interface Graphics

protected void drawCairoSurface(CairoSurface surface,
                                AffineTransform tx,
                                double alpha,
                                int interpolation)

Optimized method for drawing a CairoSurface onto this graphics context.

Parameters:

surface - The surface to draw.

tx - The transformation matrix (cannot be null).

alpha - The alpha value to paint with ( 0 <= alpha <= 1).

interpolation - The interpolation type.

public void drawGlyphVector(GlyphVector gv,
                            float x,
                            float y)

Overrides:

drawGlyphVector in interface Graphics2D

public boolean drawImage(Image img,
                         int dx1,
                         int dy1,
                         int dx2,
                         int dy2,
                         int sx1,
                         int sy1,
                         int sx2,
                         int sy2,
                         Color bgcolor,
                         ImageObserver observer)

Overrides:

drawImage in interface Graphics

public boolean drawImage(Image img,
                         int dx1,
                         int dy1,
                         int dx2,
                         int dy2,
                         int sx1,
                         int sy1,
                         int sx2,
                         int sy2,
                         ImageObserver observer)

Overrides:

drawImage in interface Graphics

public boolean drawImage(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         Color bgcolor,
                         ImageObserver observer)

Overrides:

drawImage in interface Graphics

public boolean drawImage(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         ImageObserver observer)

Overrides:

drawImage in interface Graphics

public boolean drawImage(Image img,
                         int x,
                         int y,
                         Color bgcolor,
                         ImageObserver observer)

Overrides:

drawImage in interface Graphics

public boolean drawImage(Image img,
                         int x,
                         int y,
                         ImageObserver observer)

Overrides:

drawImage in interface Graphics

protected boolean drawImage(Image img,
                            AffineTransform xform,
                            Color bgcolor,
                            ImageObserver obs)

public boolean drawImage(Image img,
                         AffineTransform xform,
                         ImageObserver obs)

Overrides:

drawImage in interface Graphics2D

public void drawImage(BufferedImage image,
                      BufferedImageOp op,
                      int x,
                      int y)

Overrides:

drawImage in interface Graphics2D

public void drawLine(int x1,
                     int y1,
                     int x2,
                     int y2)

Overrides:

drawLine in interface Graphics

public void drawOval(int x,
                     int y,
                     int width,
                     int height)

Overrides:

drawOval in interface Graphics

protected void drawPixels(long pointer,
                          int[] pixels,
                          int w,
                          int h,
                          int stride,
                          double[] i2u,
                          double alpha,
                          int interpolation)

Draw pixels as an RGBA int matrix

Parameters:

w - - width

h - - height

stride - - stride of the array width

i2u - - affine transform array

public void drawPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

public void drawPolyline(int[] xPoints,
                         int[] yPoints,
                         int nPoints)

public void drawRect(int x,
                     int y,
                     int width,
                     int height)

Overrides:

drawRect in interface Graphics

public void drawRenderableImage(RenderableImage image,
                                AffineTransform xform)

Overrides:

drawRenderableImage in interface Graphics2D

public void drawRenderedImage(RenderedImage image,
                              AffineTransform xform)

Overrides:

drawRenderedImage in interface Graphics2D

public void drawRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

Overrides:

drawRoundRect in interface Graphics

public void drawString(String str,
                       float x,
                       float y)

Overrides:

drawString in interface Graphics2D

public void drawString(String str,
                       int x,
                       int y)

Overrides:

drawString in interface Graphics2D

public void drawString(AttributedCharacterIterator ci,
                       float x,
                       float y)

Overrides:

drawString in interface Graphics2D

public void drawString(AttributedCharacterIterator ci,
                       int x,
                       int y)

Overrides:

drawString in interface Graphics2D

public void fill(Shape s)

Overrides:

fill in interface Graphics2D

public void fillArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

Overrides:

fillArc in interface Graphics

public void fillOval(int x,
                     int y,
                     int width,
                     int height)

Overrides:

fillOval in interface Graphics

public void fillPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

public void fillRect(int x,
                     int y,
                     int width,
                     int height)

Overrides:

fillRect in interface Graphics

public void fillRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

Overrides:

fillRoundRect in interface Graphics

public void finalize()

Generic destructor - call the native dispose() method.

Overrides:

finalize in interface Graphics

public static int[] findSimpleIntegerArray(ColorModel cm,
                                           Raster raster)

Used by drawRaster and GdkPixbufDecoder

protected Rectangle findStrokedBounds(Shape s)

Utility method to find the bounds of a shape, including the stroke width.

Parameters:

s - the shape

Returns:

the bounds of the shape, including stroke width

public Color getBackground()

Overrides:

getBackground in interface Graphics2D

protected ColorModel getBufferCM()

Returns the Color Model describing the buffer that this peer uses for custom composites.

Returns:

ColorModel the ColorModel of the composite buffer in this peer.

public Shape getClip()

Overrides:

getClip in interface Graphics

public Rectangle getClipBounds()

Overrides:

getClipBounds in interface Graphics

protected Rectangle2D getClipInDevSpace()

public Color getColor()

Overrides:

getColor in interface Graphics

public Composite getComposite()

Return the current composite.

Overrides:

getComposite in interface Graphics2D

public abstract GraphicsConfiguration getDeviceConfiguration()

Overrides:

getDeviceConfiguration in interface Graphics2D

public Font getFont()

Overrides:

getFont in interface Graphics

public FontMetrics getFontMetrics()

Overrides:

getFontMetrics in interface Graphics

public FontMetrics getFontMetrics(Font f)

Overrides:

getFontMetrics in interface Graphics

public FontRenderContext getFontRenderContext()

Should perhaps be contexct dependent, but this is left for now as an overloadable default implementation.

Overrides:

getFontRenderContext in interface Graphics2D

protected abstract ColorModel getNativeCM()

Returns the Colour Model describing the native, raw image data for this specific peer.

Returns:

ColorModel the ColorModel of native data in this peer

public Paint getPaint()

Overrides:

getPaint in interface Graphics2D

protected abstract Rectangle2D getRealBounds()

Find the bounds of this graphics context, in device space.

Returns:

the bounds in device-space

public Object getRenderingHint(RenderingHints.Key hintKey)

Overrides:

getRenderingHint in interface Graphics2D

public RenderingHints getRenderingHints()

Overrides:

getRenderingHints in interface Graphics2D

public Stroke getStroke()

Overrides:

getStroke in interface Graphics2D

public AffineTransform getTransform()

Overrides:

getTransform in interface Graphics2D

public boolean hit(Rectangle rect,
                   Shape s,
                   boolean onStroke)

Overrides:

hit in interface Graphics2D

protected long init(long pointer)

Allocate the cairographics2d structure and set the cairo_t pointer in it.

Parameters:

pointer - - a cairo_t pointer, casted to a long.

public void rotate(double theta)

Overrides:

rotate in interface Graphics2D

public void rotate(double theta,
                   double x,
                   double y)

Overrides:

rotate in interface Graphics2D

public void scale(double sx,
                  double sy)

Overrides:

scale in interface Graphics2D

public void setBackground(Color c)

Overrides:

setBackground in interface Graphics2D

public void setClip(int x,
                    int y,
                    int width,
                    int height)

Overrides:

setClip in interface Graphics

public void setClip(Shape s)

Overrides:

setClip in interface Graphics

public void setColor(Color c)

Overrides:

setColor in interface Graphics

public void setComposite(Composite comp)

Sets the current composite context.

Overrides:

setComposite in interface Graphics2D

protected void setCustomPaint(Rectangle bounds)

Sets a custom paint

Parameters:

bounds - the bounding box, in user space

public void setFont(Font f)

Overrides:

setFont in interface Graphics

protected void setGradient(long pointer,
                           double x1,
                           double y1,
                           double x2,
                           double y2,
                           int r1,
                           int g1,
                           int b1,
                           int a1,
                           int r2,
                           int g2,
                           int b2,
                           int a2,
                           boolean cyclic)

public void setPaint(Paint p)

Overrides:

setPaint in interface Graphics2D

public void setPaintMode()

Overrides:

setPaintMode in interface Graphics

protected void setPaintPixels(long pointer,
                              int[] pixels,
                              int w,
                              int h,
                              int stride,
                              boolean repeat,
                              int x,
                              int y)

public void setRenderingHint(RenderingHints.Key hintKey,
                             Object hintValue)

Overrides:

setRenderingHint in interface Graphics2D

public void setRenderingHints(Map hints)

Overrides:

setRenderingHints in interface Graphics2D

public void setStroke(Stroke st)

Overrides:

setStroke in interface Graphics2D

public void setTransform(AffineTransform tx)

Set the current transform

Overrides:

setTransform in interface Graphics2D

public void setXORMode(Color c)

Overrides:

setXORMode in interface Graphics

public void setup(long cairo_t_pointer)

Sets up the default values and allocates the native cairographics2d structure

Parameters:

cairo_t_pointer - a native pointer to a cairo_t of the context.

public void shear(double shearX,
                  double shearY)

Overrides:

shear in interface Graphics2D

public String toString()

Convert this Object to a human-readable String. There are no limits placed on how long this String should be or what it should contain. We suggest you make it as intuitive as possible to be able to place it into System.out.println() and such.

It is typical, but not required, to ensure that this method never completes abruptly with a RuntimeException.

This method will be called when performing string concatenation with this object. If the result is null, string concatenation will instead use "null".

The default implementation returns getClass().getName() + "@" + Integer.toHexString(hashCode()).

Overrides:

toString in interface Graphics

Returns:

the String representing this Object, which may be null

See Also:

getClass(), Object.hashCode(), Class.getName(), Integer.toHexString(int)

public void transform(AffineTransform tx)

Overrides:

transform in interface Graphics2D

public void translate(double tx,
                      double ty)

Translate the system of the co-ordinates. As translation is a frequent operation, it is done in an optimised way, unlike scaling and rotating.

Overrides:

translate in interface Graphics2D

public void translate(int x,
                      int y)

Overrides:

translate in interface Graphics2D