libjava/gnu/gcj/xlib/Drawable.java

/* Copyright (C) 1999, 2000  Free Software Foundation

   This file is part of libgcj.

This software is copyrighted work licensed under the terms of the
Libgcj License.  Please consult the file "LIBGCJ_LICENSE" for
details.  */

package gnu.gcj.xlib;

import java.awt.Rectangle;

/** An X11 drawable.
 *
 * @author Rolf W. Rasmussen <rolfwr@ii.uib.no>
 */
public class Drawable extends XID
{
  public Drawable(Display display, int xid)
  {
    super(display, xid);
  }

  /**
   * Gets as much as possible of the image data within the requested
   * region. Data from obscured parts of windows may not be
   * retrievable.
   *  
   * @param dest where to place the image data.
   * 
   * @return the actual region of image data that was retrieved.
   */
  public Rectangle copyIntoXImage(XImage dest, Rectangle bounds,
				  int destX, int destY)
  {
    Rectangle newBounds = null;
    int tries = 5;
    while (!bounds.isEmpty())
      {
	if (copyIntoXImageImpl(dest, bounds.x, bounds.y,
			       bounds.width, bounds.height,
			       destX, destY))
	  return bounds;
	    
	// failed, likely due to wrong bounds...
	
	newBounds = getBounds(newBounds);
	
	bounds = newBounds.intersection(bounds);
	
	tries--;
	
	if (tries < 0)
	throw new RuntimeException("copyIntoXImage is buggy");
	
      }
    
    return bounds; // always empty
  }



  /**
   * Performs an XGetSubImage. This method will fail if the X server
   * does not possess the requested image data. This might occur when
   * requesting the image date of a window that is partially obscured.
   *
   * @param desitantionImage where to place the image data
   *
   * @return false if method was unable to read the requested region.
   */
  private native boolean copyIntoXImageImpl(XImage destinationImage,
					    int x, int y,
					    int width, int height,
					    int destX, int destY);

  public native Rectangle getBounds(Rectangle rv);
  
  private static final String MSG_XGETSUBIMAGE_FAILED =
    "XGetSubImage() failed.";
    
}