Subversion Repositories openrisc

/* 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() +

      "]";

  }

}