Subversion Repositories scarts

/* Copyright (C) 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 gnu.gcj.RawData;
 
/** 
 * A visual determines how a color is encoded into a pixel/bitfield
 * value.  It does not determine how the pixel/bitfield value is
 * encoded into the image data.
 * 
 * <p>This class encapsulates all three Xlib representations of a
 * visual.
 * 
 * <ul>
 * 
 * <li>int: visual id.
 * 
 * <li>Visual: opaque data structure used by a lot of Xlib functions.
 * 
 * <li>VisualInfo: transparent data structure that binds the visual to
 * a certain screen and depth.
 * 
 * </ul>
 * 
 * <p>Implementation note: This class does not examine nor manipulate
 * the Visual structure, since the X manual says the structure is
 * opaque, and that XVisualInfo should be used instead.</p>
 *
 * @author Rolf W. Rasmussen <rolfwr@ii.uib.no>
 */
public final class Visual
{
  public static final int VC_STATIC_GRAY  = 0,
	                  VC_GRAY_SCALE   = 1,
                          VC_STATIC_COLOR = 2,
                          VC_PSEUDO_COLOR = 3,
                      	  VC_TRUE_COLOR   = 4,
                          VC_DIRECT_COLOR = 5;
 
  protected static final int MASK_ID            = 1 << 0,
                             MASK_SCREEN        = 1 << 1,
                             MASK_DEPTH         = 1 << 2,
                             MASK_CLASS         = 1 << 3,
                             MASK_RED           = 1 << 4,
                             MASK_GREEN         = 1 << 5,
                             MASK_BLUE          = 1 << 6,
                             MASK_COLORMAP_SIZE = 1 << 7,
                             MASK_BITS_PER_RGB  = 1 << 8;
 
  protected static final int MASK_ALL = MASK_ID
      | MASK_SCREEN
      | MASK_DEPTH
      | MASK_CLASS
      | MASK_RED
      | MASK_GREEN
      | MASK_BLUE
      | MASK_COLORMAP_SIZE
      | MASK_BITS_PER_RGB;
 
  private static final int MASK_VISUAL_STRUCTURE = 1 << 31;
 
  Display display;
  RawData xVisualInfo;
  int infoMask;
  Screen screen;
 
  Visual(RawData structure, Screen screen, int depth )
  {
    this.display = screen.getDisplay();
    this.screen = screen;
    init(structure, depth);
  }
 
  Visual(Display display, RawData structure, int depth )
  {
    this.display = display;
    init(structure, depth);
  }
 
  protected native void init(RawData structure, int depth);
 
  protected native void finalize();
 
  /**
   *
   * Returns the a reference to the visual structure.  This method has
   * package accessibility since the data visual structure is only
   * useful for direct Xlib calls.
   *
   * @return a pointer to the visual structure.
   */
  native RawData getVisualStructure();
 
 
  // These methods only make sense if the visual is decomposed:
 
  public native int getRedMask();
  public native int getGreenMask();
  public native int getBlueMask();
 
  public native int getScreenNumber();
  public native int getDepth();
 
  public Screen getScreen()
  {
    if (screen == null)
      screen = new Screen(display, getScreenNumber());
    return screen;
  }
 
  public native int getVisualClass();
 
  public boolean hasRGBSubfields()
  {
    switch (getVisualClass())
      {
      case VC_TRUE_COLOR:
      case VC_DIRECT_COLOR:
	return true;
      default:
	return false;
      }
  }
 
  protected native void ensureXVisualInfo(int requiredMask);
 
 
  public String toString()
  {
    int missingInfo = ~infoMask;
    boolean hasSubfieldInfo =
      (missingInfo & (MASK_CLASS|MASK_RED|MASK_GREEN|MASK_BLUE)) == 0;
 
    boolean hasDepth = (missingInfo & MASK_DEPTH) == 0;
 
    return getClass().getName() + "[" +
      (hasDepth ? "depth=" + getDepth() : "") +
      (hasRGBSubfields() ?
       (", redMask=" + Integer.toHexString(getRedMask()) +
	", greenMask=" + Integer.toHexString(getGreenMask()) +
	", blueMask=" + Integer.toHexString(getBlueMask())) :
       ", no-subfields") + ", class=" + getVisualClass() +
      "]";
  }
}