libjava/gnu/gcj/xlib/GC.java

   1 /* Copyright (C) 2000, 2003  Free Software Foundation
   2
   3    This file is part of libgcj.
   4
   5 This software is copyrighted work licensed under the terms of the
   6 Libgcj License.  Please consult the file "LIBGCJ_LICENSE" for
   7 details.  */
   8
   9 package gnu.gcj.xlib;
  10
  11 import gnu.gcj.RawData;
  12 import java.awt.Rectangle;
  13
  14 /**
  15  * An X11 graphics context.  Unlike a traditional X11 graphics
  16  * context, the target drawable is part of the GC state.
  17  *
  18  * Implementation notes: There is no need to do coalescing of changes
  19  * since Xlib will do this for us.  The implementation relies on the
  20  * Xlib GC cache and will not try to be clever.
  21  *
  22  * @author Rolf W. Rasmussen <rolfwr@ii.uib.no>
  23  */
  24 public class GC implements Cloneable
  25 {
  26
  27   public GC(Drawable target)
  28   {
  29     this.target = target;
  30     initStructure(null);
  31   }
  32
  33   public Object clone()
  34   {
  35     GC gcClone = (GC) super.clone();
  36     gcClone.structure = null;
  37     gcClone.initStructure(this);
  38     gcClone.updateClip();
  39     return gcClone;
  40   }
  41
  42   private native void initStructure(GC copyFrom);
  43
  44   public GC create()
  45   {
  46     return (GC) clone();
  47   }
  48
  49   public void finalize()
  50   {
  51     disposeImpl();
  52   }
  53
  54   public void dispose()
  55   {
  56     disposeImpl();
  57   }
  58
  59   public synchronized native void disposeImpl();
  60
  61   public native void setForeground(long pixel);
  62   public native void setFont(gnu.gcj.xlib.Font font);
  63
  64   /**
  65    * Set the clip region for the graphics operations performed by the
  66    * GC.
  67    *
  68    * This is one of the few costly operations of this class.  It is
  69    * suggested that the clip is only set or changed if really
  70    * necessary.  Higher level APIs can make such optimizations
  71    * transparent.
  72    *
  73    * @param rectangles the union of these rectangles describe the clip
  74    * region.
  75    */
  76   public void setClipRectangles(Rectangle[] rectangles)
  77   {
  78     clip = new Clip(rectangles);
  79     updateClip();
  80   }
  81
  82   public native void drawString(String text, int x, int y);
  83   public native void drawLine(int x1, int y1, int x2, int y2);
  84   public native void drawRectangle(int x, int y, int w, int h);
  85
  86   public native void fillRectangle(int x, int y, int w, int h);
  87   public native void fillPolygon(int[] xPoints, int[] yPoints, int nPoints,
  88                                  int translateX, int translateY);
  89
  90   /**
  91    *
  92    * Clear area using the background pixel or pixmap of the drawable.
  93    * Note that this operation does not adhere to the current clip.
  94    */
  95   public native void clearArea(int x, int y, int w, int h,
  96                                boolean exposures);
  97
  98
  99   public native void putImage(XImage image,
 100                               int srcX, int srcY,
 101                               int destX, int destY,
 102                               int width, int height);
 103
 104   public Drawable getDrawable()
 105   {
 106     return target;
 107   }
 108
 109   private native void updateClip();
 110
 111   private Drawable target;
 112   private RawData structure;
 113   private Clip clip;
 114 }
 115